Qt 样式表参考

Qt 样式表支持各种特性、伪状态及子控件 (使定制 Widget 外观成为可能)。

可样式化 Widget 列表

下表列出可以使用样式表进行定制的 Qt Widgets：

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

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

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

特性列表

This section lists all the properties supported by Qt Style Sheets. Which values can be given to a property depend on the 特性类型 . Unless otherwise specified, the following properties apply to all widgets. Properties marked with an asterisk * are specific to Qt and have no equivalent in CSS2 or CSS3. The Qt-specific properties are the following:

• gridline-color*
• image*
• lineedit-password-character*
• lineedit-password-mask-delay*
• messagebox-text-interaction-flags*
• opacity*
• placeholder-text-color*
• selection-background-color*
• selection-color*
• show-decoration-selected*
• spacing*
• subcontrol-origin*
• subcontrol-position*
• widget-animation-duration*

accent-color

The property sets the Accent , which is used to emphasize interactive UI elements. If this property is not set, it defaults to the highlight 颜色。

alternate-background-color

The 替代背景颜色 用于 QAbstractItemView 子类。

若此特性未设置，将默认值设为调色板的 AlternateBase 角色。

范例：

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

另请参阅 background and selection-background-color .

background

Shorthand notation for setting the background. Equivalent to specifying background-color , background-image , background-repeat , and/or background-position .

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QDialog , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSplitter , QTextEdit , QToolTip ，和纯 QWidget 。

范例：

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.

范例：

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

另请参阅 background-origin , selection-background-color , background-clip , background-attachment and alternate-background-color .

background-color

用于 Widget 的背景颜色。

范例：

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

background-image

The background image used for the widget. Semi-transparent parts of the image let the background-color shine through.

范例：

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

background-repeat

Whether and how the background image is repeated to fill the background-origin 矩形。

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

范例：

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

background-position

背景图像的对齐方式在 background-origin 矩形。

若此特性未指定，对齐方式为 top left .

范例：

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

background-attachment

确定 background-image 是否在 QAbstractScrollArea is scrolled or fixed with respect to the viewport. By default, the background-image scrolls with the viewport.

范例：

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

另请参阅 background

background-clip

Widget 的矩形，在那里 background 被绘制。

此特性指定矩形以在那里 background-color and background-image 被裁剪。

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QDialog , QFrame , QGroupBox , QLabel , QPushButton , QRadioButton , QSplitter , QTextEdit , QToolTip ，和纯 QWidget 。

如果此特性未指定，默认为 border .

范例：

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

另请参阅 background , background-origin and Box 模型 .

background-origin

Widget 的背景矩形，用于结合 background-position and background-image .

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QDialog , QFrame , QGroupBox , QLabel , QPushButton , QRadioButton , QSplitter , QTextEdit , QToolTip ，和纯 QWidget 。

如果此特性未指定，默认为 padding .

范例：

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

另请参阅 background and Box 模型 .

border

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

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSplitter , QTextEdit , QToolTip ，和纯 QWidget 。

范例：

QLineEdit { border: 1px solid white }
	

border-top

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

border-right

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

border-bottom

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

border-left

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

border-color

The color of all the border's edges. Equivalent to specifying 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 (i.e., the widget's foreground color).

范例：

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

另请参阅 border-style , border-width , border-image ，和 Box 模型 .

border-top-color

The color of the border's top edge.

border-right-color

The color of the border's right edge.

border-bottom-color

The color of the border's bottom edge.

border-left-color

The color of the border's left edge.

border-image

The image used to fill the border. The image is cut into nine parts and stretched appropriately if necessary. See Border Image 了解细节。

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSplitter , QTextEdit and QToolTip .

另请参阅 border-color , border-style , border-width ，和 Box 模型 .

border-radius

The radius of the border's corners. Equivalent to specifying border-top-left-radius , border-top-right-radius , border-bottom-right-radius ，和 border-bottom-left-radius .

The border-radius clips the element's background .

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSplitter , QTextEdit ，和 QToolTip .

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

范例：

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-radius: 4px;
}
	

另请参阅 border-width and Box 模型 .

border-top-left-radius

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

border-top-right-radius

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

border-bottom-right-radius

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

border-bottom-left-radius

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

border-style

所有边框边缘的样式。

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSplitter , QTextEdit ，和 QToolTip .

若此特性未指定，默认为 none .

范例：

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

另请参阅 border-color , border-style , border-image ，和 Box 模型 .

border-top-style

The style of the border's top edge.

border-right-style

The style of the border's right edge.

