Supports the box model.

All derivatives of QAbstractScrollArea, including QTextEdit,

and QAbstractItemView (all item view classes), support scrollable backgrounds

using background-attachment. Setting the background-attachment to fixed provides

a background-image that does not scroll with the viewport. Setting the background-attachment to scroll, scrolls the background-image when the scroll bars move.

See Customizing QAbstractScrollArea for an example.

支持盒子模型。 QAbstractScrollArea 的所有派生类，包括 QTextEdit 和 QAbstractItemView（所有项目视图类），都支持使用background-attachment的可滚动背景。 将 background-attachment 设置为 fixed 会提供不随视口滚动的background-image。 设置background-attachment滚动【scroll】，当滚动条移动时滚动背景图像。 有关示例，请参阅自定义 QAbstractScrollArea。

The spacing property specifies the spacing between the check indicator and the text.

See Customizing QCheckBox for an example.

支持盒子模型。 可以使用 ::indicator 子控件设置检查指示器的样式。 默认情况下，指示器放置在小部件内容矩形的左上角。 间距属性指定检查指示符和文本之间的间距。 有关示例，请参阅自定义 QCheckBox。

The grip can be styled be using the image property. The arrow indicators can by styled using the ::left-arrow subcontrol and the ::right-arrow subcontrol.

可以使用图像属性来设置手柄的样式。 箭头指示符可以使用 ::left-arrow 子控件和 ::right-arrow 子控件来设置样式。

See Customizing QComboBox for an example.

组合框周围的框架可以使用框模型进行样式设置。 下拉按钮可以使用 ::drop-down 子控件设置样式。 默认情况下，下拉按钮位于小部件填充矩形的右上角。 下拉按钮内的箭头标记可以使用 ::down-arrow 子控件设置样式。 默认情况下，箭头位于下拉子控件的内容矩形的中心。 有关示例，请参阅自定义 QComboBox。

Warning: Make sure you define the Q_OBJECT macro for your custom widget.

仅支持背景、背景剪辑和背景原点属性。 警告：确保为自定义小部件定义 Q_OBJECT 宏。

The layout of buttons can be altered using the button-layout property.

可以使用 button-layout 属性更改按钮的布局。

The dock widget border can be styled using the border property. The ::title subcontrol can be used to customize the title bar. The close and float buttons are positioned with respect to the ::title subcontrol using the ::close-button and ::float-button respectively.

When the title bar is vertical, the :vertical pseudo class is set. In addition, depending on QDockWidget::DockWidgetFeature, the :closable, :floatable and :movable pseudo states are set.

Note: Use QMainWindow::separator to style the resize handle.

Warning: The style sheet has no effect when the QDockWidget is undocked as Qt uses native top level windows when undocked.

See Customizing QDockWidget for an example.

停靠时支持标题栏和标题栏按钮的样式。 可以使用 border 属性设置停靠窗口小部件边框的样式。 ::title 子控件可用于自定义标题栏。 关闭和浮动按钮分别使用 ::close-button 和 ::float-button 相对于 ::title 子控件定位。 当标题栏是垂直的时，设置了 :vertical 伪类。 此外，根据 QDockWidget::DockWidgetFeature，设置 :closeable、:floatable 和 :movable 伪状态。 注意：使用 QMainWindow::separator 设置调整大小手柄的样式。 警告：当 QDockWidget 取消停靠时，样式表不起作用，因为 Qt 在取消停靠时使用本机*窗口。 有关示例，请参阅自定义 QDockWidget。

Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel.

See Customizing QFrame for an example.

支持盒子模型。 从 4.3 开始，在 QLabel 上设置样式表会自动将 QFrame::frameStyle 属性设置为 QFrame::StyledPanel。 有关示例，请参阅自定义 QFrame。

In the case of a checkable QGroupBox, the title includes the check indicator. The indicator is styled using the ::indicator subcontrol. The spacing property can be used to control the spacing between the text and indicator.

See Customizing QGroupBox for an example.

支持盒子模型。 可以使用 ::title 子控件设置标题的样式。 默认情况下，标题根据 QGroupBox::textAlignment 放置。 对于可检查的 QGroupBox，标题包含检查指示符。 指示器的样式使用 ::indicator 子控件。 间距属性可用于控制文本和指示器之间的间距。 有关示例，请参阅自定义 QGroupBox。

The sort indicator can be styled using the ::up-arrow and the ::down-arrow Sub-control.

See Customizing QHeaderView for an example.

支持盒子模型。 标题视图的部分使用 ::section 子控件设置样式。 子控件部分支持:middle、:first、:last、:only-one、:next-selected、:previous-selected、:selected 和 :checked 伪状态。 可以使用 ::up-arrow 和 ::down-arrow 子控件来设置排序指示器的样式。 有关示例，请参阅自定义 QHeaderView。

Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel.

See Customizing QFrame for an example (a QLabel derives from QFrame).

支持盒子模型。 不支持 :hover 伪状态。 从 4.3 开始，在 QLabel 上设置样式表会自动将 QFrame::frameStyle 属性设置为 QFrame::StyledPanel。 有关示例，请参阅自定义 QFrame（QLabel 派生自 QFrame）。

The color and background of the selected item is styled using selection-color and selection-background-color respectively.

The password character can be styled using the lineedit-password-character property.

The password mask delay can be changed using the lineedit-password-mask-delay

See Customizing QLineEdit for an example.

支持盒子模型。 所选项目的颜色和背景分别使用 selection-color 和 selection-background-color 设置样式。 可以使用 lineedit-password-character 属性设置密码字符的样式。 可以使用 lineedit-password-mask-delay 更改密码掩码延迟 有关示例，请参阅自定义 QLineEdit。

The color and background of the selected item is styled using selection-color and selection-background-color respectively.

The selection behavior is controlled by the show-decoration-selected property.

Use the ::item subcontrol for more fine grained control over the items in the QListView.

See QAbsractScrollArea to style scrollable backgrounds.

See Customzing QListView for an example.

