Qt 样式表参考 ¶

QAbstractScrollArea .. _qabstractscrollarea-widget:

支持 box model .

All derivatives of QAbstractScrollArea ，包括 QTextEdit ，和 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.

见 定制 QAbstractScrollArea 范例。

QColumnView .. _qcolumnview-widget:

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.

QDateEdit .. _qdateedit-widget:

见 QSpinBox .

QDialog .. _qdialog-widget:

仅支持 background , background-clip and background-origin 特性。

警告

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

QDockWidget .. _qdockwidget-widget:

Supports styling of the title bar and the title bar buttons when docked.

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 分别。

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

注意

Use QMainWindow::separator to style the resize handle.

警告

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

见 定制 QDockWidget 范例。

QFrame .. _qframe-widget:

支持 box model .

Since 4.3, setting a stylesheet on a QLabel automatically sets the frameStyle 特性到 StyledPanel .

见 定制 QFrame 范例。

QHeaderView .. _qheaderview-widget:

支持 box model . The sections of the header view are styled using the ::section sub control. The section Sub-control supports the :middle , :first , :last , :only-one , :next-selected , :previous-selected , :selected ，和 :checked pseudo states.

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

见 定制 QHeaderView 范例。

QLineEdit .. _qlineedit-widget:

支持 box model .

The color and background of the selected item is styled using selection-color and selection-background-color 分别。

The password character can be styled using the lineedit-password-character 特性。

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

见 定制 QLineEdit 范例。

QListWidget .. _qlistwidget-widget:

见 QListView .

QMenu .. _qmenu-widget:

支持 box model .

Individual items are styled using the ::item subcontrol. In addition to the usually supported pseudo states, item subcontrol supports the :selected , :default , :exclusive 和 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 .

见 定制 QMenu 范例。

QMessageBox .. _qmessagebox-widget:

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

QPushButton .. _qpushbutton-widget:

支持 box model . Supports the :default , :flat , :checked pseudo states.

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.

警告

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

见 定制 QPushButton 范例。

QScrollBar .. _qscrollbar-widget:

支持 box model . The Contents rectangle of the widget is considered to be the groove over which the slider moves. The extent of the QScrollBar (i.e the width or the height depending on the orientation) is set using the width or height property respectively. To determine the orientation, use the :horizontal 和 :vertical pseudo states.

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.

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

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

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

见 定制 QScrollBar 范例。

QSlider .. _qslider-widget:

支持 box model . For horizontal slides, the min-width and height properties must be provided. For vertical sliders, the min-height and width properties must be provided.

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.

见 定制 QSlider 范例。

QSplitter .. _qsplitter-widget:

支持 box model . The handle of the splitter is styled using the ::handle subcontrol.

见 定制 QSplitter 范例。

QTabBar .. _qtabbar-widget:

Individual tabs may be styled using the ::tab subcontrol. Close buttons using the ::close-button The tabs support the :only-one , :first , :last , :middle , :previous–selected , :next-selected , :selected pseudo states.

: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 特性。

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

见 Customizing QTabBar 范例。

QTableView .. _qtableview-widget:

支持 box model 。当 alternating row colors is enabled, the alternating colors can be styled using the alternate-background-color 特性。

The color and background of the selected item is styled using selection-color and selection-background-color 分别。

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

警告

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 特性。

见 QAbsractScrollArea to style scrollable backgrounds.

见 Customzing QTableView 范例。

QTextEdit .. _qtextedit-widget:

支持 box model .

The color and background of selected text is styled using selection-color and selection-background-color 分别。

见 QAbsractScrollArea to style scrollable backgrounds.

QToolBar .. _qtoolbar-widget:

支持 box model .

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

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

见 定制 QToolBar 范例。

QToolBox .. _qtoolbox-widget:

支持 box model .

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.

QTreeView .. _qtreeview-widget:

支持 box model 。当 alternating row colors is enabled, the alternating colors can be styled using the alternate-background-color 特性。

The color and background of the selected item is styled using selection-color and selection-background-color 分别。

The selection behavior is controlled by the show-decoration-selected 特性。

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.

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

见 QAbsractScrollArea to style scrollable backgrounds.

见 定制 QTreeView for an example to style the branches.

QWidget .. _qwidget-widget:

