样式表(05)：【纲】Qt Style Sheets Reference [官翻]
石俊雄
Qt Style Sheets Reference
Qt样式表支持各种属性、伪状态和子控件，使得定制小部件的外观成为可能。
定制样式的小部件列表
下表列出了可以使用样式表定制的Qt小部件:
| Widget | How to Style |
|---|---|
| QAbstractScrollArea | 支持盒子模型。 QAbstractScrollArea的所有派生版本，包括QTextEdit和QAbstractItemView(所有项目视图类) ，都支持使用背景附件进行可滚动的背景。 将background-attachment背景附件设置为fixed 固定可提供不随视口滚动的背景图像。 将背景附件设置为scroll 滚动，在滚动条移动时滚动背景图像。 有关示例，请参见自定义QAbstractScrollArea。 |
| QCheckBox | 支持盒子模型。 可以使用::indicator子控件设置检查指示器的样式。 默认情况下，指示器放置在窗口小部件的“Contents 内容”矩形的左上角。 spacing 间隔属性指定检查指示符和文本之间的间隔。 有关示例，请参见自定义QCheckBox。 |
| QColumnView | 可以使用image属性设置握柄的样式。 可以使用::left-arrow子控件和::right-arrow子控件设置箭头指示器的样式。 |
| QComboBox | 组合框周围的框架可以使用框模型设置样式。 可以使用::drop-down子控件设置下拉按钮的样式。 默认情况下，下拉按钮位于小部件的填充矩形的右上角。 可以使用::down-arrow子控件设置下拉按钮内的箭头标记的样式。 默认情况下，箭头位于下拉子控件的内容矩形的中心。 有关示例，请参见自定义QComboBox。 |
| QDateEdit | See QSpinBox. |
| QDateTimeEdit | See QSpinBox. |
| QDialog | 仅支持background，background-clip和background-origin属性。 警告:确保为自定义窗口小部件定义了Q_OBJECT宏。 |
| QDialogButtonBox | 可以使用button-layout属性更改按钮的布局。 |
| QDockWidget | 支持停靠时标题栏和标题栏按钮的样式。 可以使用border属性设置停靠窗口小部件边框的样式。 ::title子控件可用于自定义标题栏。 关闭和浮动按钮分别相对于::title子控件使用::close-button和::float-button定位。 标题栏为垂直时，将设置:vertical伪类。 另外，根据QDockWidget::DockWidgetFeature，设置:closesable，:floatable和:movable伪状态。 注意:使用QMainWindow::separator设置调整大小手柄的样式。 警告:取消QDockWidget时，样式表无效，因为Qt退出时，Qt使用本机顶级窗口。 有关示例，请参见自定义QDockWidget。 |
| QDoubleSpinBox | See QSpinBox. |
| QFrame | 支持盒子模型。 从4.3开始，在QLabel上设置样式表会自动将QFrame::frameStyle属性设置为QFrame::StyledPanel。 有关示例，请参见自定义QFrame。 |
| QGroupBox | 支持盒子模型。 标题可以使用::title子控件设置样式。 默认情况下，标题的位置取决于QGroupBox::textAlignment。 对于可检查的QGroupBox，标题包括检查指示符。 指示器使用::indicator子控件设置样式。 spacing 间距属性可用于控制文本和指示符之间的间距。 有关示例，请参见自定义QGroupBox。 |
| QHeaderView | 支持盒子模型。 标题视图的各节使用::section子控件设置样式。 子控件部分支持:middle，:first，:last，:only-one，:next-selected，:previous-selected，:selected和:checked伪状态。 可以使用::up-arrow和::down-arrow子控件设置排序指示器的样式。 有关示例，请参见自定义QHeaderView。 |
| QLabel | 支持盒子模型。 不支持:hover伪状态。 从4.3开始，在QLabel上设置样式表会自动将QFrame::frameStyle属性设置为QFrame::StyledPanel。 有关示例(请参见自定义QFrame) (QLabel源自QFrame) 。 |
| QLineEdit | 支持盒子模型。 所选项目的颜色和背景分别使用selection-color 和 selection-background-color设置样式。 可以使用lineedit-password-character属性设置密码字符的样式。 可以使用lineedit-password-mask-delay更改密码掩码延迟 有关示例，请参见自定义QLineEdit。 |
| QListView | 支持盒子模型。 启用交替行颜色后，可以使用alternate-background-color属性设置交替颜色的样式。 所选项目的颜色和背景分别使用selection-color 和 selection-background-color设置样式。 选择行为由show-decoration-selected属性控制。 使用::item子控件可以对QListView中的项目进行更精细的控制。 请参阅QAbsractScrollArea以设置可滚动背景的样式。 有关示例，请参见自定义QListView。 |
| QListWidget | See QListView. |
| QMainWindow | 支持分隔符的样式 使用QDockWidget时，QMainWindow中的分隔符使用::separator子控件设置样式。 有关示例，请参见自定义QMainWindow。 |
| QMenu | 支持盒子模型。 单个项目使用::item子控件设置样式。 除了通常支持的伪状态外，item子控件还支持:selected，:default，:exclusive和non-exclusive 伪状态。 可检查菜单项的指示器使用::indicator子控件设置样式。 分隔符使用::separator子控件设置样式。 对于带有子菜单的项目，箭头标记的样式使用right-arrow 和 left-arrow。 滚动器使用::scroller设置样式。 撕下使用::tearoff设置样式。 有关示例，请参见自定义QMenu。 |
| QMenuBar | 支持盒子模型。 spacing 间隔属性指定菜单项之间的间隔。 单个项目使用::item子控件设置样式。 警告:在Qt / Mac上运行时，菜单栏通常嵌入到系统范围的菜单栏中。 在这种情况下，样式表将无效。 有关示例，请参见自定义QMenuBar。 |
| QMessageBox | messagebox-text-interaction-flags属性可用于更改与消息框中的文本的交互。 |
| QProgressBar | 支持盒子模型。 可以使用::chunk子控件设置进度条的样式。 该块将显示在窗口小部件的“内容”矩形上。 如果进度条显示文本，请使用text-align属性定位文本。 不确定进度条具有:indeterminate伪状态集。 有关示例，请参见自定义QProgressBar。 |
| QPushButton | 支持盒子模型。 支持:default，:flat，:checked伪状态。 从5.15开始，可以将icon属性设置为覆盖按钮图标。 对于带有菜单的QPushButton，菜单指示器使用::menu-indicator子控件设置样式。 可以使用:open和:closed伪状态来自定义可检查按钮的外观。 警告:如果仅在QPushButton上设置背景色，则除非将border属性设置为某个值，否则背景可能不会出现。这是因为，默认情况下，QPushButton绘制一个原生边框，该边框与背景颜色完全重叠。 例如， QPushButton { background-color: red; border: none; } 有关示例，请参见自定义QPushButton。 |
| QRadioButton | 支持盒子模型。 可以使用::indicator子控件设置检查指示器的样式。 默认情况下，指示器放置在窗口小部件的“内容”矩形的左上角。 spacing 间隔属性指定检查指示符和文本之间的间隔。 有关示例，请参见自定义QRadioButton。 |
| QScrollBar | 支持盒子模型。 小部件的“内容”矩形被视为滑块在其上移动的凹槽。 QScrollBar的范围(即宽度或高度取决于方向) 分别使用width或height属性设置。要确定方向，请使用:horizontal和:vertical伪状态。可以使用::handle子控件设置滑块的样式。设置min-width 或者 min-height会根据方向为滑块提供尺寸限制。 ::add-line子控件可用于设置按钮样式以添加行。默认情况下，添加行子控件位于小部件的“边框”矩形的右上角。取决于方向:::right-arrow或::down-arrow。默认情况下，箭头位于添加线子控件的“内容”矩形的中心。 ::sub-line子控件可用于设置按钮样式以减去一行。默认情况下，子行子控件位于窗口小部件的“边框”矩形的右下角。取决于方向:::left-arrow或::up-arrow。默认情况下，箭头放置在子行子控件的“内容”矩形的中心。 ::sub-page子控件可用于设置减去页面的滑块区域的样式。::add-page子控件可用于设置添加页面的滑块区域的样式。 有关示例，请参见自定义QScrollBar。 |
| QSizeGrip | 支持width, height, 和 image属性。 有关示例，请参见自定义QSizeGrip。 |
| QSlider | 支持盒子模型。 对于水平幻灯片，必须提供min-width和height属性。 对于垂直滑块，必须提供min-height和width属性。 滑块的凹槽使用::groove设置样式。 默认情况下，凹槽位于窗口小部件的“内容”矩形中。 滑块的拇指使用::handle子控件设置样式。 子控件在凹槽子控件的“内容”矩形中移动。 有关示例，请参见自定义QSlider。 |
| QSpinBox | 旋转框的框架可以使用盒子模型设置样式。 可以使用::up-button和::up-arrow子控件设置向上按钮和箭头的样式。 默认情况下，向上按钮位于小部件的“填充”矩形的右上角。 如果没有明确的尺寸，则它占据其参考矩形高度的一半。 向上箭头放置在向上按钮的“内容”矩形的中心。 可以使用::down-button和::down-arrow子控件设置向下按钮和箭头的样式。 默认情况下，向下按钮位于小部件的“填充”矩形的右下角。 如果没有明确的尺寸，则它占据其参考矩形高度的一半。 底部箭头位于底部按钮的“内容”矩形的中心。 有关示例，请参见自定义QSpinBox。 |
| QSplitter | 支持盒子模型。 拆分器的句柄使用::handle子控件设置样式。 有关示例，请参见自定义QSplitter。 |
| QStatusBar | 仅支持background 背景属性。 单个项目的框架可以使用::item子控件设置样式。 有关示例，请参见自定义QStatusBar。 |
| QTabBar | 单个的选项卡可以使用::tab子控件设置样式。 使用::close-button关闭按钮选项卡支持:only-one，:first，:last，:middle，:previous–selected，:next-selected和:selected伪状态。 :top，:left，:right，:bottom伪状态取决于选项卡的方向。 所选状态的重叠选项卡是使用负边距或absolute绝对位置方案创建的。 QTabBar的撕裂指示器使用::tear子控件设置样式。 QTabBar为其滚动条使用了两个QToolButtons，可以使用QTabBar QToolButton选择器设置样式。 要指定滚动按钮的宽度，请使用::scroller子控件。 QTabBar中选项卡的对齐方式是使用alignment属性设置样式的。 警告: 要更改 QTabBar 在QTabWidget中的位置，请使用 tab-bar 标签栏子控件(并设置subcontrol-position) 。 有关示例，请参见自定义QTabBar。 |
| QTabWidget | 选项卡小部件的框架使用::pane子控件设置样式。 左和右角分别使用::left-corner和::right-corner设置样式。 使用::tab-bar子控件可以控制选项卡栏的位置。 默认情况下，子控件在QWindowsStyle中具有QTabWidget的位置。 要将QTabBar放在中心，请设置选项卡栏子控件的子控件位置。 :top，:left，:right，:bottom伪状态取决于选项卡的方向。 有关示例，请参见自定义QTabWidget。 |
| QTableView | 支持盒子模型。 启用交替行颜色后，可以使用alternate-background-color属性设置交替颜色的样式。 所选项目的颜色和背景分别使用 selection-color 和 selection-background-color设置样式。 QTableView中的角落小部件作为QAbstractButton实现，可以使用“ QTableView QTableCornerButton::section”选择器设置样式。 警告:如果仅在QTableCornerButton上设置background-color背景色，则除非将border属性设置为某个值，否则背景可能不会出现。 这是因为，默认情况下，QTableCornerButton绘制一个原生边框，该边框与背景颜色完全重叠。 可以使用gridline-color属性指定网格的颜色。 请参阅QAbsractScrollArea以设置可滚动背景的样式。 有关示例，请参见自定义QTableView。 |
| QTableWidget | See QTableView. |
| QTextEdit | 支持盒子模型。 所选文本的颜色和背景分别使用selection-color 和 selection-background-color设置样式。 请参阅QAbsractScrollArea以设置可滚动背景的样式。 |
| QTimeEdit | See QSpinBox. |
| QToolBar | 支持盒子模型。 :top，:left，:right，:bottom伪状态取决于工具栏所在的区域。 :first，:last，:middle，:only-one 伪状态指示工具栏在line group中的位置(请参见QStyleOptionToolBar::positionWithinLine) 。 QToolBar的分隔符使用::separator子控件设置样式。 使用::handle子控件设置手柄(用于移动工具栏) 的样式。 有关示例，请参见自定义QToolBar。 |
| QToolButton | 支持盒子模型。 如果QToolButton有菜单，则::menu-indicator 子控件可用于设置指示器样式。默认情况下，菜单指示器位于窗口小部件的填充矩形的右下角。 如果QToolButton处于QToolButton::MenuButtonPopup模式，则::menu-button子控件用于绘制菜单按钮。 ::menu-arrow子控件用于在菜单按钮内部绘制菜单箭头。默认情况下，它位于菜单按钮子控件的“内容”矩形的中心。 当QToolButton显示箭头时，使用::up-arrow，::down-arrow，::left-arrow和::right-arrow子控件。 警告:如果仅在QToolButton上设置背景颜色，则除非将border属性设置为某个值，否则背景不会显示。这是因为，默认情况下，QToolButton绘制一个原生边框，该边框与背景颜色完全重叠。例如， QToolButton { background-color: red; border: none; }有关示例，请参见自定义QToolButton。 |
| QToolBox | 支持盒子模型。 可以使用::tab子控件设置各个选项卡的样式。 选项卡支持:only-one，:first，:last，:middle，:previous-selected，:next-selected，:selected伪状态。 |
| QToolTip | 支持盒子模型。opacity属性控制工具提示的不透明度。 有关示例，请参见自定义QFrame(QToolTip是QFrame) 。 |
| QTreeView | 支持盒子模型。 启用交替行颜色后，可以使用alternate-background-color属性设置交替颜色的样式。 所选项目的颜色和背景分别使用 selection-color 和 selection-background-color 设置样式。 选择行为由 show-decoration-selected 属性控制。 可以使用::branch子控件设置树形视图的分支的样式。::branch子控件支持:open，:closed，:has-sibling 和 :has-children 伪状态。 使用::item子控件可以对QTreeView中的项目进行更精细的控制。 请参阅QAbsractScrollArea以设置可滚动背景的样式。 有关对分支进行样式设置的示例，请参见自定义QTreeView。 |
| QTreeWidget | See QTreeView. |
| QWidget | 仅支持background，background-clip和background-origin属性。 如果是QWidget的子类，则需要为您的自定义QWidget提供paintEvent，如下所示: void CustomWidget::paintEvent(QPaintEvent *) { QStyleOption opt; opt.init(this); QPainter p(this); style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this); } 如果未设置样式表，则以上代码为空操作。 警告:确保为自定义窗口小部件定义了Q_OBJECT宏。 |
属性列表
下表列出了Qt样式表支持的所有属性。哪些值可以赋予属性取决于属性的类型。除非另有规定，以下属性适用于所有小部件。标有星号*的属性特定于Qt，在CSS2或CSS3中没有等效属性。
| Property | Type | Description |
|---|---|---|
| alternate-background-color | Brush | QAbstractItemView子类中使用的交替的背景色。 如果未设置此属性，则默认值为为调色板的AlternateBase角色设置的值。 例子： QTreeView { alternate-background-color: blue; background: yellow; } 参见 background 和 selection-background-color. |
| background | Background | 设置背景的简写形式。 等效于指定background-color, background-image, background-repeat, and/or background-position。 QAbstractItemView子类，QAbstractSpinBox子类，QCheckBox，QComboBox，QDialog，QFrame，QGroupBox，QLabel，QLineEdit，QMenu，QMenuBar，QPushButton，QRadioButton，QSplitter，QTextEdit，QToolTip和纯QWidgets支持此属性。 例子： QTextEdit { background: yellow }通常，需要设置类似于Qt :: BrushStyle中的样式的填充模式。 您可以对Qt :: SolidPattern，Qt :: RadialGradientPattern，Qt :: LinearGradientPattern和Qt :: ConicalGradientPattern使用background-color属性。 通过创建包含图案的背景图像，可以轻松实现其他图案。 例子： QLabel { background-image: url(dense6pattern.png); background-repeat: repeat-xy; } 参见 background-origin, selection-background-color, background-clip, background-attachment 和 alternate-background-color. |
| background-color | Brush | 小部件使用的背景色。QLabel { background-color: yellow }QLineEdit { background-color: rgb(255, 0, 0) } |
| background-image | Url | 小部件使用的背景图像。 图像的半透明部分使background-color 背景色发亮。 例子： QFrame { background-image: url(:/images/hydro.png) } |
| background-repeat | Repeat | 是否重复背景图像以及如何重复背景图像以填充背景原始矩形。 如果未指定此属性，则在两个方向(重复) 上重复背景图像。 例子： QFrame { background: white url(:/images/ring.png); background-repeat: repeat-y; background-position: left; } |
| background-position | Alignment | 背景图像在 background-origin 背景原点矩形内的对齐方式。 如果未指定此属性，则对齐方式位于top left 左上方。 例子： QFrame { background: url(:/images/footer.png); background-position: bottom left; } |
| background-attachment | Attachment | 确定QAbstractScrollArea中的背景图像是相对于视口滚动还是固定的。 默认情况下，背景图像与视口一起滚动。 例子： QTextEdit { background-image: url(“leaves.png”); background-attachment: fixed; } 另请参阅背景 |
| background-clip | Origin | 小部件的矩形，在其中绘制背景。 此属性指定将背景色和背景图像剪切到的矩形。 QAbstractItemView子类，QAbstractSpinBox子类，QCheckBox，QComboBox，QDialog，QFrame，QGroupBox，QLabel，QPushButton，QRadioButton，QSplitter，QTextEdit，QToolTip和纯QWidgets支持此属性。 如果未指定此属性，则默认为border。 例子： QFrame { background-image: url(:/images/header.png); background-position: top left; background-origin: content; background-clip: padding; } 另请参见background，background-origin和Box模型。 |
| background-origin | Origin | 小部件的背景矩形，与background-position和background-image结合使用。 QAbstractItemView子类，QAbstractSpinBox子类，QCheckBox，QComboBox，QDialog，QFrame，QGroupBox，QLabel，QPushButton，QRadioButton，QSplitter，QTextEdit，QToolTip和纯QWidgets支持此属性。 如果未指定此属性，则默认值为padding。 例子： QFrame { background-image: url(:/images/header.png); background-position: top left; background-origin: content; } 另请参阅背景和盒子模型。 |
| border | Border | 用于设置小部件边框的简写符号。 等效于指定border-color边框颜色，border-style 边框样式 and/or border-width边框宽度。 QAbstractItemView子类，QAbstractSpinBox子类，QCheckBox，QComboBox，QFrame，QGroupBox，QLabel，QLineEdit，QMenu，QMenuBar，QPushButton，QRadioButton，QSplitter，QTextEdit，QToolTip和纯QWidgets支持此属性。 例子： QLineEdit { border: 1px solid white } |
| border-top | Border | 设置小部件顶部边框的简写形式。 等效于指定border-top-color，border-top-style和/或border-top-width。 |
| border-right | Border | 设置窗口小部件右边框的简写形式。 等效于指定border-right-color，border-right-style和/或border-right-width。 |
| border-bottom | Border | 设置小部件底部边框的简写形式。 等效于指定border-bottom-color，border-bottom-style和/或border-bottom-width。 |
| border-left | Border | 设置小部件左边框的简写形式。 等效于指定border-left-color，border-left-style和/或border-left-width。 |
| border-color | Box Colors | 所有边框边缘的颜色。 等效于指定border-top-color，border-right-color，border-bottom-color和border-left-color。 QAbstractItemView子类，QAbstractSpinBox子类，QCheckBox，QComboBox，QFrame，QGroupBox，QLabel，QLineEdit，QMenu，QMenuBar，QPushButton，QRadioButton，QSplitter，QTextEdit，QToolTip和纯QWidgets支持此属性。 如果未指定此属性，则默认为颜色(即小部件的前景色) 。 QLineEdit { border-width: 1px; border-style: solid; border-color: white; } 另请参见border-style，border-width，border-image和Box模型。 |
| border-top-color | Border | 边框顶部边缘的颜色。 |
| border-right-color | Border | 边框右边边缘的颜色。 |
| border-bottom-color | Border | 边框底部边缘的颜色。 |
| border-left-color | Border | 边框左边边缘的颜色。 |
| border-image | Border Image | 用于填充边框的图像。 图像被切成九部分，并在必要时适当拉伸。 有关详细信息，请参见边框图像。 QAbstractItemView子类，QAbstractSpinBox子类，QCheckBox，QComboBox，QFrame，QGroupBox，QLabel，QLineEdit，QMenu，QMenuBar，QPushButton，QRadioButton，QSplitter，QTextEdit和QToolTip支持此属性。 另请参见border-color，border-style，border-width和Box模型。 |
| border-radius | Radius | 边界角的半径。 等效于指定border-top-left-radius，border-top-right-radius，border-bottom-right-radius和border-bottom-left-radius。 边界半径将剪切元素的背景。 QAbstractItemView子类，QAbstractSpinBox子类，QCheckBox，QComboBox，QFrame，QGroupBox，QLabel，QLineEdit，QMenu，QMenuBar，QPushButton，QRadioButton，QSplitter，QTextEdit和QToolTip支持此属性。 如果未指定此属性，则默认为0。 例子： QLineEdit { border-width: 1px; border-style: solid; border-radius: 4px; } 另请参见 border-width 边框宽度和盒子模型。 |
| border-top-left-radius | Radius | 边框左上角的半径。 |
| border-top-right-radius | Radius | 边框右上角的半径。 |
| border-bottom-right-radius | Radius | 边框右下角的半径。 将此属性设置为正值将导致圆角。 |
| border-bottom-left-radius | Radius | 边框左下角的半径。 将此属性设置为正值将导致圆角。 |
| border-style | Border Style | 所有边框边缘的样式。 QAbstractItemView子类，QAbstractSpinBox子类，QCheckBox，QComboBox，QFrame，QGroupBox，QLabel，QLineEdit，QMenu，QMenuBar，QPushButton，QRadioButton，QSplitter，QTextEdit和QToolTip支持此属性。 如果未指定此属性，则默认为none。 例子： QLineEdit { border-width: 1px; border-style: solid; border-color: blue; } 另请参见border-color，border-style，border-image和Box模型。 |
| border-top-style | Border Style | 边框上边缘的样式。 |
| border-right-style | Border Style | 边框右边缘的样式。 |
| border-bottom-style | Border Style | 边框下边缘的样式。 |
| border-left-style | Border Style | 边框左边缘的样式。 |
| border-width | Box Lengths | 边框的宽度。 等效于设置border-top-width，border-right-width，border-bottom-width和border-left-width。 QLineEdit { border-width: 2px; border-style: solid; border-color: darkblue; } 另请参见border-color，border-radius，border-style，border-image和Box模型。 |
| border-top-width | Length | 边框顶部边缘的宽度。 |
| border-right-width | Length | 边框右边缘的宽度。 |
| border-bottom-width | Length | 边框底边的宽度。 |
| border-left-width | Length | 边框左边缘的宽度。 |
| bottom | Length | 如果position是相对的(默认) ，则将子控件上移一定的偏移量；否则，将子控件上移。 然后，指定bottom：y等效于指定top：-y。 如果position为绝对位置，则bottom属性指定相对于父控件的下边缘的子控件的下边缘(另请参见subcontrol-origin) 。 QSpinBox::down-button { bottom: 2px } 参见 left, right, and top. |
| button-layout | Number | QDialogButtonBox或QMessageBox中按钮的布局。 可能的值为0(WinLayout) ，1(MacLayout) ，2(KdeLayout) ，3(GnomeLayout) 和5(AndroidLayout) 。 如果未指定此属性，则默认为SH_DialogButtonLayout样式提示的当前样式指定的值。 例子： * { button-layout: 2 } |
| color | Brush | 用于呈现文本的颜色。 尊重QWidget :: palette的所有小部件都支持此属性。 如果未设置此属性，则默认值为在QWidget :: foregroundRole的小部件面板中为其设置的值(通常为黑色) 。 例子： QPushButton { color: red }另请参阅 background 和 selection-color 。 |
| dialogbuttonbox-buttons-have-icons | Boolean | QDialogButtonBox中的按钮是否显示图标 如果将此属性设置为1，则QDialogButtonBox的按钮将显示图标；否则，它将显示图标。 如果设置为0，则不显示图标。 有关如何设置图标的信息，请参见图标列表部分。 QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }注意：定义此属性的样式必须在创建QDialogButtonBox之前应用； 这意味着您必须将样式应用于父窗口小部件或应用程序本身。 |
| font | Font | 设置文本字体的简写符号。 等效于指定字体系列，字体大小，字体样式和/或字体粗细。 尊重QWidget :: font的所有小部件都支持此属性。 如果未设置此属性，则默认值为QWidget :: font。 QCheckBox { font: bold italic large “Times New Roman” } |
| font-family | String | 字体家族。 QCheckBox { font-family: “New Century Schoolbook” } |
| font-size | Font Size | 字体大小。 在此版本的Qt中，仅支持pt和px指标。 QTextEdit { font-size: 12px } |
| font-style | Font Style | 字体样式。 QTextEdit { font-style: italic } |
| font-weight | Font Weight | 字体的粗细。 |
| gridline-color* | Color | QTableView中的网格线的颜色。 如果未指定此属性，则默认为由当前样式为SH_Table_GridLineColor样式提示指定的值。 * { gridline-color: gray } |
| height | Length | 子控件(或在某些情况下为小部件) 的高度。 如果未指定此属性，则默认为取决于子控件/小部件以及当前样式的值。 警告：除非另行指定，否则在窗口小部件上设置此属性无效。 如果要使窗口小部件具有固定的高度，请将min-height和max-height设置为相同的值。 QSpinBox::down-button { height: 10px } 参见 width. |
| icon | Url+ | 使用的图标，用于具有图标的窗口小部件。 当前支持此属性的唯一窗口小部件是QPushButton。 注意：将图标分配给按钮(使用QAbstractButton API) 是应用程序的责任，而不是样式的职责。 因此，除非样式表针对特定的应用程序，否则请谨慎设置。 自5.15起可用。 |
| icon-size | Length | 小部件中图标的宽度和高度。 可以使用此属性设置以下窗口小部件的图标大小。 QCheckBox QListView QPushButton QRadioButton QTabBar QToolBar QToolBox QTreeView |
| image* | Url+ | 在子控件的内容矩形中绘制的图像。 image属性接受Urls或svg的列表。 使用与QIcon相同的算法确定绘制的实际图像(即，图像从不放大，但在必要时始终按比例缩小) 。 如果指定了svg，则图像将缩放为内容矩形的大小。 在子控件上设置image属性会隐式设置子控件的宽度和高度(除非SVG中的图像) 。 在Qt 4.3及更高版本中，可以使用image-position指定图像在矩形内的对齐方式。 此属性仅用于子控件-我们不支持其他元素。 警告：需要QIcon SVG插件才能渲染SVG图像。 // 隐式地将向下按钮的大小设置为spindown.png的大小 QSpinBox::down-button { image: url(:/images/spindown.png) } |
| image-position | alignment | 在Qt 4.3及更高版本中，可以使用相对位置或绝对位置来指定图像位置的对齐方式。 |
| left | Length | 如果position是相对的(默认) ，则将子控件向右移动一定的偏移量。 如果position为绝对位置，则left属性指定相对于父控件的左边缘的子控件的左边缘(另请参见subcontrol-origin) 。 如果未指定此属性，则默认为0。 QSpinBox::down-button { left: 2px } 参见 right, top, and bottom. |
| lineedit-password-character* | Number | QLineEdit密码字符作为Unicode数字。 如果未指定此属性，则默认为由当前样式为SH_LineEdit_PasswordCharacter样式提示指定的值。 * { lineedit-password-character: 9679 } |
| lineedit-password-mask-delay* | Number | 在将lineedit-password-character应用于可见字符之前，QLineEdit密码掩码延迟(以毫秒为单位) 。 如果未指定此属性，则默认为SH_LineEdit_PasswordMaskDelay样式提示的当前样式指定的值。 此属性是在Qt 5.4中添加的。 * { lineedit-password-mask-delay: 1000 } |
| margin | Box Lengths | 小部件的边距。 等效于指定上边距，右边距右边，底部边距和左边距。 如果未指定此属性，则默认为0。 QLineEdit { margin: 2px } 参见 padding, spacing, and The Box Model. |
| margin-top | Length | 小部件的上边距。 |
| margin-right | Length | 小部件的右边距。 |
| margin-bottom | Length | 小部件的下边距。 |
| margin-left | Length | 小部件的左边距。 |
| max-height | Length | 小部件或子控件的最大高度。 该值相对于盒子模型中的contents rect。 QSpinBox { max-height: 24px } |
| max-width | Length | 小部件或子控件的最大宽度。 该值相对于盒子模型中的contents rect。 QComboBox { max-width: 72px } |
| min-height | Length | QComboBox { min-height: 24px } |
| min-width | Length | QComboBox { min-width: 72px } |
| messagebox-text-interaction-flags* | Number | 消息框中文本的交互行为。 可能的值基于Qt :: TextInteractionFlags。 如果未指定此属性，则默认为SH_MessageBox_TextInteractionFlags样式提示的当前样式指定的值。 QMessageBox { messagebox-text-interaction-flags: 5 } |
| opacity* | Number | 小部件的不透明度。 可能的值为0(透明) 到255(不透明) 。 目前，仅工具提示支持此功能。 如果未指定此属性，则默认为SH_ToolTipLabel_Opacity样式提示的当前样式指定的值。 QToolTip { opacity: 223 } |
| outline | 围绕对象边界绘制的轮廓。 | |
| outline-color | Color | 轮廓线的颜色。 另请参阅border-color |
| outline-offset | Length | 轮廓与小部件边框的偏移量。 |
| outline-style | 指定用于绘制轮廓的图案。 另请参阅边框样式 | |
| outline-radius | 在轮廓上添加圆角 | |
| outline-bottom-left-radius | Radius | 轮廓的左下角圆角的半径。 |
| outline-bottom-right-radius | Radius | 轮廓的右下角圆角的半径。 |
| outline-top-left-radius | Radius | 轮廓左上角的半径。 |
| outline-top-right-radius | Radius | 轮廓的右上角圆角的半径。 |
| padding | Box Lengths | 小部件的填充。 等效于指定padding-top，padding-right，padding-bottom和padding-left。 QLineEdit { padding: 3px } |
| padding-top | Length | |
| padding-right | Length | |
| padding-bottom | Length | |
| padding-left | Length | |
| paint-alternating-row-colors-for-empty-area | bool | QTreeView是否为空白区域(即没有项目的区域) 绘制交替的行颜色 |
| position | relative |absolute | 使用左，右，上和下指定的偏移是相对坐标还是绝对坐标。 如果未指定此属性，则默认为相对。 |
| right | Length | 如果position是相对的(默认) ，则将子控件向左移动一定的偏移量； 指定右：x等效于指定 left：-x。 如果position为绝对位置，则right属性指定相对于父控件的右边缘的子控件的右边缘(另请参见subcontrol-origin) 。 QSpinBox::down-button { right: 2px } |
| selection-background-color* | Brush | 所选文字或项目的背景。 尊重QWidget :: palette并显示选择文本的所有小部件均支持此属性。 如果未设置此属性，则默认值是为调色板的“突出显示”角色设置的值。 QTextEdit { selection-background-color: darkblue } |
| selection-color* | Brush | 所选文本或项目的前景。 尊重QWidget :: palette并显示选择文本的所有小部件均支持此属性。 如果未设置此属性，则默认值是为调色板的HighlightedText角色设置的任何值。 |
| show-decoration-selected* | Boolean | 控制QListView中的选择是覆盖整个行还是仅覆盖文本范围。 如果未指定此属性，则默认为SH_ItemView_ShowDecorationSelected样式提示的当前样式指定的值。 * { show-decoration-selected: 1 } |
| spacing* | Length | 小部件中的内部间距。 QCheckBox，可检查的QGroupBoxes，QMenuBar和QRadioButton支持此属性。 如果未指定此属性，则默认值取决于窗口小部件和当前样式。 |
| subcontrol-origin* | Origin | 父控件内子控件的原点矩形。 如果未指定此属性，则默认值为padding。 QSpinBox::up-button { image: url(:/images/spinup.png); subcontrol-origin: content; subcontrol-position: right top; } |
| subcontrol-position* | Alignment | 子控件在由subcontrol-origin指定的原点矩形内的对齐方式。 如果未指定此属性，则默认为依赖于子控件的值。 QSpinBox::down-button { image: url(:/images/spindown.png); subcontrol-origin: padding; subcontrol-position: right bottom; } |
| titlebar-show-tooltips-on-buttons | bool | 窗口标题栏按钮上是否显示工具提示。 |
| widget-animation-duration* | Number | 动画应持续的时间(以毫秒为单位) 。 等于零的值表示将禁用动画。 如果未指定此属性，则默认为SH_Widget_Animation_Duration样式提示的当前样式指定的值。 此属性是在Qt 5.10中添加的。 * { widget-animation-duration: 100 } |
| text-align | Alignment | 小部件内容中文本和图标的对齐方式。 如果未指定此值，则默认为取决于本机样式的值。 QPushButton { text-align: left; } 当前仅QPushButton和QProgressBar支持此属性。 |
| text-decoration | none underline overline line-through | 附加文字效果 |
| top | Length | 如果position是相对的(默认) ，则将子控件向下移动一定的偏移量。 如果position为绝对位置，则top属性指定相对于父控件的上边缘的子控件的上边缘(另请参见subcontrol-origin) 。 如果未指定此属性，则默认为0。 QSpinBox::up-button { top: 2px } |
| width | Length | 子控件(在某些情况下为小部件) 的宽度。 如果未指定此属性，则默认为取决于子控件/小部件以及当前样式的值。 警告：除非另行指定，否则在窗口小部件上设置此属性无效。 如果要使用固定宽度的小部件，请将最小宽度和最大宽度设置为相同的值。 QSpinBox::up-button { width: 12px } |
| -qt-background-role | PaletteRole | 子控件或窗口小部件的背景颜色(基于所选角色) 。 |
| -qt-style-features | list | 您要对其应用Qt特定样式的CSS属性的列表。 注意：列表只能包含不基于像素图的属性。 |
图标列表
可以使用以下属性来自定义Qt中使用的图标。 本节中列出的每个属性的类型均为“图标”。
请注意，要使图标显示在QDialogButtonBox的按钮中，您需要将dialogbuttonbox-buttons-have-icons属性设置为true。 另外，要自定义图标的大小，请使用icon-size属性。
| Name | QStyle::StandardPixmap |
|---|---|
| backward-icon | QStyle::SP_ArrowBack |
| cd-icon | QStyle::SP_DriveCDIcon |
| computer-icon | QStyle::SP_ComputerIcon |
| desktop-icon | QStyle::SP_DesktopIcon |
| dialog-apply-icon | QStyle::SP_DialogApplyButton |
| dialog-cancel-icon | QStyle::SP_DialogCancelButton |
| dialog-close-icon | QStyle::SP_DialogCloseButton |
| dialog-discard-icon | QStyle::SP_DialogDiscardButton |
| dialog-help-icon | QStyle::SP_DialogHelpButton |
| dialog-no-icon | QStyle::SP_DialogNoButton |
| dialog-ok-icon | QStyle::SP_DialogOkButton |
| dialog-open-icon | QStyle::SP_DialogOpenButton |
| dialog-reset-icon | QStyle::SP_DialogResetButton |
| dialog-save-icon | QStyle::SP_DialogSaveButton |
| dialog-yes-icon | QStyle::SP_DialogYesButton |
| directory-closed-icon | QStyle::SP_DirClosedIcon |
| directory-icon | QStyle::SP_DirIcon |
| directory-link-icon | QStyle::SP_DirLinkIcon |
| directory-open-icon | QStyle::SP_DirOpenIcon |
| dockwidget-close-icon | QStyle::SP_DockWidgetCloseButton |
| downarrow-icon | QStyle::SP_ArrowDown |
| dvd-icon | QStyle::SP_DriveDVDIcon |
| file-icon | QStyle::SP_FileIcon |
| file-link-icon | QStyle::SP_FileLinkIcon |
| filedialog-contentsview-icon | QStyle::SP_FileDialogContentsView |
| filedialog-detailedview-icon | QStyle::SP_FileDialogDetailedView |
| filedialog-end-icon | QStyle::SP_FileDialogEnd |
| filedialog-infoview-icon | QStyle::SP_FileDialogInfoView |
| filedialog-listview-icon | QStyle::SP_FileDialogListView |
| filedialog-new-directory-icon | QStyle::SP_FileDialogNewFolder |
| filedialog-parent-directory-icon | QStyle::SP_FileDialogToParent |
| filedialog-start-icon | QStyle::SP_FileDialogStart |
| floppy-icon | QStyle::SP_DriveFDIcon |
| forward-icon | QStyle::SP_ArrowForward |
| harddisk-icon | QStyle::SP_DriveHDIcon |
| home-icon | QStyle::SP_DirHomeIcon |
| leftarrow-icon | QStyle::SP_ArrowLeft |
| messagebox-critical-icon | QStyle::SP_MessageBoxCritical |
| messagebox-information-icon | QStyle::SP_MessageBoxInformation |
| messagebox-question-icon | QStyle::SP_MessageBoxQuestion |
| messagebox-warning-icon | QStyle::SP_MessageBoxWarning |
| network-icon | QStyle::SP_DriveNetIcon |
| rightarrow-icon | QStyle::SP_ArrowRight |
| titlebar-contexthelp-icon | QStyle::SP_TitleBarContextHelpButton |
| titlebar-maximize-icon | QStyle::SP_TitleBarMaxButton |
| titlebar-menu-icon | QStyle::SP_TitleBarMenuButton |
| titlebar-minimize-icon | QStyle::SP_TitleBarMinButton |
| titlebar-normal-icon | QStyle::SP_TitleBarNormalButton |
| titlebar-shade-icon | QStyle::SP_TitleBarShadeButton |
| titlebar-unshade-icon | QStyle::SP_TitleBarUnshadeButton |
| trash-icon | QStyle::SP_TrashIcon |
| uparrow-icon | QStyle::SP_ArrowUp |
属性类型列表
下表总结了不同属性类型的语法和含义。
| Type | Syntax | Description |
|---|---|---|
| Alignment | { top | bottom | left | right | center }* | 水平和/或垂直对齐。 QTextEdit { background-position: bottom center } |
| Attachment | { scroll | fixed }* | 滚动或固定附件。 |
| Background | { Brush | Url | Repeat | Alignment }* | 一系列的笔刷，URL，重复和对齐。 |
| Boolean | 0 | 1 | True (1) or false (0). QDialog { etch-disabled-text: 1 } |
| Border | { Border Style | Length | Brush }* | 速记边框属性。 设置的属性分别为(按顺序) ：border-width, border-style,和border-color. |
| Border Image | none | Url Number{4} (stretch | epeat){0,2} | 边界图像是由九个部分组成的图像(左上，上中，右上，左中，居中，右中，左下，下中和右下) 。 当需要一定大小的边框时，将按原样使用角部分，并拉伸或重复顶部，右侧，底部和左侧部分以生成具有所需大小的边框。 有关详细信息，请参见CSS3规范草案。 |
| Border Style | dashed | dot-dash | dot-dot-dash | dotted | double | groove | inset | outset | ridge | solid | none | 指定用于绘制边框的图案。 有关详细信息，请参见CSS3规范草案。 |
| Box Colors | Brush{1,4} | 一到四个出现的Brush，分别指定一个框的顶部，右侧，底部和左侧。 如果未指定左侧颜色，则将其与右侧颜色相同。 如果未指定底色，则将其与顶色相同。 如果未指定正确的颜色，则该颜色应与顶部的颜色相同。 QLabel { border-color: red } /* red red red red */ QLabel { border-color: red blue } /* red blue red blue */ QLabel { border-color: red blue green } /* red blue green blue */ QLabel { border-color: red blue green yellow } /* red blue green yellow */ |
| Box Lengths | Length{1,4} | 一到四次出现的长度，分别指定一个框的顶部，右侧，底部和左侧。 如果未指定左侧长度，则将其与右侧长度相同。 如果未指定底部长度，则该长度应与顶部长度相同。 如果未指定正确的长度，则该长度应与顶部长度相同。 QLabel { border-width: 1px } /* 1px 1px 1px 1px */ QLabel { border-width: 1px 2px } /* 1px 2px 1px 2px */ QLabel { border-width: 1px 2px 3px } /* 1px 2px 3px 2px */ QLabel { border-width: 1px 2px 3px 4px } /* 1px 2px 3px 4px */ |
| Brush | Color | Gradient | PaletteRole | 指定调色板中的颜色或渐变或条目。 |
| Color | rgb(r, g, b) | rgba(r, g, b, a) | hsv(h, s, v) | hsva(h, s, v, a) | hsl(h, s, l) | hsla(h, s, l, a)| #rrggbb | Color Name | 将颜色指定为RGB(红色，绿色，蓝色) ，RGBA(红色，绿色，蓝色，alpha) ，HSV(色相，饱和度，值) ，HSVA(色相，饱和度，值，alpha) ，HSL(色相，饱和度， 亮度) ，HSLA(色相，饱和度，亮度，alpha) 或命名的颜色。 rgb() 或rgba() 语法可以与0到255之间的整数值或百分比一起使用。 hsv() ，hsva() ，hsl() 或hsla() 中s，v，l和a的值都必须在0-255范围内或带有百分比，h的值必须在0-359范围内 。 从5.13开始提供对HSL(A) 的支持。 QLabel { border-color: red } /* opaque red */ QLabel { border-color: #FF0000 } /* opaque red */ QLabel { border-color: rgba(255, 0, 0, 75%) } /* 75% opaque red */ QLabel { border-color: rgb(255, 0, 0) } /* opaque red */ QLabel { border-color: rgb(100%, 0%, 0%) } /* opaque red */ QLabel { border-color: hsv(60, 100%, 100%) } /* opaque yellow */ QLabel { border-color: hsva(240, 255, 255, 75%) } /* 75% blue */ QLabel { border-color: hsl(60, 100%, 50%) } /* opaque yellow */ QLabel { border-color: hsla(240, 255, 50%, 75%) } /* 75% blue */ 注意：允许的RGB颜色与CSS 2.1允许的颜色相同，参见官档。 |
| Font | (Font Style | Font Weight){0,2} Font Size String | 速记字体属性。 可设置的属性是（按顺序）： "font-style font-weight font-size “font-family” |
| Font Size | Length | The size of a font. |
| Font Style | normal | italic | oblique | The style of a font. |
| Font Weight | normal | bold | 100 | 200 … | 900 | The weight of a font. |
| Gradient | qlineargradient | qradialgradient | qconicalgradient | 指定渐变填充。 共有三种类型的渐变填充： - 线性渐变会在起点和终点之间插入颜色。 - 径向渐变会在焦点和围绕它的圆上的端点之间插入颜色。 - 圆锥形渐变会在中心点周围插入颜色。 在“对象边界模式”中指定渐变。 想象一下渲染渐变的盒子，其左上角为(0，0) ，右下角为(1，1) 。 然后将渐变参数指定为从0到1的百分比。这些值在运行时外推到实际的框坐标。 可以指定位于边界框之外的值(例如，-0.6或1.8) 。 警告：停靠点必须按升序显示。 /* linear gradient from white to green */ QTextEdit { background: qlineargradient(x1:0, y1:0, x2:1, y2:1, stop:0 white, stop: 0.4 gray, stop:1 green) } /* linear gradient from white to green */ QTextEdit { background: qlineargradient(x1:0, y1:0, x2:1, y2:1, stop:0 white, stop: 0.4 rgba(10, 20, 30, 40), stop:1 rgb(0, 200, 230, 200)) } /* conical gradient from white to green */ QTextEdit { background: qconicalgradient(cx:0.5, cy:0.5, angle:30, stop:0 white, stop:1 #00FF00) } /* radial gradient from white to green */ QTextEdit { background: qradialgradient(cx:0, cy:0, radius: 1, fx:0.5, fy:0.5, stop:0 white, stop:1 green) } |
| Icon | (Url (disabled | active | normal | selected)? (on | off)? )* | url、QIcon::Mode和QIcon::State的列表。 * { file-icon: url(file.png), url(file_selected.png) selected; } QMessageBox { dialogbuttonbox-buttons-have-icons: true; dialog-ok-icon: url(ok.svg); dialog-cancel-icon: url(cancel.png), url(grayed_cancel.png) disabled; } |
| Length | Number (px | pt | em | ex)? | 后跟一个测量单位的数字。CSS标准建议用户代理必须忽略带有非法值的声明。在Qt中，必须指定测量单位。为了与早期版本的Qt兼容，在大多数情况下，没有测量单位的数字被视为像素。支持单位包括: - px:像素 - pt:一个点的大小(即1/72英寸) - em:字体的em宽度(即“M”的宽度) - ex:字体的ex宽度(即’x’的高度) 然而，Qt被限制为pt和px的字体大小，任何其他大小必须是px, em或ex。 |
| Number | 十进制整数或实数 | Examples: 0, 18, +127, -255, 12.34, -.5, 0009. |
| Origin | margin | border | padding | content | 指示要使用四个矩形中的哪个。 - margin：边距矩形。 边距落在边界之外。 - border：边框矩形。 这是绘制任何边框的地方。 - padding：填充矩形。 与边距不同，填充位于边框内。 - content：内容矩形。 这指定实际内容的位置，不包括任何填充，边框或边距。 |
| PaletteRole | alternate-base | base | bright-text | button | button-text | dark | highlight | highlighted-text | light | link | link-visited | mid | midlight | shadow | text | window | window-text | 这些值对应于小部件的QPalette中的“颜色”角色。 QPushButton { color: palette(dark); } |
| Radius | Length{1, 2} | 一或两次出现“长度”。 如果仅指定一个长度，则将其用作定义角的四分之一圆的半径。 如果指定了两个长度，则第一长度是四分之一椭圆的水平半径，而第二长度是垂直半径。 |
| Repeat | repeat-x | repeat-y | repeat | no-repeat | 指示重复性质的值。 - repeat-x: Repeat horizontally. -repeat-y: Repeat vertically. -repeat: Repeat horizontally and vertically. -no-repeat: Don’t repeat. |
| Url | url(filename) | filename是本地磁盘上或使用Qt资源系统存储的文件名。 设置图像会隐式设置元素的宽度和高度。 |
伪状态列表
支持以下伪状态：
| Pseudo-State | Description |
|---|---|
| :active | 当窗口小部件位于活动窗口中时，将设置此状态。 |
| :adjoins-item | 当QTreeView的::: branch与某个项目相邻时，将设置此状态。 |
| :alternate | 当QAbstractItemView :: alternatingRowColors() 设置为true时，将为绘制QAbstractItemView的行的每个备用行设置此状态。 |
| :bottom | 该项目位于底部。 例如，QTabBar的选项卡位于底部。 |
| :checked | 该项目被检查。 例如，QAbstractButton的检查状态。 |
| :closable | 这些项目可以关闭。 例如，QDockWidget启用了QDockWidget :: DockWidgetClosable功能。 |
| :closed | 该项目处于关闭状态。 例如，QTreeView中的非展开项 |
| :default | 该项目是默认设置。 例如，默认的QPushButton或QMenu中的默认操作。 |
| :disabled | 该项目被禁用。 |
| :editable | QComboBox是可编辑的。 |
| :edit-focus | 该项目具有编辑焦点(请参见QStyle :: State_HasEditFocus) 。此状态仅适用于Qt Extended应用程序。 |
| :enabled | 该项目已启用。 |
| :exclusive | 该物料属于专有物料组。例如，专用QActionGroup中的菜单项。 |
| :first | 该项目是第一个(在列表中) 。例如，QTabBar中的第一个选项卡。 |
| :flat | 该项目是扁平的。例如，一个扁平的QPushButton。 |
| :floatable | 这些项目可以浮动。例如，QDockWidget启用了QDockWidget :: DockWidgetFloatable功能。 |
| :focus | 该项目具有输入焦点。 |
| :has-children | 该项目有孩子。例如，QTreeView中具有子项的项。 |
| :has-siblings | 该项目有兄弟姐妹。例如，QTreeView中具有同级项的项。 |
| :horizontal | 该项目具有水平方向 |
| :hover | 鼠标悬停在该项目上。 |
| :indeterminate | 该项目的状态不确定。例如，部分检查了QCheckBox或QRadioButton。 |
| :last | 该项目是最后一个(在列表中) 。例如，QTabBar中的最后一个选项卡。 |
| :left | 该项目位于左侧。例如，一个QTabBar的选项卡位于左侧。 |
| :maximized | 该项目已最大化。例如，最大化的QMdiSubWindow。 |
| :middle | 该项目在中间(在列表中) 。例如，标签不在QTabBar的开头或结尾。 |
| :minimized | 该项目被最小化。例如，最小化的QMdiSubWindow。 |
| :movable | 该项目可以移动。例如，QDockWidget启用了QDockWidget :: DockWidgetMovable功能。 |
| :no-frame | 该项目没有框架。例如，无框架的QSpinBox或QLineEdit。 |
| :non-exclusive | 该物料属于非专用物料组。例如，非专有QActionGroup中的菜单项。 |
| :off | 对于可以切换的项目，这适用于处于“关闭”状态的项目。 |
| :on | 对于可以切换的项目，这适用于处于“ on”状态的窗口小部件。 |
| :only-one | 该项目是唯一的(在列表中) 。例如，QTabBar中的一个单独的选项卡。 |
| :open | 该项目处于打开状态。例如，QTreeView中的展开项目，带有打开菜单的QComboBox或QPushButton。 |
| :next-selected | 选择下一个项目(列表中) 。例如，QTabBar的选定选项卡在此项目旁边。 |
| :pressed | 使用鼠标按下该项目。 |
| :previous-selected | 选择上一个项目(列表中) 。例如，QTabBar中的一个选项卡位于所选选项卡的旁边。 |
| :read-only | 该项目被标记为只读或不可编辑。例如，只读的QLineEdit或不可编辑的QComboBox。 |
| :right | 该项目位于右侧。例如，QTabBar的选项卡位于右侧。 |
| :selected | 该项被选择。例如，QTabBar中的选定选项卡或QMenu中的选定项目。 |
| :top | 该项目位于顶部。例如，QTabBar的选项卡位于顶部。 |
| :unchecked | 该项目未选中。 |
| :vertical | 该项目具有垂直方向。 |
| :window | 该小部件是一个窗口(即顶层小部件) |
子控件列表
可以使用以下子控件：
| Sub-Control | Description |
|---|---|
| ::add-line | 添加一行QScrollBar的按钮。 |
| ::add-page | 手柄(滑块) 和QScrollBar的添加线之间的区域。 |
| ::branch | QTreeView的分支指示器。 |
| ::chunk | QProgressBar的进度块。 |
| ::close-button | QDockWidget的关闭按钮或QTabBar的选项卡 |
| ::corner | QAbstractScrollArea中两个滚动条之间的角 |
| ::down-arrow | QComboBox，QHeaderView(排序指示器) ，QScrollBar或QSpinBox的向下箭头。 |
| ::down-button | QScrollBar或QSpinBox的向下按钮。 |
| ::drop-down | QComboBox的下拉按钮。 |
| ::float-button | QDockWidget的浮动按钮 |
| ::groove | QSlider的凹槽。 |
| ::indicator | QAbstractItemView，QCheckBox，QRadioButton，可检查的QMenu项或可检查的QGroupBox的指示器。 |
| ::handle | QScrollBar，QSplitter或QSlider的句柄(滑块) 。 |
| ::icon | QAbstractItemView或QMenu的图标。 |
| ::item | QAbstractItemView，QMenuBar，QMenu或QStatusBar的一项。 |
| ::left-arrow | QScrollBar的左箭头。 |
| ::left-corner | QTabWidget的左上角。例如，此控件可用于控制QTabWidget中左角控件的位置。 |
| ::menu-arrow | QToolButton带有菜单的箭头。 |
| ::menu-button | QToolButton的菜单按钮。 |
| ::menu-indicator | QPushButton的菜单指示器。 |
| ::right-arrow | QMenu或QScrollBar的向右箭头。 |
| ::pane | QTabWidget的窗格(框架) 。 |
| ::right-corner | QTabWidget的右上角。例如，此控件可用于控制QTabWidget中右上角小部件的位置。 |
| ::scroller | QMenu或QTabBar的滚动器。 |
| ::section | QHeaderView的部分。 |
| ::separator | QMenu或QMainWindow中的分隔符。 |
| ::sub-line | 减去QScrollBar的一行的按钮。 |
| ::sub-page | 手柄(滑块) 和QScrollBar的子线之间的区域。 |
| ::tab | QTabBar或QToolBox的选项卡。 |
| ::tab-bar | QTabWidget的标签栏。该子控件仅用于控制QTabBar在QTabWidget中的位置。使用:: tab子控件设置选项卡的样式。 |
| ::tear | QTabBar的撕裂指示器。 |
| ::tearoff | QMenu的拆卸指示器。 |
| ::text | QAbstractItemView的文本。 |
| ::title | QGroupBox或QDockWidget的标题。 |
| ::up-arrow | QHeaderView(排序指示器) ，QScrollBar或QSpinBox的向上箭头。 |
| ::up-button | QSpinBox的向上按钮。 |
有关如何自定义子控件的示例，请参见自定义QPushButton的菜单指示器子控件。
类似资料：