border-bottom-style

The style of the border's bottom edge.

border-left-style

The style of the border's left edge.

border-width

The width of the border. Equivalent to setting 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;
}
	

另请参阅 border-color , border-radius , border-style , border-image ，和 Box 模型 .

border-top-width

The width of the border's top edge.

border-right-width

The width of the border's right edge.

border-bottom-width

The width of the border's bottom edge.

border-left-width

The width of the border's left edge.

bottom

若 position is relative (the default), moves a subcontrol by a certain offset up; specifying bottom: y is then equivalent to specifying top: -y .

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

范例：

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

另请参阅 left , right ，和 top .

button-layout

The layout of buttons in a QDialogButtonBox 或 QMessageBox . The possible values are 0 ( WinLayout ), 1 ( MacLayout ), 2 ( KdeLayout ), 3 ( GnomeLayout ) and 5 ( AndroidLayout ).

若此特性未指定，默认为当前样式指定值对于 SH_DialogButtonLayout 样式提示。

范例：

* { button-layout: 2 }
	

color

颜色用于渲染文本。

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).

范例：

QPushButton { color: red }
	

另请参阅 background and selection-color .

dialogbuttonbox-buttons-have-icons

Whether the buttons in a QDialogButtonBox show icons

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.

见 图标列表 section for information on how to set icons.

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

注意： 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.

font

Shorthand notation for setting the text's font. Equivalent to specifying font-family , font-size , font-style , and/or font-weight .

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

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

范例：

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

font-family

字体系列。

范例：

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

font-size

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

范例：

QTextEdit { font-size: 12px }
	

font-style

字体样式。

范例：

QTextEdit { font-style: italic }
	

font-weight

字体的精细。

gridline-color*

栅格线的颜色在 QTableView .

若此特性未指定，默认为当前样式指定值对于 SH_Table_GridLineColor 样式提示。

范例：

* { gridline-color: gray }
	

height

子控件 (或在某些情况下的 Widget) 的高度。

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

警告： 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.

范例：

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

另请参阅 width .

icon

The icon that is used, for widgets that have an icon.

The only widget currently supporting this property is QPushButton .

注意： It's the application's responsibility 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.

从 5.15 起可用。

icon-size

Widget 图标的宽度和高度。

使用此特性，可以设置下列 Widget 的图标大小。

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

image*

The image that is drawn in the contents rectangle of a subcontrol.

The image property accepts a list of Url s 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.

警告： The QIcon SVG plugin is needed to render SVG images.

范例：

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

image-position

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

left

若 position is relative (the default), moves a subcontrol by a certain offset to the right.

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

若此特性未指定，默认为 0 .

范例：

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

另请参阅 right , top ，和 bottom .

lineedit-password-character*

The QLineEdit password character as a Unicode number.

若此特性未指定，默认为当前样式指定值对于 SH_LineEdit_PasswordCharacter 样式提示。

范例：

* { lineedit-password-character: 9679 }
	

lineedit-password-mask-delay*

The QLineEdit password mask delay in milliseconds before lineedit-password-character is applied to visible character.

若此特性未指定，默认为当前样式指定值对于 SH_LineEdit_PasswordMaskDelay 样式提示。

Available since Qt 5.4.

范例：

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

margin

The widget's margins. Equivalent to specifying margin-top , margin-right , margin-bottom ，和 margin-left .

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSplitter , QTextEdit ，和 QToolTip .

若此特性未指定，默认为 0 .

范例：

QLineEdit { margin: 2px }
	

另请参阅 padding , spacing ，和 Box 模型 .

margin-top

Widget 上边距。

margin-right

Widget 右边距。

margin-bottom

Widget 下边距。

margin-left

Widget 左边距。

max-height

Widget 或子控件的最大高度。

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSizeGrip , QSpinBox , QSplitter , QStatusBar , QTextEdit ，和 QToolTip .

The value is relative to the contents rect in the Box 模型 .

范例：

QSpinBox { max-height: 24px }
	

另请参阅 max-width .

max-width

Widget 或子控件的最大宽度。

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSizeGrip , QSpinBox , QSplitter , QStatusBar , QTextEdit ，和 QToolTip .

The value is relative to the contents rect in the Box 模型 .

范例：

QComboBox { max-width: 72px }
	

另请参阅 max-height .

messagebox-text-interaction-flags*

The interaction behavior for text in a message box. Possible values are based on Qt::TextInteractionFlags .

若此特性未指定，默认为当前样式指定值对于 SH_MessageBox_TextInteractionFlags 样式提示。