支持盒子模型。 启用交替行颜色后，可以使用交替背景颜色属性设置交替颜色的样式。 所选项目的颜色和背景分别使用 selection-color 和 selection-background-color 设置样式。 选择行为由 show-decoration-selected 属性控制。 使用 ::item 子控件对 QListView 中的项目进行更细粒度的控制。 请参阅 QAbsractScrollArea 以设置可滚动背景的样式。 有关示例，请参阅自定义 QListView。

The separator in a QMainWindow when using QDockWidget is styled using the ::separator subcontrol.

See Customizing QMainWindow for an example.

支持分隔符的样式 使用 QDockWidget 时 QMainWindow 中的分隔符使用 ::separator 子控件进行样式设置。 有关示例，请参阅自定义 QMainWindow。

Individual items are styled using the ::item subcontrol. In addition to the usually supported pseudo states, item subcontrol supports the :selected, :default, :exclusive and the non-exclusive pseudo states.

The indicator of checkable menu items is styled using the ::indicator subcontrol.

The separator is styled using the ::separator subcontrol.

For items with a sub menu, the arrow marks are styled using the right-arrow and left-arrow.

The scroller is styled using the ::scroller.

The tear-off is styled using the ::tearoff.

See Customizing QMenu for an example.

支持盒子模型。 单个项目使用 ::item 子控件设置样式。 除了通常支持的伪状态外，项目子控件还支持 :selected、:default、:exclusive 和 non-exclusive 伪状态。 可检查菜单项的指示器使用 ::indicator 子控件设置样式。 分隔符使用 ::separator 子控件设置样式。 对于带有子菜单的项目，箭头标记的样式使用向右箭头和向左箭头。 滚动条使用 ::scroller 设置样式。 撕下的样式使用 ::tearoff。 有关示例，请参阅自定义 QMenu。

Warning: When running on Qt/Mac, the menu bar is usually embedded into the system-wide menu bar. In this case, the style sheet will have no effect.

See Customizing QMenuBar for an example.

支持盒子模型。 间距属性指定菜单项之间的间距。 单个项目使用 ::item 子控件设置样式。 警告：在 Qt/Mac 上运行时，菜单栏通常嵌入到系统范围的菜单栏中。 在这种情况下，样式表将不起作用。 有关示例，请参阅自定义 QMenuBar。

The messagebox-text-interaction-flags property can be used to alter the interaction with text in the message box.

messagebox-text-interaction-flags 属性可用于更改与消息框中文本的交互。

If the progress bar displays text, use the text-align property to position the text.

Indeterminate progress bars have the :indeterminate pseudo state set.

See Customizing QProgressBar for an example.

支持盒子模型。 进度条的块可以使用 ::chunk 子控件设置样式。 该块显示在小部件的内容矩形上。 如果进度条显示文本，请使用 text-align 属性来定位文本。 不确定进度条设置了 :indeterminate 伪状态。 有关示例，请参阅自定义 QProgressBar。

Since 5.15, the icon property can be set to override the button icon.

For QPushButton with a menu, the menu indicator is styled using the ::menu-indicator subcontrol. Appearance of checkable push buttons can be customized using the :open and :closed pseudo-states.

Warning: If you only set a background-color on a QPushButton, the background may not appear unless you set the border property to some value. This is because, by default, the QPushButton draws a native border which completely overlaps the background-color. For example,

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

See Customizing QPushButton for an example.

支持盒子模型。 支持：default、：flat、：checked 伪状态。 从 5.15 开始，图标属性可以设置为覆盖按钮图标。 对于带有菜单的 QPushButton，菜单指示器的样式使用 ::menu-indicator 子控件。 可以使用 :open 和 :closed 伪状态自定义可检查按钮的外观。 警告：如果您只在 QPushButton 上设置背景颜色，除非您将边框属性设置为某个值，否则背景可能不会出现。 这是因为默认情况下，QPushButton 会绘制一个与背景颜色完全重叠的原生边框。 例如， QPushButton { background-color: red; border: none; }有关示例，请参阅自定义 QPushButton。

The spacing property specifies the spacing between the check indicator and the text.

See Customizing QRadioButton for an example.

支持盒子模型。 可以使用 ::indicator 子控件设置检查指示器的样式。 默认情况下，指示器放置在小部件内容矩形的左上角。 间距属性指定检查指示符和文本之间的间距。 有关示例，请参阅自定义 QRadioButton。

The slider can be styled using the ::handle subcontrol. Setting the min-width or min-height provides size contraints for the slider depending on the orientation.

The ::add-line subcontrol can be used to style the button to add a line. By default, the add-line subcontrol is placed in top right corner of the Border rectangle of the widget. Depending on the orientation the ::right-arrow or ::down-arrow. By default, the arrows are placed in the center of the Contents rectangle of the add-line subcontrol.

The ::sub-line subcontrol can be used to style the button to subtract a line. By default, the sub-line subcontrol is placed in bottom right corner of the Border rectangle of the widget. Depending on the orientation the ::left-arrow or ::up-arrow. By default, the arrows are placed in the center of the Contents rectangle of the sub-line subcontrol.

The ::sub-page subcontrol can be used to style the region of the slider that subtracts a page. The ::add-page subcontrol can be used to style the region of the slider that adds a page.

See Customizing QScrollBar for an example.

支持盒子模型。小部件的内容矩形被认为是滑块移动的凹槽。 QScrollBar 的范围（即宽度或高度取决于方向）分别使用 width 或 height 属性设置。要确定方向，请使用 :horizo​​ntal 和 :vertical 伪状态。 滑块可以使用 ::handle 子控件设置样式。设置 min-width 或 min-height 会根据方向为滑块提供尺寸限制。 ::add-line 子控件可用于设置按钮样式以添加一行。默认情况下，添加行子控件位于小部件边框矩形的右上角。根据方向，::right-arrow 或 ::down-arrow。默认情况下，箭头位于添加行子控件的内容矩形的中心。 ::sub-line 子控件可用于设置按钮样式以减去一行。默认情况下，子行子控件放置在小部件的边框矩形的右下角。根据方向，::left-arrow 或 ::up-arrow。默认情况下，箭头放置在子行子控件的内容矩形的中心。 ::sub-page 子控件可用于设置减去页面的滑块区域的样式。 ::add-page 子控件可用于设置添加页面的滑块区域的样式。 有关示例，请参阅自定义 QScrollBar。

