Qt样式单参考

支持盒状模型。

QAbstractScrollArea 的所有继承类，包括 QTextEdit 和 QAbstractItemView （所有的条目视图（item view）类），都支持可滚动的背景，使用 background-attachment 来设置是否滚动。将background-attachment 设置成fixed的话，就会使得背景图片（background-image）不随视口（viewport）而滚动。如果将background-attachment 设置成scroll，那么在移动滚动条时，背景图片也会移动。

参考自定义QAbstractScrollArea的示例。

支持盒状模型。选中状态的指示器可使用 ::indicator 子控件（subcontrol）来进行样式设置。默认情况下，指示器是放在部件的内容（Contents）区域的左（Left）上（Top）角。

spacing 属性控制的是选中状态指示器与文字之间的空隙。

参考自定义QCheckBox示例。

可使用 image 属性来对网格（grip）进行样式设置。箭头指示器（arrow indicators）可使用 ::left-arrow 和 ::right-arrow 子控件来进行样式设置。

组合框周围的框架（frame）可使用盒状模型来进行样式设置。下拉按钮可使用 ::drop-down 子控件来进行样式设置。默认情况下，下拉按钮是放置在部件的填充（padding）区域的右上角。下拉按钮中的箭头标志可使用 ::down-arrow 子控件来进行样式设置。默认情况下，箭头是放置在下拉按钮子控件的内容区域的中央。

参考自定义QComboBox示例。

参考 QSpinBox 。

参考 QSpinBox 。

只支持 background 、 background-clip 和 background-origin 属性。

警告：确保妳在自定义的部件中定义咯Q_OBJECT宏。

按钮的布局方式可使用 button-layout 属性来改变。

在停靠状态（docked），支持对标题栏和标题栏的按钮进行样式设置。

停靠部件的边框（border）可使用 border 属性来进行样式设置。 ::title 子控件可用来对标题栏进行样式设置。关闭按钮和漂浮按钮可分别使用 ::close-button 和 ::float-button 来相对于（with respect to） ::title 子控件进行位置设置。如果标题栏是竖直的，那么就会存在（is set） :vertical 伪类。另外，取决于QDockWidget::DockWidgetFeature的值， :closable 、 :floatable 和 :movable 伪状态也可能存在。

注意：使用QMainWindow::separator 来对改变大小的手柄（resize handle）进行样式设置。

警告：在 QDockWidget 不处于停靠状态（undocked）时，样式单无效，∵Qt 在未停靠状态会使用原生（native）的顶级窗口。

参考自定义QDockWidget示例。

参考 QSpinBox 。

支持盒状模型。

从4.3 开始，对一個 QLabel 设置样式单的话，會自动将QFrame::frameStyle 属性设置成QFrame::StyledPanel。

参考自定义QFrame示例。

支持盒状模型。标题可使用 ::title 子控件来进行样式设置。默认情况下，标题是按照QGroupBox::textAlignment 来放置位置的。

如果是一個可选中（checkable）的 QGroupBox 的话，那么标题也包含选中状态指示器。指示器可使用 ::indicator 子控件来进行样式设置。 spacing 属性可用来控制文字与指示器之间的间隔。

参考自定义QGroupBox示例。

支持盒状模型。表头视图（header view）的各个节区（sections）是使用 ::section 子控件来进行样式设置的。section子控件支持 :middle 、 :first 、 :last 、 :only-one 、 :next-selected 、 :previous-selected 、 :selected 和 :checked 伪状态。

排序指示器可使用 ::up-arrow 和 ::down-arrow 子控件来进行样式设置。

参考自定义QHeaderView示例。

支持盒状模型。不支持 :hover 伪状态。

从4.3 开始，对一個 QLabel 设置样式单的话，會自动将QFrame::frameStyle 属性设置成QFrame::StyledPanel。

参考自定义QFrame示例（ QLabel 继承自 QFrame ）。

支持盒状模型。

选中的项目（item）的颜色和背景分别是使用selection- color 和 selection-background-color 来进行样式设置的。