范例：

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

min-height

Widget 或子控件的最小高度。

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSizeGrip , QSpinBox , QSplitter , QStatusBar , QTextEdit , QToolButton ，和 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 模型 .

范例：

QComboBox { min-height: 24px }
	

注意： Setting this property might allow widgets to shrink smaller than the space required for the contents.

另请参阅 min-width .

min-width

Widget 或子控件的最小宽度。

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSizeGrip , QSpinBox , QSplitter , QStatusBar , QTextEdit , QToolButton ，和 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 模型 .

范例：

QComboBox { min-width: 72px }
	

注意： Setting this property might allow widgets to shrink smaller than the space required for the contents.

另请参阅 min-height .

opacity*

The opacity for a widget. Possible values are from 0 (transparent) to 255 (opaque). For the moment, this is only supported for tooltips .

若此特性未指定，默认为当前样式指定值对于 SH_ToolTipLabel_Opacity 样式提示。

范例：

QToolTip { opacity: 223 }
	

outline

围绕对象边框绘制的轮廓。

outline-color

轮廓的颜色。另请参阅 border-color

outline-offset

从 Widget 边框起的轮廓偏移。

outline-style

指定用于绘制轮廓的模式。另请参阅 border-style

outline-radius

Adds rounded corners to the outline.

outline-bottom-left-radius

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

outline-bottom-right-radius

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

outline-top-left-radius

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

outline-top-right-radius

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

padding

The widget's padding. Equivalent to specifying padding-top , padding-right , padding-bottom ，和 padding-left .

此特性的支持通过 QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSplitter , QTextEdit ，和 QToolTip .

若此特性未指定，默认为 0 .

范例：

QLineEdit { padding: 3px }
	

另请参阅 margin , spacing ，和 Box 模型 .

padding-top

Widget 的顶部铺垫。

padding-right

Widget 的右侧铺垫。

padding-bottom

Widget 的底部铺垫。

padding-left

Widget 的左侧铺垫。

paint-alternating-row-colors-for-empty-area

是否 QTreeView 描绘用于空区域 (即：不存在项的区域) 的交替行颜色

placeholder-text-color*

用于文本编辑 Widget 的占位符文本的颜色。

若此特性未设置，将默认值设为调色板的 PlaceholderText 角色。

范例：