See Customizing QSizeGrip for an example.

支持宽度、高度和图像属性。 有关示例，请参阅自定义 QSizeGrip。

The groove of the slider is styled using the ::groove. The groove is positioned by default in the Contents rectangle of the widget. The thumb of the slider is styled using ::handle subcontrol. The subcontrol moves in the Contents rectangle of the groove subcontrol.

See Customizing QSlider for an example.

支持盒子模型。 对于水平幻灯片，必须提供 min-width 和 height 属性。 对于垂直滑块，必须提供 min-height 和 width 属性。 滑块的凹槽使用 ::groove 设计。 默认情况下，凹槽位于小部件的内容矩形中。 滑块的拇指使用 ::handle 子控件设置样式。 子控件在凹槽子控件的内容矩形中移动。 有关示例，请参阅自定义 QSlider。

The up button and arrow can be styled using the ::up-button and ::up-arrow subcontrols. By default, the up-button is placed in the top right corner in the Padding rectangle of the widget. Without an explicit size, it occupies half the height of its reference rectangle. The up-arrow is placed in the center of the Contents rectangle of the up-button.

The down button and arrow can be styled using the ::down-button and ::down-arrow subcontrols. By default, the down-button is placed in the bottom right corner in the Padding rectangle of the widget. Without an explicit size, it occupies half the height of its reference rectangle. The bottom-arrow is placed in the center of the Contents rectangle of the bottom-button.

See Customizing QSpinBox for an example.

旋转框的框架可以使用框模型进行样式设置。 可以使用 ::up-button 和 ::up-arrow 子控件设置向上按钮和箭头的样式。 默认情况下，向上按钮位于小部件的 Padding 矩形的右上角。 没有明确的大小，它占据其参考矩形高度的一半。 向上箭头位于向上按钮的内容矩形的中心。 可以使用 ::down-button 和 ::down-arrow 子控件设置向下按钮和箭头的样式。 默认情况下，向下按钮位于小部件的 Padding 矩形的右下角。 没有明确的大小，它占据其参考矩形高度的一半。 底部箭头位于底部按钮的内容矩形的中心。 有关示例，请参阅自定义 QSpinBox。

See Customizing QSplitter for an example.

支持盒子模型。 拆分器的句柄使用 ::handle 子控件进行样式设置。 有关示例，请参阅自定义 QSplitter。

See Customizing QStatusBar for an example.

仅支持背景属性。 单个项目的框架可以使用 ::item 子控件进行样式设置。 有关示例，请参阅自定义 QStatusBar。

The :top, :left, :right, :bottom pseudo states depending on the orientation of the tabs.

Overlapping tabs for the selected state are created by using negative margins or using the absolute position scheme.

The tear indicator of the QTabBar is styled using the ::tear subcontrol.

QTabBar used two QToolButtons for its scrollers that can be styled using the QTabBar QToolButton selector. To specify the width of the scroll button use the ::scroller subcontrol.

The alignment of the tabs within the QTabBar is styled using the alignment property.

Warning:

To change the position of the QTabBar within a QTabWidget, use the tab-bar subcontrol (and set subcontrol-position).

See Customizing QTabBar for an example.

可以使用 ::tab 子控件设置单个选项卡的样式。 使用 ::close-button 的关闭按钮选项卡支持 :only-one, :first, :last, :middle, :previous--selected, :next-selected, :selected 伪状态。 :top, :left, :right, :bottom 伪状态取决于选项卡的方向。 所选状态的重叠标签是通过使用负边距或使用绝对位置方案创建的。 QTabBar 的撕裂指示器使用 ::tear 子控件设置样式。 QTabBar 为其滚动条使用了两个 QToolButton，可以使用 QTabBar QToolButton 选择器设置样式。 要指定滚动按钮的宽度，请使用 ::scroller 子控件。 QTabBar 中选项卡的对齐方式使用 alignment 属性设置样式。 警告： 要更改 QTabBar 在 QTabWidget 中的位置，请使用标签栏子控件（并设置子控件位置）。 有关示例，请参阅自定义 QTabBar。

By default, the subcontrols have positions of a QTabWidget in the QWindowsStyle. To place the QTabBar in the center, set the subcontrol-position of the tab-bar subcontrol.

The :top, :left, :right, :bottom pseudo states depending on the orientation of the tabs.

See Customizing QTabWidget for an example.

标签小部件的框架使用 ::pane 子控件进行样式设置。 左右角分别使用 ::left-corner 和 ::right-corner 进行样式设置。 标签栏的位置是使用 ::tab-bar 子控件控制的。 默认情况下，子控件在 QWindowsStyle 中具有 QTabWidget 的位置。 要将 QTabBar 置于中心，请设置标签栏子控件的子控件位置。 :top, :left, :right, :bottom 伪状态取决于选项卡的方向。 有关示例，请参阅自定义 QTabWidget。

The color and background of the selected item is styled using selection-color and selection-background-color respectively.

The corner widget in a QTableView is implemented as a QAbstractButton and can be styled using the "QTableView QTableCornerButton::section" selector.

Warning: If you only set a background-color on a QTableCornerButton, the background may not appear unless you set the border property to some value. This is because, by default, the QTableCornerButton draws a native border which completely overlaps the background-color.

The color of the grid can be specified using the gridline-color property.

See QAbsractScrollArea to style scrollable backgrounds.

See Customzing QTableView for an example.

支持盒子模型。 启用交替行颜色后，可以使用交替背景颜色属性设置交替颜色的样式。 所选项目的颜色和背景分别使用 selection-color 和 selection-background-color 设置样式。 QTableView 中的角小部件作为 QAbstractButton 实现，可以使用“QTableView QTableCornerButton::section”选择器设置样式。 警告：如果您只在 QTableCornerButton 上设置背景颜色，除非您将边框属性设置为某个值，否则背景可能不会出现。 这是因为，默认情况下， QTableCornerButton 绘制一个与背景颜色完全重叠的原生边框。 可以使用 gridline-color 属性指定网格的颜色。 请参阅 QAbsractScrollArea 以设置可滚动背景的样式。 有关示例，请参阅自定义 QTableView。