密码字符可使用 lineedit-password-character 属性来进行样式设置。

参考自定义QLineEdit示例。

支持盒状模型。如果交替改变行颜色（alternating row colors）被启用的话，那么交替的颜色（alternating colors）可使用 alternate-background-color 属性来进行样式设置。

选中的项目（item）的颜色和背景分别是使用selection- color 和 selection-background-color 来进行样式设置的。

选择行为是由 show-decoration-selected 属性来进行控制的。

使用 ::item 子控件来对 QListView 中的条目进行更精细的控制。

参考 QAbsractScrollArea 以了解对可滚动的背景的样式设置。

参考自定义QListView示例。

参考 QListView 。

支持对分隔符进行样式设置。

在 QMainWindow 中使用 QDockWidget 时产生的分隔符是使用 ::separator 子控件来进行样式设置的。

参考自定义QMainWindow示例。

支持盒状模型。

单个的条目是使用 ::item 子控件来进行样式设置的。除咯通常的伪状态以外，item子控件还支持 :selected 、 :default 、 :exclusive 和 non-exclusive 伪状态。

可选中的菜单条目的指示器是通过 ::indicator 子控件来进行样式设置的。

分隔符是使用 ::separator 子控件来进行样式设置的。

对于有子菜单的条目，它们的箭头标记是使用 right-arrow 和 left-arrow 来进行样式设置的。

滚动器（scroller）是使用 ::scroller 来进行样式设置的。

分离菜单（tear-off）是使用 ::tearoff 来进行样式设置的。

参考自定义QMenu示例。

支持盒状模型。 spacing 属性指明菜单条目之间的空隙大小。单个的条目是使用 ::item 子控件来进行样式设置的。

警告：在Qt/Mac 平台上，菜单条通常是嵌入系统的全局菜单条中的。在这种情况下，样式单无效。

参考自定义QMenuBar示例。

messagebox-text-interaction-flags 属性可用来改变消息框中的文字的交互模式。

支持盒状模型。进度条的进度块（chunks）可使用 ::chunk 子控件来进行样式设置。进度块显示在部件的内容区域中。

如果进度条显示文字，那么就使用 text-align 属性来设置文字的位置。

不确定的（Indeterminate）进度条会有 :indeterminate 伪状态。

参考自定义QProgressBar示例。

支持盒状模型。支持 :default 、 :flat 、 :checked 伪状态。

对于包含有一個菜单的 QPushButton ，其菜单指示器是使用 ::menu-indicator 子控件来进行样式设置的。可选中的按钮的外观可使用 :open 和 :closed 伪状态来进行样式设置。

警告：如果妳只为 QPushButton 设置一个背景色（background-color）的话，那個背景可能不会显示出来，除非妳将边框（border）属性设置成某個值。勒是∵，在默认情况下， QPushButton 会绘制一個原始的（native）边框，它會完全覆盖（overlaps）背景色。例如，

QPushButton { background-color: red; border: none; }

参考自定义QPushButton示例。

支持盒状模型。选中指示器可使用 ::indicator 子控件来进行样式设置。默认情况下，指示器被放置在部件的内容区域的左上角。

spacing 属性指明选中指示器与文字之间的空隙大小。

参考自定义QRadioButton示例。

支持盒状模型。目前认为滑块在其中滑动的那个槽（groove）就是这个部件的内容区域。 QScrollBar 的广度（extent）（也就是说，宽度或高度，取决于方向）是使用 width 或 height 属性来设置的。要确定方向的话，就使用 :horizontal 和 :vertical 伪状态。

滑块可使用 ::handle 子控件来进行样式设置。设置 min-width 或 min-height 可按照方向来对滑块提供尺寸的限制。

（以下部分的原文写得很糟糕，本座按照理解修改咯某些语意，有不清楚的地方最好自行试验）

::add-line 子控件可用来对那个增加一行的按钮进行样式设置。默认情况下，加一行（add-line）子控件被放置在部件的边框（Border）区域的右下角（原文意思是右上角）。取决于部件的方向，其中的箭头（前面这个主语从句，原文没有）可能是 ::right-arrow 或 ::down-arrow 。默认情况下，箭头会被放置在加一行子控件的内容区域的中心。