QLineEdit { placeholder-text-color: #800000ff } /* semi-transparent blue */
	

从 6.5 起可用。

位置

是否偏移指定使用 left , right , top ，和 bottom 是相对 (或绝对) 坐标。

若此特性未指定，默认为 relative .

right

若 position is relative (the default), moves a subcontrol by a certain offset to the left; specifying right: x is then equivalent to specifying left: -x .

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

范例：

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

另请参阅 left , top ，和 bottom .

selection-background-color*

选中文本 (或项) 的背景。

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

若此特性未设置，将默认值设为调色板的 Highlight 角色。

范例：

QTextEdit { selection-background-color: darkblue }
	

另请参阅 selection-color and background .

selection-color*

选中文本 (或项) 的前景。

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

若此特性未设置，将默认值设为调色板的 HighlightedText 角色。

范例：

QTextEdit { selection-color: white }
	

另请参阅 selection-background-color and color .

show-decoration-selected*

Controls whether selections in a QListView cover the entire row or just the extent of the text.

若此特性未指定，默认为当前样式指定值对于 SH_ItemView_ShowDecorationSelected 样式提示。

范例：

* { show-decoration-selected: 1 }
	

spacing*

Internal spacing in the widget.

此特性的支持通过 QCheckBox , checkable QGroupBox es, QMenuBar ，和 QRadioButton .

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

范例：

QMenuBar { spacing: 10 }
	

另请参阅 padding and margin .

subcontrol-origin*

The origin rectangle of the subcontrol within the parent element.

如果此特性未指定，默认为 padding .

范例：

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

另请参阅 subcontrol-position .

subcontrol-position*

The alignment of the subcontrol within the origin rectangle specified by subcontrol-origin .

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

范例：

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

另请参阅 subcontrol-origin .

titlebar-show-tooltips-on-buttons

Whether tool tips are shown on window title bar buttons.

widget-animation-duration*

How much an animation should last (in milliseconds). A value equal to zero means that the animations will be disabled.

若此特性未指定，默认为当前样式指定值对于 SH_Widget_Animation_Duration 样式提示。

Available since Qt 5.10.

范例：

* { widget-animation-duration: 100 }
	

text-align

The alignment of text and icon within the contents of the widget.

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

范例：

QPushButton {
    text-align: left;
}
	

此特性目前仅支持通过 QPushButton and QProgressBar .

text-decoration

Additional text effects.

top

若 position is relative (the default), moves a subcontrol by a certain offset down.

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

若此特性未指定，默认为 0 .

范例：

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

另请参阅 left , right ，和 bottom .

width

The width of a subcontrol (or a widget in some cases).

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

警告： 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.

范例：

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

另请参阅 height .

-qt-background-role

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

-qt-style-features

The list of CSS properties that you want to apply Qt-specific styles on.

注意： The list can only include properties that are not pixmap-based.

图标列表

Icons used in Qt can be customized using the following properties. Each of the properties listed in this section have the type 图标 .

Note that for icons to appear in buttons in a QDialogButtonBox , you need to set the dialogbuttonbox-buttons-have-icons property to true. Also, to customize the size of the icons, use the icon-size property.

特性类型列表

下表汇总了不同特性类型的句法和含义。

QTextEdit { background-position: bottom center }
				

QDialog { etch-disabled-text: 1 }
			

/* red red red red */
QLabel { border-color: red }
/* red blue red blue */
QLabel { border-color: red blue }
/* red blue green blue */
QLabel { border-color: red blue green }
/* red blue green yellow */
QLabel { border-color: red blue green yellow }
		

/* 1px 1px 1px 1px */
QLabel { border-width: 1px }
/* 1px 2px 1px 2px */
QLabel { border-width: 1px 2px }
/* 1px 2px 3px 2px */
QLabel { border-width: 1px 2px 3px }
/* 1px 2px 3px 4px */
QLabel { border-width: 1px 2px 3px 4px }
	

/* opaque red */
QLabel { border-color: red }
/* opaque red */
QLabel { border-color: #FF0000 }
/* 75% opaque red */
QLabel { border-color: rgba(255, 0, 0, 75%) }
/* opaque red */
QLabel { border-color: rgb(255, 0, 0) }
/* opaque red */
QLabel { border-color: rgb(100%, 0%, 0%) }
/* opaque yellow */
QLabel { border-color: hsv(60, 100%, 100%) }
/* 75% blue */
QLabel { border-color: hsva(240, 255, 255, 75%) }
/* opaque yellow */
QLabel { border-color: hsl(60, 100%, 50%) }
/* 75% blue */
QLabel { border-color: hsla(240, 255, 50%, 75%) }

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

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

QPushButton { color: palette(dark); }

伪状态列表

支持下列伪状态：

子控件列表

下列子控件可用：

见 定制 QPushButton 的菜单指示器子控件 有关如何定制子控件的范例。

内容

• 可样式化 Widget 列表

• 特性列表

• accent-color

• alternate-background-color

• background

• background-color

• background-image

• background-repeat

• background-position

• background-attachment

• background-clip

• background-origin

• border

• border-top

• border-right

• border-bottom

• border-left

• border-color

• border-top-color

• border-right-color

• border-bottom-color

• border-left-color

• border-image

• border-radius

• border-top-left-radius

• border-top-right-radius

• border-bottom-right-radius

• border-bottom-left-radius

• border-style

• border-top-style

• border-right-style

• border-bottom-style

• border-left-style

• border-width

• border-top-width

• border-right-width

• border-bottom-width

• border-left-width

• bottom

• button-layout

• color

• dialogbuttonbox-buttons-have-icons

• font

• font-family

• font-size

• font-style

• font-weight

• gridline-color*

• height

• icon

• icon-size

• image*

• image-position

• left

• lineedit-password-character*

• lineedit-password-mask-delay*

• margin

• margin-top

• margin-right

• margin-bottom

• margin-left

• max-height

• max-width

• messagebox-text-interaction-flags*

• min-height

• min-width

• opacity*

• outline

• outline-color

• outline-offset

• outline-style

• outline-radius

• outline-bottom-left-radius

• outline-bottom-right-radius

• outline-top-left-radius

• outline-top-right-radius

• padding

• padding-top

• padding-right

• padding-bottom

• padding-left

• paint-alternating-row-colors-for-empty-area

• placeholder-text-color*

• position

• right

• selection-background-color*

• selection-color*

• show-decoration-selected*

• spacing*

• subcontrol-origin*

• subcontrol-position*

• titlebar-show-tooltips-on-buttons

• widget-animation-duration*

• text-align

• text-decoration

• top

• width

• -qt-background-role

• -qt-style-features

• 图标列表

• 特性类型列表

• 伪状态列表

• 子控件列表