The color and background of selected text is styled using selection-color and selection-background-color respectively.

See QAbsractScrollArea to style scrollable backgrounds.

支持盒子模型。 所选文本的颜色和背景分别使用 selection-color 和 selection-background-color 设置样式。 请参阅 QAbsractScrollArea 以设置可滚动背景的样式。

The :top, :left, :right, :bottom pseudo states depending on the area in which the tool bar is grouped.

The :first, :last, :middle, :only-one pseudo states indicator the position of the tool bar within a line group (See QStyleOptionToolBar::positionWithinLine).

The separator of a QToolBar is styled using the ::separator subcontrol.

The handle (to move the toolbar) is styled using the ::handle subcontrol.

See Customizing QToolBar for an example.

支持盒子模型。 :top, :left, :right, :bottom 伪状态取决于工具栏所在的区域。 :first、:last、:middle、:only-one 伪状态指示线组中工具栏的位置（请参阅 QStyleOptionToolBar::positionWithinLine）。 QToolBar 的分隔符使用 ::separator 子控件进行样式设置。 手柄（用于移动工具栏）使用 ::handle 子控件设置样式。 有关示例，请参阅自定义 QToolBar。

If the QToolButton has a menu, is ::menu-indicator subcontrol can be used to style the indicator. By default, the menu-indicator is positioned at the bottom right of the Padding rectangle of the widget.

If the QToolButton is in QToolButton::MenuButtonPopup mode, the ::menu-button subcontrol is used to draw the menu button. ::menu-arrow subcontrol is used to draw the menu arrow inside the menu-button. By default, it is positioned in the center of the Contents rectangle of the menu-button subcontrol.

When the QToolButton displays arrows, the ::up-arrow, ::down-arrow, ::left-arrow and ::right-arrow subcontrols are used.

Warning: If you only set a background-color on a QToolButton, the background will not appear unless you set the border property to some value. This is because, by default, the QToolButton draws a native border which completely overlaps the background-color. For example,

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

See Customizing QToolButton for an example.

支持盒子模型。 如果 QToolButton 有菜单， is ::menu-indicator 子控件可用于设置指示器的样式。默认情况下，菜单指示器位于小部件的 Padding 矩形的右下角。 如果 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。

The individual tabs can by styled using the ::tab subcontrol. The tabs support the :only-one, :first, :last, :middle, :previous-selected, :next-selected, :selected pseudo states.

支持盒子模型。 可以使用 ::tab 子控件设置各个选项卡的样式。 选项卡支持:only-one, :first, :last, :middle, :previous-selected, :next-selected, :selected 伪状态。

See Customizing QFrame for an example (a QToolTip is a QFrame).

支持盒子模型。 opacity 属性控制工具提示的不透明度。 有关示例，请参阅自定义 QFrame（QToolTip 是 QFrame）。

The color and background of the selected item is styled using selection-color and selection-background-color respectively.

The selection behavior is controlled by the show-decoration-selected property.

The branches of the tree view can be styled using the ::branch subcontrol. The ::branch Sub-control supports the :open, :closed, :has-sibling and :has-children pseudo states.

Use the ::item subcontrol for more fine grained control over the items in the QTreeView.

See QAbsractScrollArea to style scrollable backgrounds.

See Customizing QTreeView for an example to style the branches.

支持盒子模型。 启用交替行颜色后，可以使用交替背景颜色属性设置交替颜色的样式。 所选项目的颜色和背景分别使用 selection-color 和 selection-background-color 设置样式。 选择行为由 show-decoration-selected 属性控制。 树视图的分支可以使用 ::branch 子控件进行样式设置。 ::branch 子控件支持 :open、:closed、:has-sibling 和 :has-children 伪状态。 使用 ::item 子控件对 QTreeView 中的项目进行更细粒度的控制。 请参阅 QAbsractScrollArea 以设置可滚动背景的样式。 有关设置分支样式的示例，请参阅自定义 QTreeView。

If you subclass from QWidget, you need to provide a paintEvent for your custom QWidget as below:

仅支持背景、背景剪辑和背景原点属性。 如果您是 QWidget 的子类，则需要为您的自定义 QWidget 提供一个paintEvent，如下所示：