::sub-line 子控件可用来对那个减少一行的按钮进行样式设置。默认情况下，减一行（sub-line）子控件被放置在部件的边框区域的左上角（原文是右下角）。取决于部件的方向，其中的箭头（前面这个主语从句，原文没有）可能是 ::left-arrow 或 ::up-arrow 。默认情况下，箭头会被放置在减一行子控件的内容区域的中心。

::sub-page 子控件可用来对那个可起到减一页作用的滑块区域进行样式设置。 ::add-page 子控件可用来对那个可起到加一页作用的滑块区域进行样式设置。

参考自定义QScrollBar示例。

支持 width 、 height 和 image 属性。

参考自定义QSizeGrip示例。

支持盒状模型。对于水平滑动器，必须提供 min-width 和 height 属性。对于竖直滑动器，必须提供 min-height 和 width 属性。

滑动器的滑槽是使用 ::groove 来进行样式设置的。默认情况下，滑槽被放置在部件的内容区域中。滑动器的滑块（thumb）是使用 ::handle 子控件来进行样式设置的。这个子控件就在滑槽的内容区域中移动。

参考自定义QSlider示例。

旋转框（spin box）的框架（frame）可使用盒状模型来进行样式设置。

向上按钮和箭头可使用 ::up-button 和 ::up-arrow 子控件来进行样式设置。默认情况下，向上按钮被放置在部件的填充区域的右上角。如果没有设置显式的尺寸，那么，它會占据它的参考（reference）区域的一半高度。向上箭头被放置在向上按钮的内容区域的中心。

向下按钮和箭头可使用 ::down-button 和 ::down-arrow 子控件来进行样式设置。默认情况下，向下按钮被放置在部件的填充区域的右下角。如果没有设置显式的尺寸，那么，它會占据它的参考（reference）区域的一半高度。向下箭头被放置在向下按钮的内容区域的中心。

参考自定义QSpinBox示例。

支持盒状模型。分割器（splitter）的手柄是使用 ::handle 子控件进行样式设置的。

参考自定义QSplitter示例。

只支持 background 属性。单个条目的框架可使用 ::item 子控件来进行样式设置。

参考自定义QStatusBar示例。

单个标签（tabs）可使用 ::tab 子控件来进行样式设置。关闭按钮可使用 ::close-button 子控件进行样式设置。标签支持 :only-one 、 :first 、 :last 、 :middle 、 :previous--selected 、 :next-selected 、 :selected 伪状态。

取决于标签组的方向，會有 :top 、 :left 、 :right 、 :bottom 伪状态。

处于选中状态的重叠的标签是通过使用负数的边距（margins）或使用absolute（绝对）位置模式来创建的。

QTabBar 的分离（tear）指示器是使用 ::tear 子控件来进行样式设置的。

QTabBar 用两个QToolButtons 来表示它的滚动器，它们可使用QTabBar QToolButton选择器来进行样式设置。使用 ::scroller 子控件来指定滚动按钮的宽度。

QTabBar 中的标签的对齐方式是使用 alignment 属性来进行设置的。

警告：要改变 QTabWidget 中的 QTabBar 的位置，就使用 tab-bar 子控件（并且设置子控件位置（subcontrol-position））。

参考自定义QTabBar示例。

标签部件的框架是使用 ::pane 子控件来进行样式设置的。左边角和右边角分别是使用 ::left-corner 和 ::right-corner 来进行样式设置的。标签条的位置是使用 ::tab-bar 子控件来控制的。

默认情况下， QTabWidget 的子控件的位置是按照 QWindowsStyle 风格来确定的。要想将 QTabBar 放置在中央的位置，就设置tab-bar 子控件的subcontrol-position。

取决于标签组的方向，會有 :top 、 :left 、 :right 、 :bottom 伪状态。

参考自定义QTabWidget示例。