仅支持 background , background-clip and background-origin 特性。

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

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.

警告

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

``image-position`` .. _image-position-prop:

alignment

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

``lineedit-password-character*`` .. _lineedit-password-character-prop:

Number

QLineEdit password character as a Unicode number.

If this property is not specified, it defaults to the value specified by the current style for the SH_LineEdit_PasswordCharacter 样式提示。

范例：

* { lineedit-password-character: 9679 }
																	

``margin`` .. _margin-prop:

Box Lengths

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

This property is supported by 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 { margin: 2px }
																	

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

margin-right

Length

The widget’s right margin.

margin-left

Length

The widget’s left margin.

``max-width`` .. _max-width-prop:

Length

The widget’s or a subcontrol’s maximum width.

This property is supported by 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 model .

范例：

QComboBox { max-width: 72px }
																	

另请参阅 max-height .

``min-height`` .. _min-height-prop:

Length

The widget’s or a subcontrol’s minimum height.

This property is supported by QAbstractItemView 子类， QAbstractSpinBox 子类， QCheckBox , QComboBox , QFrame , QGroupBox , QLabel , QLineEdit , QMenu , QMenuBar , QPushButton , QRadioButton , QSizeGrip , QSpinBox , QSplitter , QStatusBar , QTextEdit ，和 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 .

范例：

QComboBox { min-height: 24px }
																	

另请参阅 min-width .

``opacity*`` .. _opacity-prop:

Number

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

If this property is not specified, it defaults to the value specified by the current style for the SH_ToolTipLabel_Opacity 样式提示。

范例：

QToolTip { opacity: 223 }
																	

outline-color

Color

The color of the outline. See also border-color

outline-style

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

outline-bottom-left-radius

Radius

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

outline-top-left-radius

Radius

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

``padding`` .. _padding-prop:

Box Lengths

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

This property is supported by 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 { padding: 3px }
																	

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

padding-right

Length

The widget’s right padding.

padding-left

Length

The widget’s left padding.

``position`` .. _position-prop:

relative | absolute

Whether offsets specified using left , right , top ，和 bottom are relative or absolute coordinates.

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

``selection-background-color*`` .. _selection-background-color-prop:

Brush

The background of selected text or items.

This property is supported by all widgets that respect the 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.

范例：

QTextEdit { selection-background-color: darkblue }
																	

另请参阅 selection-color and background .

``show-decoration-selected*`` .. _show-decoration-selected-prop:

布尔

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

If this property is not specified, it defaults to the value specified by the current style for the SH_ItemView_ShowDecorationSelected 样式提示。

范例：

* { show-decoration-selected: 1 }
																	

``subcontrol-origin*`` .. _subcontrol-origin-prop:

Origin

The origin rectangle of the subcontrol within the parent element.

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

范例：

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

另请参阅 subcontrol-position .

``titlebar-show-tooltips-on-buttons`` } .. _titlebar-show-tooltips-on-buttons-prop:

bool

Whether tool tips are shown on window title bar buttons.

``text-align`` .. _text-align-prop:

Alignment

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

This property is currently supported only by QPushButton and QProgressBar .

``top`` .. _top-prop:

Length

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

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

范例：

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

另请参阅 left , right ，和 bottom .

-qt-background-role

PaletteRole

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

backward-icon

SP_ArrowBack

computer-icon

SP_ComputerIcon

dialog-apply-icon

SP_DialogApplyButton

dialog-close-icon

SP_DialogCloseButton

dialog-help-icon

SP_DialogHelpButton

dialog-ok-icon

SP_DialogOkButton

dialog-reset-icon

SP_DialogResetButton

dialog-yes-icon

SP_DialogYesButton

directory-icon

SP_DirIcon

directory-open-icon

SP_DirOpenIcon

downarrow-icon

SP_ArrowDown

file-icon

SP_FileIcon

filedialog-contentsview-icon

SP_FileDialogContentsView

filedialog-end-icon

SP_FileDialogEnd

filedialog-listview-icon

SP_FileDialogListView

filedialog-parent-directory-icon

SP_FileDialogToParent

floppy-icon

SP_DriveFDIcon

harddisk-icon

SP_DriveHDIcon

leftarrow-icon

SP_ArrowLeft

messagebox-information-icon

SP_MessageBoxInformation