void CustomWidget::paintEvent(QPaintEvent *)
{
    QStyleOption opt;
    opt.init(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
}

The above code is a no-operation if there is no stylesheet set.

Warning: Make sure you define the Q_OBJECT macro for your custom widget.

如果没有设置样式表，上面的代码是无操作的。 警告：确保为自定义小部件定义 Q_OBJECT 宏。

If this property is not set, the default value is whatever is set for the palette's AlternateBase role.

Example:

QAbstractItemView 子类中使用的备用背景颜色。 如果未设置此属性，

则默认值是为调色板的 AlternateBase 角色设置的任何值。 例子：

QTreeView {
    alternate-background-color: blue;
    background: yellow;
}

See also background and selection-background-color.

另请参阅背景和选择背景颜色。

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, and plain QWidgets.

Example:

用于设置背景的速记符号。 相当于指定背景颜色、背景图像、背景重复和/或背景位置。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QDialog、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSplitter、QTextEdit 和 QToolTWidget 支持此属性 例子：

QTextEdit { background: yellow }

Often, it is required to set a fill pattern similar to the styles in Qt::BrushStyle. You can use the background-color property for Qt::SolidPattern, Qt::RadialGradientPattern, Qt::LinearGradientPattern and Qt::ConicalGradientPattern. The other patterns are easily achieved by creating a background image that contains the pattern.

Example:

通常，需要设置类似于 Qt::BrushStyle 中的样式的填充模式。 您可以为 Qt::SolidPattern、Qt::RadialGradientPattern、Qt::LinearGradientPattern 和 Qt::ConicalGradientPattern 使用背景颜色属性。 通过创建包含该图案的背景图像，可以轻松实现其他图案。 例子：

QLabel {
    background-image: url(dense6pattern.png);
    background-repeat: repeat-xy;
}

See also background-origin, selection-background-color, background-clip, background-attachment and alternate-background-color.

Examples:

用于小部件的背景颜色。 例子：

QLabel { background-color: yellow }
QLineEdit { background-color: rgb(255, 0, 0) }

Example:

用于小部件的背景图像。 图像的半透明部分让背景颜色闪耀。 例子：

QFrame { background-image: url(:/images/hydro.png) }

If this property is not specified, the background image is repeated in both directions (repeat).

Example:

是否以及如何重复背景图像以填充背景原点矩形。 如果未指定此属性，则背景图像在两个方向上重复（repeat）。 例子：

QFrame {
    background: white url(:/images/ring.png);
    background-repeat: repeat-y;
    background-position: left;
}

If this property is not specified, the alignment is top left.

Example:

背景图片在背景原点矩形内的对齐方式。 如果未指定此属性，则对齐方式为左上角。 例子：

QFrame {
    background: url(:/images/footer.png);
    background-position: bottom left;
}

Example:

确定 QAbstractScrollArea 中的背景图像是相对于视口滚动还是固定。 默认情况下，背景图像随视口滚动。 例子：

QTextEdit {
    background-image: url("leaves.png");
    background-attachment: fixed;
}

See also background

This property specifies the rectangle to which the background-color and background-image are clipped.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, and plain QWidgets.

If this property is not specified, the default is border.

Example:

小部件的矩形，其中绘制了背景。 此属性指定背景颜色和背景图像被剪切到的矩形。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QDialog、QFrame、QGroupBox、QLabel、QPushButton、QRadioButton、QSplitter、QTextEdit、QToolTip 和普通 QWidget 支持此属性。 如果未指定此属性，则默认为边框。 例子：

QFrame {
    background-image: url(:/images/header.png);
    background-position: top left;
    background-origin: content;
    background-clip: padding;
}

See also background, background-origin and The Box Model.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, and plain QWidgets.

If this property is not specified, the default is padding.

Example:

小部件的背景矩形，与背景位置和背景图像结合使用。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QDialog、QFrame、QGroupBox、QLabel、QPushButton、QRadioButton、QSplitter、QTextEdit、QToolTip 和普通 QWidget 支持此属性。 如果未指定此属性，则默认为填充。 例子：

QFrame {
    background-image: url(:/images/header.png);
    background-position: top left;
    background-origin: content;
}

See also background and The Box Model.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, and plain QWidgets.

Example:

用于设置小部件边框的速记符号。 相当于指定边框颜色、边框样式和/或边框宽度。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSplitter、QTextEdit、QToolQWidgets 和普通支持此属性。 例子：

QLineEdit { border: 1px solid white }

Shorthand notation for setting the widget's top border. Equivalent to specifying border-top-color, border-top-style, and/or border-top-width.

用于设置小部件顶部边框的速记符号。 相当于指定 border-top-color、border-top-style 和/或 border-top-width。

Shorthand notation for setting the widget's right border. Equivalent to specifying border-right-color, border-right-style, and/or border-right-width.

用于设置小部件右边框的速记符号。 相当于指定 border-right-color、border-right-style 和/或 border-right-width。

Shorthand notation for setting the widget's bottom border. Equivalent to specifying border-bottom-color, border-bottom-style, and/or border-bottom-width.

用于设置小部件底部边框的速记符号。 相当于指定 border-bottom-color、border-bottom-style 和/或 border-bottom-width。

Shorthand notation for setting the widget's left border. Equivalent to specifying border-left-color, border-left-style, and/or border-left-width.

用于设置小部件左边框的速记符号。 相当于指定border-left-color、border-left-style和/或border-left-width。

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, and plain QWidgets.

If this property is not specified, it defaults to color (i.e., the widget's foreground color).

Example:

所有边框边缘的颜色。 相当于指定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、QToolQWidgets 和普通支持此属性。 如果未指定此属性，则默认为颜色（即小部件的前景色）。 例子：

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-color: white;
}

See also border-style, border-width, border-image, and The Box Model.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit and QToolTip.

See also border-color, border-style, border-width, and The Box Model.

用于填充边框的图像。 图像被切割成九个部分，并在必要时适当拉伸。 有关详细信息，请参阅边框图片。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSplitter、QTextEdit 和 QToolTip 支持此属性。 另请参阅边框颜色、边框样式、边框宽度和盒子模型。

The border-radius clips the element's background.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, and QToolTip.

If this property is not specified, it defaults to 0.

Example:

边界角的半径。 相当于指定border-top-left-radius、border-top-right-radius、border-bottom-right-radius和border-bottom-left-radius。 border-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;
}

See also border-width and The Box Model.

另请参阅边框宽度和盒子模型。

The radius of the border's top-left corner.

边框左上角的半径。

The radius of the border's top-right corner.

边框右上角的半径。

The radius of the border's bottom-right corner. Setting this property to a positive value results in a rounded corner.

边框右下角的半径。 将此属性设置为正值会导致圆角。

The radius of the border's bottom-left corner. Setting this property to a positive value results in a rounded corner.

边框左下角的半径。 将此属性设置为正值会导致圆角。

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, and QToolTip.

If this property is not specified, it defaults to none.

Example:

所有边框边缘的样式。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSplitter、QTextEdit 和 QToolTip 支持此属性。 如果未指定此属性，则默认为无。 例子：

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-color: blue;
}

See also border-color, border-style, border-image, and The Box Model.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, and QToolTip.

Example:

边框的宽度。 相当于设置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 支持此属性。 例子：

QLineEdit {
    border-width: 2px;
    border-style: solid;
    border-color: darkblue;
}

See also border-color, border-radius, border-style, border-image, and The Box Model.

If position is absolute, the bottom property specifies the subcontrol's bottom edge in relation to the parent's bottom edge (see also subcontrol-origin).

Example:

如果位置是相对的（默认），则将子控件向上移动一定的偏移量； 指定底部：y 则等效于指定顶部：-y。 如果 position 是绝对的，则底部属性指定子控件相对于父控件底部边缘的底部边缘（另请参阅 subcontrol-origin）。 例子：