支持盒状模型。如果交替改变行颜色（alternating row colors）被启用的话，那么交替的颜色（alternating colors）可使用 alternate-background-color 属性来进行样式设置。

选中的项目（item）的颜色和背景分别是使用selection- color 和 selection-background-color 来进行样式设置的。

QTableView 中的边角（corner）部件是一個 QAbstractButton ，可使用" QTableView QTableCornerButton::section"选择器来进行样式设置。

警告：如果妳只为QTableCornerButton 设置背景色的话，背景可能不会显示出来，除非妳将边框属性设置成某個值。这是∵，默认情况下，QTableCornerButton會绘制一個原始的边框，它會完全挡住背景色。

网格（grid）的颜色可使用 gridline-color 属性来进行设置。

参考 QAbsractScrollArea 以了解如何设置可滚动的背景。

参考自定义QTableView示例。

参考 QTableView 。

支持盒状模型。

选中的文字的颜色和背景色可分别使用 selection-color 和 selection-background-color 来进行样式设置。

参考 QAbsractScrollArea 以了解如何设置可滚动的背景。

参考 QSpinBox 。

支持盒状模型。

取决于工具条所在的区域（停靠方向），可能會存在 :top 、 :left 、 :right 、 :bottom 伪状态。

:first 、 :last 、 :middle 、 :only-one 伪状态能够指示这個工具条在一個线性（line）组（group）（参考QStyleOptionToolBar::positionWithinLine）中的位置。

QToolBar 的分隔符是使用 ::separator 子控件来进行样式设置的。

手柄（handle）（用来移动工具条）是使用 ::handle 子控件来进行样式设置的。

参考自定义QToolBar示例。

支持盒状模型。

如果这個 QToolButton 拥有一個菜单的话，那么 ::menu-indicator 子控件可用来对菜单指示器进行样式设置。默认情况下，菜单指示器（menu-indicator）被放置在这個部件的填充区域的右下角。

如果这個 QToolButton 是处于QToolButton::MenuButtonPopup模式，那么 ::menu-button 子控件就会用来绘制菜单按钮。 ::menu-arrow 子控件被用来在菜单按钮里面绘制菜单箭头。默认情况下，它会位于菜单按钮子控件的内容区域的中心。

如果这個 QToolButton 显示箭头的话，那么 ::up-arrow 、 ::down-arrow 、::left- arrow和 ::right-arrow 子控件都会用上。

警告：如果妳只为 QToolButton 设置背景色的话，背景可能不会显示出来，除非妳将边框属性设置成某個值。这是∵，默认情况下， QToolButton 會绘制一個原始的边框，它會完全挡住背景色。例如，

QToolButton { background-color: red; border: none; }

参考自定义QToolButton示例。

支持盒状模型。

单个标签可使用 ::tab 子控件来进行样式设置。标签支持 :only-one 、 :first 、 :last 、 :middle 、 :previous-selected 、 :next-selected 、 :selected 伪状态。

支持盒状模型。 opacity 属性控制工具提示（tooltip）的透明度。

参考自定义QFrame示例（ QToolTip 是 QFrame ）。

支持盒状模型。如果交替改变行颜色（alternating row colors）被启用的话，那么交替的颜色（alternating colors）可使用 alternate-background-color 属性来进行样式设置。

选中的项目（item）的颜色和背景分别是使用selection- color 和 selection-background-color 来进行样式设置的。

选择行为是由 show-decoration-selected 属性来进行控制的。

树型视图的分支（branches）可使用 ::branch 子控件来进行样式设置。::branch子控件支持 :open 、 :closed 、 :has-sibling 和 :has-children 伪状态。

使用 ::item 子控件来对 QTreeView 中的条目进行更精细的控制。

参考 QAbsractScrollArea 以了解如何设置可滚动的背景。

参考自定义QTreeView示例以了解如何对分支进行样式设置。

参考 QTreeView 。

只支持 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 );

}

如果没有设置样式单的话，以上的代码不起任何作用（no-operation）。

警告：确保为妳的自定义部件（widget）定义咯Q_OBJECT宏。