messagebox-warning-icon

SP_MessageBoxWarning

rightarrow-icon

SP_ArrowRight

titlebar-maximize-icon

SP_TitleBarMaxButton

titlebar-minimize-icon

SP_TitleBarMinButton

titlebar-shade-icon

SP_TitleBarShadeButton

trash-icon

SP_TrashIcon

:active .. _active:

此状态被设置，当 Widget 在活动窗口中时。

:alternate .. _alternate-ps:

This state is set for every alternate row whe painting the row of a QAbstractItemView when alternatingRowColors() is set to true.

:checked .. _checked-ps:

The item is checked. For example, the checked state of QAbstractButton .

:closed .. _closed-ps:

The item is in the closed state. For example, an non-expanded item in a QTreeView

:disabled .. _disabled-ps:

项是 disabled .

:edit-focus .. _edit-focus-ps:

The item has edit focus (See State_HasEditFocus ). This state is available only for Qt Extended applications.

:exclusive .. _exclusive-ps:

The item is part of an exclusive item group. For example, a menu item in a exclusive QActionGroup .

:flat .. _flat-ps:

The item is flat. For example, a flat QPushButton .

:focus .. _focus-ps:

项有 input focus .

:has-siblings .. _has-siblings-ps:

The item has siblings. For example, an item in a QTreeView that siblings.

:hover .. _hover-ps:

The mouse is hovering over the item.

:last .. _last-ps:

The item is the last (in a list). For example, the last tab in a QTabBar .

:maximized .. _maximized-ps:

The item is maximized. For example, a maximized QMdiSubWindow .

:minimized .. _minimized-ps:

The item is minimized. For example, a minimized QMdiSubWindow .

:no-frame .. _no-frame-ps:

The item has no frame. For example, a frameless QSpinBox or QLineEdit .

:off .. _off-ps:

For items that can be toggled, this applies to items in the “off” state.

:only-one .. _only-one-ps:

The item is the only one (in a list). For example, a lone tab in a QTabBar .

:next-selected .. _next-selected-ps:

The next item (in a list) is selected. For example, the selected tab of a QTabBar is next to this item.

:previous-selected .. _previous-selected-ps:

The previous item (in a list) is selected. For example, a tab in a QTabBar that is next to the selected tab.

:right .. _right-ps:

The item is positioned at the right. For example, a QTabBar that has its tabs positioned at the right.

:top .. _top-ps:

The item is positioned at the top. For example, a QTabBar that has its tabs positioned at the top.

:vertical .. _vertical-ps:

项有垂直取向。

::add-line .. _add-line-sub:

The button to add a line of a QScrollBar .

::branch .. _branch-sub:

The branch indicator of a QTreeView .

::close-button .. _close-button-sub:

The close button of a QDockWidget or tabs of QTabBar

::down-arrow .. _down-arrow-sub:

The down arrow of a QComboBox , QHeaderView (sort indicator), QScrollBar or QSpinBox .

::drop-down .. _drop-down-sub:

The drop-down button of a QComboBox .

::groove .. _groove-sub:

The groove of a QSlider .

::handle .. _handle-sub:

The handle (slider) of a QScrollBar ， QSplitter ，或 QSlider .

::item .. _item-sub:

An item of a QAbstractItemView ， QMenuBar ， QMenu ，或 QStatusBar .

::left-corner .. _left-corner-sub:

The left corner of a QTabWidget . For example, this control can be used to control position the left corner widget in a QTabWidget .

::menu-button .. _menu-button-sub:

The menu button of a QToolButton .

::right-arrow .. _right-arrow-sub:

The right arrow of a QMenu 或 QScrollBar .

::right-corner .. _right-corner-sub:

The right corner of a QTabWidget . For example, this control can be used to control the position the right corner widget in a QTabWidget .

::section .. _section-sub:

The section of a QHeaderView .

::sub-line .. _sub-line-sub:

The button to subtract a line of a QScrollBar .

::tab .. _tab-sub:

The tab of a QTabBar or QToolBox .

::tear .. _tear-sub:

The tear indicator of a QTabBar .

::text .. _text-ps:

The text of a QAbstractItemView .

::up-arrow .. _up-arrow-sub:

The up arrow of a QHeaderView (sort indicator), QScrollBar 或 QSpinBox .