【Qt styleSheet样式表】
一、Qt styleSheet样式表语法
1. 属性列表
下表列出了 Qt 样式表支持的所有属性。可以为属性赋予哪些值取决于属性类型。除非另有说明,否则以下属性适用于所有小部件。标有星号*
的属性为Qt特定的,在 CSS2 或 CSS3 中没有等效项。
属性 | 属性类型 | 描述 |
---|---|---|
alternate-background-color | Brush | 用于QAbstractItemView 子类。如果未设置此属性,则默认值是为调色板设置的值 AlternateBase 角色。可参考 background 和selection-background-color 。 |
background | Background | 设置背景,相当于指定background-color 、background-image 、background-repeat 和background-position 。此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QDialog ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit ,QToolTip 和QWidget 。可参考 background-origin ,selection-background-color ,background-attachment ,background-clip 和alternate-background-color 。 |
background-color | Brush | 设置某个小部件的背景颜色 |
background-image | Url | 设置某个小部件的背景图像 |
background-repeat | Repeat | 是否以及如何重复背景图像来填充background-origin 矩形。如果未指定此属性,则背景图像在 x ,y 两个方向上重复。 |
background-position | Alignment | 背景图像在background-origin 矩形内的对齐方式。如果未指定此属性,则对齐方式为top left 。 |
background-attachment | Attachment | 确定背景图像是否在QAbstractScrollArea 相对于视口滚动或固定。默认情况下,背景图像随视口滚动。 |
background-clip | Origin | 小部件的矩形,在其中background 绘制 。此属性指定区域将background-color 和background-image 剪裁。此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QDialog ,QFrame ,QGroupBox ,QLabel ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit ,QToolTip 和QWidget 。如果未指定此属性,则默认为 border 。 |
background-origin | Origin | 小部件的背景矩形,与background-position 和background-image 一起使用。此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QDialog ,QFrame ,QGroupBox ,QLabel ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit ,QToolTip 、和QWidget 。如果未指定此属性,则默认为 padding 。 |
border | Border | 设置小部件边框。相当于指定border-color 、border-style 和border-width 。此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit ,QToolTip 和QWidget 。 |
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 和QWidget 。如果未指定此属性,则默认为 color (即小部件的前景色)。 |
border-top-color | Brush | 边框上边缘的颜色 |
border-right-color | Brush | 边框右边缘的颜色 |
border-bottom-color | Brush | 边框底边缘的颜色 |
border-left-color | Brush | 边框左边缘的颜色 |
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 和The Box Model 。 |
border-radius | Radius | 边框角的半径。相当于指定border-top-left-radius 、border-top-right-radius 、border-bottom-right-radius 和border-bottom-left-radius 。裁剪小部件的background 。此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit 和QToolTip 。如果未指定此属性,则默认为 0。 |
border-top-left-radius | Radius | 边框左上角的半径。 |
border-top-right-radius | Radius | 边框右上角的半径。 |
border-bottom-left-radius | Radius | 边框左下角的半径。将此属性设置为正值会产生圆角。 |
border-bottom-right-radius | Radius | 边框右下角的半径。将此属性设置为正值会产生圆角。 |
border-style | Border Style | 所有边框边缘的样式。 此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit 和QToolTip 。如果未指定此属性,则默认为 none 。 |
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 。此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit 和QToolTip 。也可参考 border-color ,border-radius ,border-style ,border-image 和The Box Model 。 |
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 )。可参考 left ,right ,top 。 |
button-layout | Number | 按钮的布局QDialogButtonBox 或QMessageBox 。可能的值为 0 (WinLayout ), 1 (MacLayout ), 2 (KdeLayout ), 3 (GnomeLayout ) 和 5 (AndroidLayout )。如果未指定此属性,则默认为 SH_DialogButtonLayout 样式提示的当前样式指定的值。 |
color | Brush | 用于渲染文本的颜色。所有遵守该属性的小部件都支持此属性QWidget::palette 。如果未设置此属性,则默认值是小部件调色板中为 QWidget::foregroundRole (通常为黑色)。 |
dialogbuttonbox-buttons-have-icons | Boolean | 按钮是否位于QDialogButtonBox 显示图标。如果该属性设置为1 ,则显示图标;如果设置为0 ,则不显示图标。请参阅图标清单有关如何设置图标的信息部分。注意: 定义此属性的样式必须在QDialogButtonBox被建造; 这意味着您必须将样式应用于父窗口小部件或应用程序本身。 |
font | Font | 用于设置文本字体的速记符号。相当于指定font-family 、font-size 、font-style 和font-weight 。所有遵守该属性的小部件都支持此属性 QWidget::font 。如果未设置该属性,则默认为 QWidget::font 。 |
font-family | String | 字体系列 |
font-size | Font Size | 字体大小。Qt5.15版本,仅支持 pt 和 px 度量 |
font-style | Font Style | 字体样式 |
font-weight | Font Weight | 字体宽度 |
gridline-color * | Color | QTableView 中轴线的颜色。如果未指定此属性,则默认为 SH_Table_GridLineColor 样式提示的当前样式指定的值。 |
height | Length | 子控件(或者在某些情况下,小部件)的高度。 如果未指定此属性,则默认为取决于子控件/小部件和当前样式的值。 警告: 除非另有说明,否则在窗口小部件上设置此属性时不起作用。如果您想要一个具有固定高度的小部件,请将最小高度和最大高度设置为相同的值。 可参考 width 。 |
icon | Url | 对于具有图标的小部件,使用的图标。 目前唯一支持此属性的小部件是 QPushButton 。注意: 应用程序负责为按钮分配图标(使用 QAbstractButton API ),而不是样式的图标。因此,除非您的样式表针对特定的应用程序,否则请小心设置它。 |
icon-size | Length | 小部件中图标的宽度和高度。 此属性支持以下控件: QCheckBox ,QListView ,QPushButton ,QRadioButton ,QTabBar ,QToolBar ,QToolBox ,QTreeView |
image * | Url | 在子控件的内容矩形中绘制的图像。image 属性接受Url 或svg 的列表。使用与QIcon 相同的算法来确定绘制的实际图像(即,图像从不按比例放大,而是在必要时按比例缩小。如果指定了svg ,则图像将缩放为内容矩形的大小。在子控件上设置 image 属性会隐式设置子控件的宽度和高度(除非是SVG 中的图像)。在Qt 4.3及更高版本中,可以使用图像位置来指定图像在矩形内的对齐。 此属性仅用于子控件,不支持其他元素使用它。 警告: 渲染 SVG图像 需要QIcon SVG 插件。 |
image-position | Alignment | 在 Qt 4.3 及更高版本中,可以使用相对或绝对位置来指定图像图像位置的对齐方式。 |
left | Length | 如果position 是相对的,则子控件向右移动一定的偏移量;如果 position 是绝对的,该left 属性指定子控件的左边缘相对于父控件的左边缘(另请参见subcontrol-origin )。如果未指定此属性,则默认为0。 可参考 buttom ,right ,top |
lineedit-password-character * | Number | QLineEdit 作为Unicode数字的密码字符。如果未指定此属性,则默认为当前样式指定的值 SH_LineEdit_PasswordCharacter 风格提示。 |
lineedit-password-mask-delay * | Number | QLineEdit 密码掩码延迟之前的毫秒数lineedit-password-character 应用于可见字符。如果未指定此属性,则默认为当前样式指定的值 SH_LineEdit_PasswordMaskDelay 风格提示。 |
margin | Box Lengths | 小部件的边距。相当于指定margin-top 、margin-right 、margin-bottom 和margin-left 。此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit 和QToolTip 。如果未指定此属性,则默认为0。该属性是在 Qt 5.4 中添加的。 |
margin-top | Length | 小部件的上边距。 |
margin-right | Length | 小部件的右边距。 |
margin-bottom | Length | 小部件的下边距。 |
margin-left | Length | 小部件的左边距。 |
max-height | Length | 小部件或子控件的最大高度。 此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSizeGrip ,QSpinBox ,QSplitter ,QStatusBar ,QTextEdit 和QToolTip 。该值相对于 The Box Model 中的contents rect 。 |
max-width | Length | 小部件或子控件的最大宽度。 此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSizeGrip ,QSpinBox ,QSplitter ,QStatusBar ,QTextEdit 和QToolTip 。该值相对于 The Box Model 中的contents rect 。 |
messagebox-text-interaction-flags * | Number | 消息框中文本的交互行为。可能的值基于Qt::TextInteractionFlags 。如果未指定此属性,则默认为当前样式指定的值 SH_MessageBox_TextInteractionFlags 风格提示。 |
min-height | Length | 小部件或子控件的最小高度。 此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSizeGrip ,QSpinBox ,QSplitter ,QStatusBar ,QTextEdit 和QToolTip 。该值相对于 The Box Model 中的contents rect 。如果未指定此属性,则根据小部件的内容和样式派生最小高度。 |
min-width | Length | 小部件或子控件的最小宽度。 此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSizeGrip ,QSpinBox ,QSplitter ,QStatusBar ,QTextEdit 和QToolTip 。该值相对于 The Box Model 中的contents rect 。如果未指定此属性,则根据小部件的内容和样式派生最小宽度。 |
opacity * | Number | 小部件的不透明度。可能的值从0 (透明)到 255 (不透明)。目前,仅支持QToolTip 。如果未指定此属性,则默认为当前样式指定的值 SH_ToolTipLabel_Opacity 风格提示。 |
outline | 围绕对象边界绘制的轮廓。 | |
outline-color | Color | 轮廓的颜色。可参考border-color |
outline-offset | Length | 轮廓相对于小部件边框的偏移量。 |
outline-style | 指定用于绘制轮廓的图案。可参考border-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 。此属性支持以下控件: QAbstractItemView子类 ,QAbstractSpinBox子类 ,QCheckBox ,QComboBox ,QFrame ,QGroupBox ,QLabel ,QLineEdit ,QMenu ,QMenuBar ,QPushButton ,QRadioButton ,QSplitter ,QTextEdit 和QToolTip 。如果未指定此属性,则默认为0。 |
padding-top | Length | 小部件的顶部填充。 |
padding-right | Length | 小部件的右填充。 |
padding-bottom | Length | 小部件的底部填充。 |
padding-left | Length | 小部件的左填充。 |
paint-alternating-row-colors-for-empty-area | bool | QTreeView 是否为空区域(即没有项目的区域)绘制交替的行颜色 |
position | relative absolute | 是否使用指定偏移量left ,right ,top 和bottom 是相对或绝对坐标。如果未指定此属性,则默认为 relative 。 |
right | Length | 如果position 是绝对的,将子控件向左移动一定的偏移量;指定right:y 等同于指定left:-y 。如果 position 是绝对的,该right 属性指定子控件的右边缘相对于父控件的右边缘(另请参见subcontrol-origin )。可参考 left ,bottom ,top 。 |
selection-background-color * | Brush | 所选文本或项目的背景。 所有遵守该属性的小部件都支持此属 QWidget::palette 并显示选择文本。如果未设置此属性,则默认值是为调色板设置的值 Highlight 角色。 |
selection-color * | Brush | 所选文本或项目的前景。 所有遵守该属性的小部件都支持此属性 QWidget::palette 并显示选择文本。如果未设置此属性,则默认值是为调色板设置的值 HighlightedText 角色。 |
show-decoration-selected * | Boolean | 控制是否选择QListView 覆盖整行或仅覆盖文本范围。如果未指定此属性,则默认为当前样式指定的值 SH_ItemView_ShowDecorationSelected 风格提示。 |
spacing * | Length | 小部件中的内部间距。 此属性支持以下控件: QCheckBox , 可检查的QGroupBoxes ,QMenuBar 和QRadioButton 。如果未指定此属性,则默认值取决于小部件和当前样式。 |
subcontrol-origin * | Origin | 父元素内子控件的原始矩形。 如果未指定此属性,则默认为 padding 。 |
subcontrol-position * | Alignment | 子控件在由子控件原点指定的原点矩形内的对齐。 如果未指定此属性,则默认值取决于子控件。 |
titlebar-show-tooltips-on-buttons | bool | 工具提示是否显示在窗口标题栏按钮上。 |
widget-animation-duration * | Number | 动画应持续多长时间(以毫秒为单位)。值为零意味着动画将被禁用。 如果未指定此属性,则默认为当前样式指定的值 SH_Widget_Animation_Duration 风格提示。该属性是在 Qt 5.10 中添加的。 |
text-align | Alignment | 小部件内容中文本和图标的对齐方式。 如果未指定此值,则默认为取决于本机样式的值。 |
text-decoration | none underline overline line-through | 附加文字效果 |
top | Length | 如果position 是绝对的,将子控件向下移动一定的偏移量;如果 position 是绝对的,该top 属性指定子控件的上边缘相对于父控件的上边缘(另请参见subcontrol-origin )。可参考 left ,bottom ,right 。 |
width | Length | 子控件(或者在某些情况下,小部件)的宽度。 如果未指定此属性,则默认为取决于子控件/小部件和当前样式的值。 警告: 除非另有说明,否则在窗口小部件上设置此属性时不起作用。如果您想要一个具有固定宽度的小部件,请将最小宽度和最大宽度设置为相同的值。 可参考 height 。 |
-qt-background-role | PaletteRole | 用于background-color 基于所选角色的子控件或小部件。 |
-qt-style-features | list | 要应用 Qt 特定样式的 CSS 属性列表。 注意: 只能 list 包含不基于像素图的属性。 |
2. 属性类型
下表总结了不同属性类型的语法和含义。
类型 | 语法 | 描述 |
---|---|---|
Alignment | top | bottom | left | right | center | 水平或垂直对齐方式。 |
Attachment | scroll | fixed | 滚动或固定。 |
Background | Brush | Url | Repeat | Alignment | Brush ,Url ,Repeat ,和 Alignment 的序列。 |
Boolean | 0 |1 | True (1 ) or false (0 )。 |
Border | Border Style | Length | Brush | 简写边界属性。 |
Border Image | none | Url Number{4} (stretch | repeat) {0,2} | 边框图像是由九个部分(左上、中上、右上、左中、中、右中、左下、中下、右下)组成的图像。当需要一定尺寸的边框时,按原样使用角部分,并拉伸或重复顶部、右侧、底部和左侧部分以产生具有所需尺寸的边框。 请参阅CSS3 Draft Specification了解详情。 |
Border Style | dashed | dot-dash | dot-dot-dash | dotted | double | groove | inset | outset | ridge | solid | none | 指定用于绘制边框的图案。请参阅CSS3 Draft Specification了解详情。 |
Box Colors | Brush{1,4} | 出现一到四次Brush ,分别指定框的顶部、右侧、底部和左侧边缘。如果未指定左侧颜色,则认为其与右侧颜色相同。如果未指定底部颜色,则将其视为与顶部颜色相同。如果未指定正确的颜色,则将其视为与顶部颜色相同。 |
Box Lengths | Length{1,4} | 出现一到四次Length ,分别指定框的顶部、右侧、底部和左侧边缘。如果未指定左侧长度,则认为左侧长度与右侧长度相同。如果未指定底部长度,则视为与顶部长度相同。如果没有指定正确的长度,则将其视为与顶部长度相同。。 |
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) 的支持。 |
Font | (Font Style | Font Weight){0,2} Font Size String | 简写字体属性。 |
Font Size | Length | 字体大小。 |
Font Style | normal | italic | oblique | 字体样式。 |
Font Weight | normal | bold | 100 | 200 | ··· | 900 | 字体宽度。 |
Gradient | qlineargradient | qradialgradient | qconicalgradient | 指定渐变填充。有三种类型的渐变填充: 1. 线性渐变在起点和终点之间插值颜色。 2. 径向渐变在围绕它的圆上的焦点和端点之间插值颜色。 3. 锥形渐变围绕中心点对颜色进行插值。 渐变是在“对象边界模式”中指定的。想象渲染渐变的长方体,其左上角位于(0,0),右下角位于(1,1)。然后将渐变参数指定为从0到1的百分比。这些值在运行时外推到实际的长方体坐标。可以指定位于边界框之外的值(例如-0.6或1.8)。 警告: stop 必须按升序排列。 |
Icon | Url(disabled | active | normal | selected ) (on | off ) | 网址列表,QIcon::Mode 和QIcon::State 。 |
Length | Number(px | pt | em | ex ) | 后面跟着一个度量单位的数字。CSS标准建议用户代理必须忽略具有非法值的声明。在Qt中,必须指定测量单位。为了与早期版本的Qt兼容,在大多数情况下,没有测量单位的数字被视为像素。支持的单元包括:px :pixels pt :一个点的大小(即1/72 英寸)em :字体的em宽度(即“M”的宽度)ex :字体的 x 高度(即“x”的高度)然而,Qt仅限于 pt 和px 的字体大小,任何其他大小都必须是px 、em 或ex 。 |
Number | 十进制整数或实数 | 示例:0 、18 、+127 、-255 、12.34 、-.5 、0009 。 |
Origin | margin | border | padding | content | 指示使用四个矩形中的哪一个。margin :边距矩形。边距落在边界之外。border :边框矩形。这是绘制任何边界的地方。padding :填充矩形。与边距不同,内边距位于边框内部。content :内容矩形。这指定实际内容的位置,不包括任何填充、边框或边距。可参考 The Box Model |
PaletteRole | alternate-base | base | bright-text | button | button-text | dark | highlight | highlighted-text | light | link | link-visited | mid | midlight | shadow | text | window | window-text | 值对应于Color roles 在小部件的QPalette 。 |
Radius | Length{1, 2} | 出现一两次Length 。如果仅指定一个长度,则将其用作定义角的四分之一圆的半径。如果指定两个长度,则第一个长度是四分之一椭圆的水平半径,而第二个长度是垂直半径。 |
Repeat | repeat-x | repeat-y | repeat | no-repeat | 指示重复性质的值。repeat-x :水平重复。repeat-y :垂直重复。repeat :水平和垂直重复。no-repeat : 不再重复。 |
Url | url(filename) | filename 是本地磁盘上或使用Qt资源文件 的名称。设置图像会隐式设置元素的宽度和高度。 |
3. 伪状态列表
伪状态 | 描述 |
---|---|
:active | 当小部件驻留在活动窗口中时设置此状态。 |
:adjoins-item | 当::branch 的一个QTreeView 与某个项目相邻。 |
:alternate | 当绘制QAbstract::ItemView 的行时,为每个备用行设置此状态。QAbstractItemView::alternatingRowColors() 设置为true 。 |
:bottom | 该项目位于底部。例如,一个QTabBar 它的选项卡位于底部。 |
:checked | 该项目已检查。例如,checked 的状态QAbstractButton 。 |
:closable | 可以关闭这些项目。例如,QDockWidget 有QDockWidget::DockWidgetClosable 功能已打开。 |
:closed | 该项目处于关闭状态。例如,非展开项QTreeView 。 |
:default | 该项目是默认的。例如,一个默认QPushButton 或默认操作QMenu 。 |
:disabled | 该项目是disabled 。 |
:editable | QComboBox 是可编辑的。 |
:edit-focus | 该项目具有编辑焦点(请参阅QStyle::State_HasEditFocus )。此状态仅适用于Qt Extended 应用程序。 |
:enabled | 该项目是enabled 。 |
:exclusive | 该项目是独占项目组的一部分。例如,独占QActionGroup 中的菜单项。 |
:first | 该项目是第一项(在列表中)。例如,第一个选项卡QTabBar 。 |
:flat | 该物品是扁平的。例如,一个flat QPushButton 。 |
:floatable | 项目可以浮动。例如,QDockWidget 有QDockWidget::DockWidgetFloatable 功能已打开。 |
:focus | 该项目有input focus 。 |
:has-children | 该项目有子项。例如,一个项目QTreeView 有子项目。 |
:has-siblings | 该项目有兄弟项目。例如,一个项目QTreeView 有兄弟姐妹。 |
:horizontal | 该项目具有水平方向。 |
:hover | 鼠标悬停在该项目上。 |
:indeterminate | 该项目具有不确定的状态。例如,一个QCheckBox 或者QRadioButton 是partially checked 。 |
:last | 该项目是最后一项(在列表中)。例如,最后一个选项卡QTabBar 。 |
:left | 该项目位于左侧。例如,一个QTabBar`它的选项卡位于左侧。 |
:maximized | 该项目已最大化。例如,最大化QMdiSubWindow 。 |
:middle | 该项目位于中间(在列表中)。例如,不在开头或结尾的选项卡QTabBar 。 |
:minimized | 该项目已最小化。例如,最小化QMdiSubWindow 。 |
:movable | 该项目可以四处移动。例如,QDockWidget 有QDockWidget::DockWidgetMovable 功能已打开。 |
:no-frame | 该项目没有框架。例如无框QSpinBox 或者QLineEdit 。 |
:non-exclusive | 该项目是非排他项目组的一部分。例如,非独占菜单中的菜单项QActionGroup 。 |
:off | 对于可以切换的项目,这适用于处于“关闭”状态的项目。 |
: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 | 该项目是unchecked 。 |
:vertical | 该项目具有垂直方向。 |
:window | 小部件是一个窗口(即顶级小部件)。 |
4. 子控件列表
子控件 | 描述 |
---|---|
::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 的选项卡栏。此子控件仅用于控制QTabWidget 中QTabBar 的位置。使用::tab 子控件设置选项卡样式。 |
::tear | QTabBar 的tear 指示器。 |
::tearoff | QMenu 的tear 指示器。 |
::text | QAbstractItemView 的文本。 |
::title | QGroupBox 或QDockWidget 的标题。 |
::up-arrow | QHeaderView (排序指示器)、QScrollBar 或QSpinBox 的向上箭头。 |
::up-button | QSpinBox 的向上按钮。 |