{ top
| bottom
| left
| right
| center }*

{ scroll
| fixed }*

{  Brush
|  Url
|  Repeat
|  Alignment  }*

0 | 1

{  Border Style
|  Length
|  Brush  }*

none
|  Url Number {4} 
(stretch |repeat){0,2}

dashed
| dot-dash
| dot-dot-dash
| dotted
| double
| groove
| inset
| outset
| ridge
| solid
| none

Brush {1,4}

Length {1,4}

Color
|  Gradient
|  PaletteRole

rgb( r ,  g ,  b )
| rgba( r ,  g ,  b , a )
| hsv( h ,  s ,  v )
| hsva( h ,  s ,  v , a )
| # rrggbb
| Color Name

( Font Style  |  Font Weight ){0,2}  Font Size  String

Length

normal
| italic
| oblique

normal
| bold
| 100
| 200
... 
| 900

qlineargradient
|qradialgradient
|qconicalgradient

( Url  (disabled |active | normal |selected)? (on |off)? )*

Number  (px | pt |em | ex)?

一個10进制整数或一個实数

margin
| border
| padding
| content

alternate-base
| base
| bright-text
| button
| button-text
| dark
| highlight
| highlighted-text
| light
| link
| link-visited
| mid
| midlight
| shadow
| text
| window
| window-text

Length {1, 2}

repeat-x
| repeat-y
| repeat
| no-repeat

url( filename )

当这個部件位于一個活跃窗口中时，就处于这种状态。

当一個 QTreeView 的 ::branch 与一個条目相邻时，就处于这种状态。

当QAbstractItemView::alternatingRowColors()被设置成true（真）时，在绘制 QAbstractItemView 的行时，每个交替行都具有这個状态。

这個条目位于底部。比如，某個 QTabBar ，它的标签位于底部。

这個条目被选中。比如， QAbstractButton 的checked（选中）状态。

这個条目可被关闭。比如，某個 QDockWidget ，它的QDockWidget::DockWidgetClosable特性被开启。

这個条目处于关闭状态。比如，在一個 QTreeView 中的某個处于折叠（non-expanded）状态的条目

这個条目是默认的。比如，一個默认（default）的按钮（ QPushButton ），或者一個菜单（ QMenu ）中的默认动作。

这個条目被禁用（disabled）。

这個组合框（ QComboBox ）可被编辑。

这個条目拥有编辑焦点（参考QStyle::State_HasEditFocus）。这個状态只在Qt Extended 程序中有效。

这個条目处于启用（enabled）状态。

这個条目是一個互斥的条目组中的一個。比如，在一個互斥的 QActionGroup 中的一個菜单条目。

这個条目是（一個列表中的）第一個。比如，一個 QTabBar 中的第一個标签。

这個条目是平的（flat）。比如，一個平的（flat）按钮（ QPushButton ）。

这個条目可浮动。比如，一個 QDockWidget ，它的QDockWidget::DockWidgetFloatable特性被开启。

这個条目拥有输入焦点（input focus）。

这個条目拥有子代对象。比如，在一個 QTreeView 中，拥有子代条目的条目。

这個条目拥有兄弟姐妹（siblings）。比如，在一個 QTreeView 中，拥有兄弟姐妹的条目。

这個条目是水平的。

鼠标正悬停于这個条目之上。

这個条目具有不确定状态。比如，一個被部分选中（partially checked）的 QCheckBox 或 QRadioButton 。

这個条目是（一個列表中的）最后一個。比如，一個 QTabBar 中的最后一個标签。

这個条目被放置在左边。比如，一個 QTabBar ，它的标签放置在左边。

这個条目被最大化。比如，一個最大化的 QMdiSubWindow 。

这個条目（在一個列表中）位于中间。比如，在一個 QTabBar 中，某個既不在开关也不在末尾的标签。

这個条目被最小化。比如，一個最小化的 QMdiSubWindow 。

这個条目可到处移动。比如，某個 QDockWidget ，它的QDockWidget::DockWidgetMovable特性被开启。