QSpinBox::down-button { bottom: 2px }

如果位置是相对的（默认），则将子控件向上移动一定的偏移量； 指定底部：y 则等效于指定顶部：-y。 如果 position 是绝对的，则底部属性指定子控件相对于父控件底部边缘的底部边缘（另请参阅 subcontrol-origin）。 例子： QSpinBox::down-button { bottom: 2px }

See also left, right, and top.

If this property is not specified, it defaults to the value specified by the current style for the SH_DialogButtonLayout style hint.

Example:

QDialogButtonBox 或 QMessageBox 中按钮的布局。 可能的值为 0 (WinLayout)、1 (MacLayout)、2 (KdeLayout)、3 (GnomeLayout) 和 5 (AndroidLayout)。 如果未指定此属性，则默认为 SH_DialogButtonLayout 样式提示的当前样式指定的值。 例子：

* { button-layout: 2 }

This property is supported by all widgets that respect the QWidget::palette.

If this property is not set, the default is whatever is set for in the widget's palette for the QWidget::foregroundRole (typically black).

Example:

用于呈现文本的颜色。 所有尊重 QWidget::palette 的小部件都支持此属性。 如果未设置此属性，则默认值为小部件调色板中为 QWidget::foregroundRole 设置的任何内容（通常为黑色）。 例子：

QPushButton { color: red }

See also background and selection-color.

If this property is set to 1, the buttons of a QDialogButtonBox show icons; if it is set to 0, the icons are not shown.

See the List of Icons section for information on how to set icons.

QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }

Note: Styles defining this property must be applied before the QDialogButtonBox is created; this means that you must apply the style to the parent widget or to the application itself.

QDialogButtonBox 中的按钮是否显示图标 如果此属性设置为 1，则 QDialogButtonBox 的按钮显示图标； 如果设置为 0，则不显示图标。 有关如何设置图标的信息，请参阅图标列表部分。 QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; } 注意：定义此属性的样式必须在创建 QDialogButtonBox 之前应用； 这意味着您必须将样式应用到父小部件或应用程序本身。

This property is supported by all widgets that respect the QWidget::font.

If this property is not set, the default is the QWidget::font.

Example:

用于设置文本字体的速记符号。 相当于指定 font-family、font-size、font-style 和/或 font-weight。 所有尊重 QWidget::font 的小部件都支持此属性。 如果未设置此属性，则默认为 QWidget::font。 例子：

QCheckBox { font: bold italic large "Times New Roman" }

Example:

QCheckBox { font-family: "New Century Schoolbook" }

The font size. In this version of Qt, only pt and px metrics are supported.

字体大小。 在此版本的 Qt 中，仅支持 pt 和 px 指标。

Example:

QTextEdit { font-size: 12px }

Example:

QTextEdit { font-style: italic }

If this property is not specified, it defaults to the value specified by the current style for the SH_Table_GridLineColor style hint.

Example:

QTableView 中网格线的颜色。 如果未指定此属性，则默认为当前样式为 SH_Table_GridLineColor 样式提示指定的值。 例子：

* { gridline-color: gray }

If this property is not specified, it defaults to a value that depends on the subcontrol/widget and on the current style.

Warning: Unless otherwise specified, this property has no effect when set on widgets. If you want a widget with a fixed height, set the min-height and max-height to the same value.

子控件（或在某些情况下是小部件）的高度。 如果未指定此属性，则默认为取决于子控件/小部件和当前样式的值。 警告：除非另有说明，否则此属性在小部件上设置时无效。 如果您想要一个具有固定高度的小部件，请将 min-height 和 max-height 设置为相同的值。

Example:

QSpinBox::down-button { height: 10px }

See also width.

The only widget currently supporting this property is QPushButton.

Note: It's the application's responsibilty to assign an icon to a button (using the QAbstractButton API), and not the style's. So be careful setting it unless your stylesheet is targeting a specific application.

Available since 5.15.

用于具有图标的小部件的图标。 当前唯一支持此属性的小部件是 QPushButton。 注意：为按钮分配图标（使用 QAbstractButton API）是应用程序的责任，而不是样式的责任。 因此，除非您的样式表针对特定应用程序，否则请小心设置它。 自 5.15 起可用。

The icon size of the following widgets can be set using this property.

小部件中图标的宽度和高度。 可以使用此属性设置以下小部件的图标大小。

• QCheckBox
• QListView
• QPushButton
• QRadioButton
• QTabBar
• QToolBar
• QToolBox
• QTreeView

The image property accepts a list of Urls or an svg. The actual image that is drawn is determined using the same algorithm as QIcon (i.e) the image is never scaled up but always scaled down if necessary. If a svg is specified, the image is scaled to the size of the contents rectangle.

Setting the image property on sub controls implicitly sets the width and height of the sub-control (unless the image in a SVG).

In Qt 4.3 and later, the alignment of the image within the rectangle can be specified using image-position.

This property is for subcontrols only--we don't support it for other elements.

Warning: The QIcon SVG plugin is needed to render SVG images.

在子控件的内容矩形中绘制的图像。 image 属性接受 URL 列表或 svg。 绘制的实际图像使用与 QIcon 相同的算法确定（即图像从不放大，但在必要时总是缩小。 如果指定了 svg，则图像将缩放到内容矩形的大小。 在子控件上设置图像属性会隐式设置子控件的宽度和高度（除非图像在 SVG 中）。 在 Qt 4.3 及更高版本中，可以使用 image-position 指定矩形内图像的对齐方式。 此属性仅适用于子控件——我们不支持其他元素使用它。 警告：渲染 SVG 图像需要 QIcon SVG 插件。

Example:

// implicitly sets the size of down-button to the
// size of spindown.png
QSpinBox::down-button { image: url(:/images/spindown.png) }

In Qt 4.3 and later, the alignment of the image image's position can be specified using relative or absolute position.

在 Qt 4.3 及更高版本中，可以使用相对或绝对位置指定图像图像位置的对齐方式。

