【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 | relativeabsolute | 是否使用指定偏移量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 | noneunderlineoverlineline-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:pixelspt:一个点的大小(即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的向上按钮。 |