这個条目没有框架（frame）。比如，一個不带框架的 QSpinBox 或 QLineEdit 。

这個条目是某個非互斥的条目组中的一個。比如，在某個非互斥的 QActionGroup 中的一個菜单条目。

对于可被切换的条目来说，这個对应着它的“关闭”（"off"）状态。

对于可被切换的条目来说，这個对应着它的“开启”（"on"）状态。

这個条目是（某個列表中）唯一的一個。比如，某個 QTabBar 中唯一的一個标签。

这個条目处于打开（open）状态。比如，在一個 QTreeView 中的某個已展开（expanded）的条目，或带有一個已打开的菜单的一個 QComboBox 或 QPushButton 。

（列表中的）下一個条目被选中。比如，在一個 QTabBar 中的选中标签是当前这個标签的下一個。

这個条目正被鼠标按下。

（列表中的）上一個条目被选中。比如，在某個 QTabBar 中，位于当前选中的标签的下一個的标签。

这個条目被标记为只读的或不可编辑的。比如，一個只读的 QLineEdit 或一個不可编辑的 QComboBox 。

这個条目被放置在右边。比如，某個 QTabBar ，它将其标签放置在右边。

这個条目被选中。比如，在一個 QTabBar 中被选中的那标签，或在一個 QMenu 中被选中的那個条目。

这個条目被放置在顶部。比如，某個 QTabBar ，它将其标签放置在顶部。

这個条目处于未选中状态（unchecked）。

这個条目是竖直的。

这個部件是一個窗口（也就是说，顶级部件）。

用来为 QScrollBar 增加一行的按钮。

在一個 QScrollBar 中滑块（handle）（slider）与 add-line （加一行）之间的区域。

QTreeView 的分支指示器。

QProgressBar 的进度块。

一個 QDockWidget 的或者一個 QTabBar 中的标签的关闭按钮。

在一個 QAbstractScrollArea 中的两個滚动条之间的边角。

QComboBox 、 QHeaderView （排序指示器）、 QScrollBar 或 QSpinBox 的向下箭头。

QScrollBar 或 QSpinBox 的向下按钮。

QComboBox 的下拉按钮。

QDockWidget 的浮动（float）按钮。

QSlider 的滑动槽。

QAbstractItemView 、 QCheckBox 、 QRadioButton 、可选中的 QMenu 条目或可选中的 QGroupBox 的指示器。

QScrollBar 、 QSplitter 或 QSlider 的滑块（handle）（slider）。

QAbstractItemView 或 QMenu 的图标。

QAbstractItemView 、 QMenuBar 、 QMenu 或 QStatusBar 中的一個条目。

QScrollBar 的左箭头。

QTabWidget 的左侧边角。比如，这個控件可用来控制某個 QTabWidget 中的左侧边角部件的位置。

一個带有菜单的 QToolButton 的箭头。

QToolButton 的菜单按钮。

QPushButton 的菜单指示器。

QMenu 或 QScrollBar 的右侧箭头。

QTabWidget 的方框（pane）（frame）。

QTabWidget 的右侧边角。比如，这個控件可用来控制某個 QTabWidget 中的右侧边角部件的位置。

QMenu 或 QTabBar 的滚动器。

QHeaderView 的一個区段（section）。

QMenu （菜单）的分隔符，或一個 QMainWindow （主窗口）中的分隔符。

QScrollBar 中用来减一行的按钮。

在一個 QScrollBar 中位于滑块（handle）（slider）与 sub-line （减一行按钮）之间的区域。

QTabBar 或 QToolBox 中的标签。

QTabWidget 的标签条。这個子控件仅用来控制 QTabBar 在 QTabWidget 内部的位置。要设置其样式，则使用 ::tab 子控件。

QTabBar 的离合（tear）指示器。

QMenu 的离合（tear-off）指示器。

QAbstractItemView 的文字。

QGroupBox 或 QDockWidget 的标题。

QHeaderView （排序指示器）、 QScrollBar 或 QSpinBox 的向上箭头。

QSpinBox 的向上按钮。