If position is absolute, the left property specifies the subcontrol's left edge in relation to the parent's left edge (see also subcontrol-origin).

If this property is not specified, it defaults to 0.

如果 position 是相对的（默认），则将子控件向右移动一定的偏移量。 如果 position 是绝对的，则 left 属性指定子控件相对于父控件左边缘的左边缘（另请参阅 subcontrol-origin）。

如果未指定此属性，则默认为 0。

Example:

QSpinBox::down-button { left: 2px }

See also right, top, and bottom.

If this property is not specified, it defaults to the value specified by the current style for the SH_LineEdit_PasswordCharacter style hint.

QLineEdit 密码字符作为 Unicode 数字。 如果未指定此属性，则默认为 SH_LineEdit_PasswordCharacter 样式提示的当前样式指定的值。

Example:

* { lineedit-password-character: 9679 }

If this property is not specified, it defaults to the value specified by the current style for the SH_LineEdit_PasswordMaskDelay style hint.

This property was added in Qt 5.4.

在将 lineedit-password-character 应用于可见字符之前，QLineEdit 密码掩码延迟（以毫秒为单位）。 如果未指定此属性，则默认为 SH_LineEdit_PasswordMaskDelay 样式提示的当前样式指定的值。

这个属性是在 Qt 5.4 中添加的。

Example:

* { lineedit-password-mask-delay: 1000 }

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, and QToolTip.

If this property is not specified, it defaults to 0.

小部件的边距。 相当于指定 margin-top、margin-right、margin-bottom 和 margin-left。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSplitter、QTextEdit 和 QToolTip 支持此属性。 如果未指定此属性，则默认为 0。

Example:

QLineEdit { margin: 2px }

See also padding, spacing, and The Box Model.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, and QToolTip.

The value is relative to the contents rect in the box model.

小部件或子控件的最大高度。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSizeGrip、QSpinBox、QTextEdit、QStatus、QStatus 支持此属性。 该值与框模型中的内容 rect 相关。

Example:

QSpinBox { max-height: 24px }

See also max-width.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, and QToolTip.

The value is relative to the contents rect in the box model.

小部件或子控件的最大宽度。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSizeGrip、QSpinBox、QTextEdit、QStatus、QStatus 支持此属性。 该值与框模型中的内容 rect 相关。

Example:

QComboBox { max-width: 72px }

See also max-height.

If this property is not specified, it defaults to the value specified by the current style for the SH_MessageBox_TextInteractionFlags style hint.

消息框中文本的交互行为。 可能的值基于 Qt::TextInteractionFlags。 如果未指定此属性，则默认为当前样式为 SH_MessageBox_TextInteractionFlags 样式提示指定的值。

Example:

QMessageBox { messagebox-text-interaction-flags: 5 }

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, and QToolTip.

If this property is not specified, the minimum height is derived based on the widget's contents and the style.

The value is relative to the contents rect in the box model.

小部件或子控件的最小高度。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSizeGrip、QSpinBox、QTextEdit、QStatus、QStatus 支持此属性。 如果未指定此属性，则根据小部件的内容和样式得出最小高度。 该值与框模型中的内容 rect 相关。

Example:

QComboBox { min-height: 24px }

See also min-width.

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, and QToolTip.

If this property is not specified, the minimum width is derived based on the widget's contents and the style.

The value is relative to the contents rect in the box model.

小部件或子控件的最小宽度。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSizeGrip、QSpinBox、QTextEdit、QStatus、QStatus 支持此属性。 如果未指定此属性，则根据小部件的内容和样式派生最小宽度。 该值与框模型中的内容 rect 相关。

Example:

QComboBox { min-width: 72px }

See also min-height.

If this property is not specified, it defaults to the value specified by the current style for the SH_ToolTipLabel_Opacity style hint.

小部件的不透明度。 可能的值是从 0（透明）到 255（不透明）。 目前，这仅支持工具提示。 如果未指定此属性，则默认为 SH_ToolTipLabel_Opacity 样式提示的当前样式指定的值。

Example:

QToolTip { opacity: 223 }

Specifies the pattern used to draw the outline. See also border-style

指定用于绘制轮廓的图案。 另请参阅边框样式

The radius for the bottom-left rounded corner of the outline.

轮廓左下角圆角的半径。

The radius for the bottom-right rounded corner of the outline.

轮廓右下角圆角的半径。

The radius for the top-left corner of the outline.

轮廓左上角的半径。

The radius for the top-right rounded corner of the outline.

轮廓右上角圆角的半径。

This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, and QToolTip.

If this property is not specified, it defaults to 0.

小部件的填充。 相当于指定 padding-top、padding-right、padding-bottom 和 padding-left。 QAbstractItemView 子类、QAbstractSpinBox 子类、QCheckBox、QComboBox、QFrame、QGroupBox、QLabel、QLineEdit、QMenu、QMenuBar、QPushButton、QRadioButton、QSplitter、QTextEdit 和 QToolTip 支持此属性。 如果未指定此属性，则默认为 0。

Example:

QLineEdit { padding: 3px }

See also margin, spacing, and The Box Model.

Whether the QTreeView paints alternating row colors for the empty area (i.e the area where there are no items)

QTreeView 是否为空白区域（即没有项目的区域）绘制交替的行颜色

If this property is not specified, it defaults to relative.

使用左、右、顶和底指定的偏移量是相对坐标还是绝对坐标。 如果未指定此属性，则默认为相对。

If position is absolute, the right property specifies the subcontrol's right edge in relation to the parent's right edge (see also subcontrol-origin).

如果 position 是相对的（默认），则将子控件向左移动一定的偏移量； 指定 right: x 等效于指定 left: -x。 如果 position 是绝对的，

则 right 属性指定子控件相对于父控件右边缘的右边缘（另请参阅 subcontrol-origin）。

Example:

QSpinBox::down-button { right: 2px }

See also left, top, and bottom.

This property is supported by all widgets that respect the QWidget::palette and that show selection text.

If this property is not set, the default value is whatever is set for the palette's Highlight role.

所选文本或项目的背景。 所有尊重 QWidget::palette 并显示选择文本的小部件都支持此属性。

如果未设置此属性，则默认值是为调色板的突出显示角色设置的任何值。

Example:

QTextEdit { selection-background-color: darkblue }

See also selection-color and background.

This property is supported by all widgets that respect the QWidget::palette and that show selection text.

If this property is not set, the default value is whatever is set for the palette's HighlightedText role.

所选文本或项目的前景。 所有尊重 QWidget::palette 并显示选择文本的小部件都支持此属性。 如果未设置此属性，

则默认值是为调色板的 HighlightedText 角色设置的任何值。

Example:

QTextEdit { selection-color: white }

See also selection-background-color and color.

If this property is not specified, it defaults to the value specified by the current style for the SH_ItemView_ShowDecorationSelected style hint.

控制 QListView 中的选择是覆盖整行还是仅覆盖文本的范围。 如果未指定此属性，

则默认为 SH_ItemView_ShowDecorationSelected 样式提示的当前样式指定的值。

Example:

* { show-decoration-selected: 1 }

This property is supported by QCheckBox, checkable QGroupBoxes, QMenuBar, and QRadioButton.

If this property is not specified, the default value depends on the widget and on the current style.

小部件中的内部间距。 QCheckBox、可检查的 QGroupBoxes、QMenuBar 和 QRadioButton 支持此属性。

如果未指定此属性，则默认值取决于小部件和当前样式。

Example:

QMenuBar { spacing: 10 }

See also padding and margin.

If this property is not specified, the default is padding.

父元素内子控件的原点矩形。 如果未指定此属性，则默认为填充。

Example:

QSpinBox::up-button {
    image: url(:/images/spinup.png);
    subcontrol-origin: content;
    subcontrol-position: right top;
}

See also subcontrol-position.

If this property is not specified, it defaults to a value that depends on the subcontrol.

子控件在 subcontrol-origin 指定的原点矩形内的对齐方式。

如果未指定此属性，则默认为取决于子控件的值。

Example:

QSpinBox::down-button {
    image: url(:/images/spindown.png);
    subcontrol-origin: padding;
    subcontrol-position: right bottom;
}

See also subcontrol-origin.

Whether tool tips are shown on window title bar buttons.

工具提示是否显示在窗口标题栏按钮上。

If this property is not specified, it defaults to the value specified by the current style for the SH_Widget_Animation_Duration style hint.

This property was added in Qt 5.10.

动画应该持续多长时间（以毫秒为单位）。 值为零意味着动画将被禁用。 如果未指定此属性，

则默认为 SH_Widget_Animation_Duration 样式提示的当前样式指定的值。 这个属性是在 Qt 5.10 中添加的。

Example:

* { widget-animation-duration: 100 }

If this value is not specified, it defaults to the value that depends on the native style.

小部件内容中文本和图标的对齐方式。 如果未指定此值，则默认为取决于本机样式的值。

Example:

QPushButton {
    text-align: left;
}

This property is currently supported only by QPushButton and QProgressBar.

If position is absolute, the top property specifies the subcontrol's top edge in relation to the parent's top edge (see also subcontrol-origin).

If this property is not specified, it defaults to 0.

如果 position 是相对的（默认），则将子控件向下移动一定的偏移量。 如果 position 是绝对的，则 top 属性指定子控件相对于父控件的顶部边缘的顶部边缘

（另请参阅 subcontrol-origin）。 如果未指定此属性，则默认为 0。

Example:

QSpinBox::up-button { top: 2px }

See also left, right, and bottom.

If this property is not specified, it defaults to a value that depends on the subcontrol/widget and on the current style.

Warning: Unless otherwise specified, this property has no effect when set on widgets. If you want a widget with a fixed width, set the min-width and max-width to the same value.

子控件（或某些情况下的小部件）的宽度。 如果未指定此属性，则默认为取决于子控件/小部件和当前样式的值。 警告：除非另有说明，否则此属性在小部件上设置时无效。 如果您想要一个固定宽度的小部件，请将 min-width 和 max-width 设置为相同的值。

Example:

QSpinBox::up-button { width: 12px }

See also height.

The background-color for the subcontrol or widget based on the chosen role.

基于所选角色的子控件或小部件的背景颜色。

Note: The list can only include properties that are not pixmap-based.

要应用 Qt 特定样式的 CSS 属性列表。 注意：该列表只能包含不基于像素图的属性。

Example:

QTextEdit { background-position: bottom center }

Example:

QDialog { etch-disabled-text: 1 }

See the CSS3 Draft Specification for details.

Example:

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 */

Examples:

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 */

Examples:

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 */

Note: The RGB colors allowed are the same as those allowed with CSS 2.1, as listed here.

• Linear gradients interpolate colors between start and end points.
• Radial gradients interpolate colors between a focal point and end points on a circle surrounding it.
• Conical gradients interpolate colors around a center point.

Gradients are specified in Object Bounding Mode. Imagine the box in which the gradient is rendered, to have its top left corner at (0, 0) and its bottom right corner at (1, 1). Gradient parameters are then specified as percentages from 0 to 1. These values are extrapolated to actual box coordinates at runtime. It is possible specify values that lie outside the bounding box (-0.6 or 1.8, for instance).

Warning: The stops have to appear sorted in ascending order.

Examples:

/* 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)
}

Example:

* {
    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;
}

• px: pixels
• pt: the size of one point (i.e., 1/72 of an inch)
• em: the em width of the font (i.e., the width of 'M')
• ex: the x-height of the font (i.e., the height of 'x')

However, Qt is limited to font sizes in pt and px and any other size must be in px, em or ex.

• margin: The margin rectangle. The margin falls outside the border.
• border: The border rectangle. This is where any border is drawn.
• padding: The padding rectangle. Unlike the margins, padding is located inside the border.
• content: The content rectangle. This specifies where the actual contents go, excluding any padding, border, or margin.

See also The Box Model.

For example,

QPushButton { color: palette(dark); }

• repeat-x: Repeat horizontally.
• repeat-y: Repeat vertically.
• repeat: Repeat horizontally and vertically.
• no-repeat: Don't repeat.