stylesheet-reference.qdoc

Go to the documentation of this file.

// Copyright (C) 2019 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
 
/*!
    \page stylesheet-reference.html
    \previouspage Customizing Qt Widgets Using Style Sheets
    \nextpage Qt Style Sheets Examples
    \title Qt Style Sheets Reference
 
    Qt Style Sheets support various properties, pseudo-states, and
    subcontrols that make it possible to customize the look of
    widgets.
 
    \section1 List of Stylable Widgets
 
    The following table lists the Qt widgets that can be customized
    using style sheets:
 
    \table 100%
    \header
        \li Widget
        \li How to Style
 
    \row
        \li QAbstractScrollArea \target qabstractscrollarea-widget
        \li Supports the \l{box model}.
        \br
        \br
           All derivatives of QAbstractScrollArea, including QTextEdit,
           and QAbstractItemView (all item view classes), support
           scrollable backgrounds using
           \l{Qt Style Sheets Reference#background-attachment-prop}
           {background-attachment}. Setting the background-attachment to
           \c{fixed} provides a background-image that does not scroll with the
           viewport. Setting the background-attachment to \c{scroll}, scrolls
           the background-image when the scroll bars move.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QAbstractScrollArea}
           {Customizing QAbstractScrollArea} for an example.
 
    \row
        \li QCheckBox \target qcheckbox-widget
        \li Supports the \l{box model}. The check indicator can be
           styled using the \l{#indicator-sub}{::indicator}
           subcontrol. By default, the indicator is placed in the Top
           Left corner of the Contents rectangle of the widget.
        \br
        \br
           The \l{#spacing-prop}{spacing} property
           specifies the spacing between the check indicator and
           the text.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QCheckBox}
           {Customizing QCheckBox} for an example.
 
    \row
        \li QColumnView \target qcolumnview-widget
        \li The grip can be styled by using the \l{image-prop}{image} property.
        \br
        \br
           The arrow indicators can by styled using the
           \l{left-arrow-sub}{::left-arrow} subcontrol and the
           \l{right-arrow-sub}{::right-arrow} subcontrol.
 
    \row
        \li QComboBox \target qcombobox-widget
        \li The frame around the combobox can be styled using the
           \l{box model}.
        \br
        \br
           The drop-down button can be styled using
           the \l{#drop-down-sub}{::drop-down} subcontrol. By default, the
           drop-down button is placed in the top right corner of the padding
           rectangle of the widget.
        \br
        \br
           The arrow mark inside the drop-down button
           can be styled using the \l{#down-arrow-sub}{::down-arrow}
           subcontrol. By default, the arrow is placed in the center of the
           contents rectangle of the drop-down subcontrol.
        \br
        \br
           The color of the placeholder text can be set using the
           \l{#placeholder-text-color-prop}{placeholder-text-color} property.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QComboBox}{Customizing QComboBox}
           for an example.
 
    \row
        \li QDateEdit \target qdateedit-widget
        \li See \l{#qspinbox-widget}{QSpinBox}.
 
    \row
        \li QDateTimeEdit \target qdatetimeedit-widget
        \li See \l{#qspinbox-widget}{QSpinBox}.
 
    \row
        \li QDialog \target qdialog-widget
        \li Supports only the \l{Qt Style Sheets Reference#background-prop}{background},
           \l{#background-clip-prop}{background-clip} and
           \l{#background-origin-prop}{background-origin} properties.
 
           \warning Make sure you define the Q_OBJECT macro for your custom
           widget.
 
    \row
        \li QDialogButtonBox \target qdialogbuttonbox-widget
        \li The layout of buttons can be altered using the
           \l{#button-layout-prop}{button-layout} property.
 
    \row
        \li QDockWidget \target qdockwidget-widget
        \li Supports styling of the title bar and the title bar buttons when docked.
        \br
        \br
        The dock widget border can be styled using the \l{#border-prop}{border}
        property. The \l{#title-sub}{::title} subcontrol can be used to customize
        the title bar. The close and float buttons are positioned with respect
        to the \l{title-sub}{::title} subcontrol using the
        \l{#close-button-sub}{::close-button} and
        \l{#float-button-sub}{::float-button} respectively.
        \br
        \br
        When the title bar is vertical, the \l{#vertical-ps}{:vertical} pseudo
        class is set. In addition, depending on QDockWidget::DockWidgetFeature,
        the \l{#closable-ps}{:closable}, \l{#floatable-ps}{:floatable} and
        \l{#movable-ps}{: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 \l{Qt Style Sheets Examples#Customizing QDockWidget}
        {Customizing QDockWidget} for an example.
 
    \row
        \li QDoubleSpinBox \target qdoublespinbox-widget
        \li See \l{#qspinbox-widget}{QSpinBox}.
 
    \row
        \li QFrame \target qframe-widget
        \li Supports the \l{box model}.
        \br
        \br
           Since 4.3, setting a stylesheet on a QLabel automatically
           sets the QFrame::frameStyle property to QFrame::StyledPanel.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QFrame}{Customizing QFrame}
           for an example.
 
    \row
        \li QGroupBox \target qgroupbox-widget
        \li Supports the \l{box model}.
        \br
        \br
           The title can be styled using the
           \l{#title-sub}{::title} subcontrol. By default, the title is placed
           depending on QGroupBox::textAlignment.
        \br
        \br
           In the case of a checkable QGroupBox, the title includes the
           check indicator. The indicator is styled using the
           \l{#indicator-sub}{::indicator} subcontrol. The
           \l{#spacing-prop}{spacing} property can be used to control
           the spacing between the text and indicator.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QGroupBox}{Customizing QGroupBox}
           for an example.
 
    \row
        \li QHeaderView \target qheaderview-widget
        \li Supports the \l{box model}.
        \br
        \br
           The sections of the header view are
           styled using the \l{#section-sub}{::section} sub control. The
           \c{section} Sub-control supports the \l{#middle-ps}{:middle},
           \l{#first-ps}{:first}, \l{#last-ps}{:last},
           \l{#only-one-ps}{:only-one}, \l{#next-selected-ps}{:next-selected},
           \l{#previous-selected-ps}{:previous-selected},
           \l{#selected-ps}{:selected},
           and \l{#checked-ps}{:checked} pseudo states.
        \br
        \br
           The sort indicator can be styled using the
           \l{#up-arrow-sub}{::up-arrow} and the
           \l{#down-arrow-sub}{::down-arrow} Sub-control.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QHeaderView}{Customizing QHeaderView}
           for an example.
 
    \row
        \li QLabel \target qlabel-widget
        \li Supports the \l{box model}. Does not support the
           \l{#hover-ps}{:hover} pseudo-state.
        \br
        \br
           Since 4.3, setting a stylesheet on a QLabel automatically
           sets the QFrame::frameStyle property to QFrame::StyledPanel.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QFrame}{Customizing QFrame} for an
           example (a QLabel derives from QFrame).
 
    \row
        \li QLineEdit \target qlineedit-widget
        \li Supports the \l{box model}.
        \br
        \br
           The color and background of the selected item is styled using
           \l{#selection-color-prop}{selection-color} and
           \l{#selection-background-color-prop}{selection-background-color}
           respectively.
        \br
        \br
           The color of the placeholder text can be set using the
           \l{#placeholder-text-color-prop}{placeholder-text-color} property.
        \br
        \br
           The password character can be styled using the
           \l{#lineedit-password-character-prop}{lineedit-password-character}
           property.
        \br
        \br
           The password mask delay can be changed using the
           \l{#lineedit-password-mask-delay-prop}{lineedit-password-mask-delay}
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QLineEdit}{Customizing QLineEdit}
           for an example.
 
    \row
        \li QListView \target qlistview-widget
        \li Supports the \l{box model}.
        \br
        \br
           When
           \l{QAbstractItemView::alternatingRowColors}{alternating row colors}
           is enabled, the alternating colors can be styled using the
           \l{#alternate-background-color-prop}{alternate-background-color}
           property.
        \br
        \br
           The color and background of the selected item is styled using
           \l{#selection-color-prop}{selection-color} and
           \l{#selection-background-color-prop}{selection-background-color}
           respectively.
        \br
        \br
           The selection behavior is controlled by the
           \l{#show-decoration-selected-prop}{show-decoration-selected} property.
        \br
        \br
           Use the \l{#item-sub}{::item} subcontrol for more fine grained
           control over the items in the QListView.
        \br
        \br
           See \l{qabstractscrollarea-widget}{QAbstractScrollArea} to
           style scrollable backgrounds.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QListView}
           {Customzing QListView} for an example.
 
    \row
        \li QListWidget \target qlistwidget-widget
        \li See \l{#qlistview-widget}{QListView}.
 
    \row
        \li QMainWindow \target qmainwindow-widget
        \li Supports styling of the separator.
        \br
        \br
           The separator in a QMainWindow when using QDockWidget is styled
           using the \l{#separator-sub}{::separator} subcontrol.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QMainWindow}{Customizing QMainWindow}
           for an example.
 
    \row
        \li QMenu \target qmenu-widget
        \li Supports the \l{box model}.
        \br
        \br
           Individual items are styled using the \l{#item-sub}{::item}
           subcontrol. In addition to the usually supported pseudo states,
           \c{item} subcontrol supports the
           \l{#selected-ps}{:selected}, \l{#default-ps}{:default},
           \l{#exclusive-ps}{:exclusive} and the
           \l{#non-exclusive-ps}{non-exclusive} pseudo states.
        \br
        \br
           The indicator of checkable menu items is styled using the
           \l{#indicator-sub}{::indicator} subcontrol.
        \br
        \br
           The separator is styled using the \l{#separator-sub}{::separator}
           subcontrol.
        \br
        \br
           For items with a sub menu, the arrow marks are styled using the
           \l{right-arrow-sub}{right-arrow} and
           \l{left-arrow-sub}{left-arrow}.
        \br
        \br
            The scroller is styled using the \l{#scroller-sub}{::scroller}.
        \br
        \br
            The tear-off is styled using the \l{#tearoff-sub}{::tearoff}.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QMenu}{Customizing QMenu}
           for an example.
 
    \row
        \li QMenuBar \target qmenubar-widget
        \li Supports the \l{box model}.
        \br
        \br
           The \l{#spacing-prop}{spacing}
           property specifies the spacing between menu items.
           Individual items are styled using the \l{#item-sub}{::item}
           subcontrol.
 
           \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 \l{Qt Style Sheets Examples#Customizing QMenuBar}{Customizing QMenuBar}
           for an example.
 
    \row
        \li QMessageBox \target qmessagebox-widget
        \li The \l{#messagebox-text-interaction-flags-prop}
           {messagebox-text-interaction-flags} property can be used to alter
           the interaction with text in the message box.
 
    \row
        \li QProgressBar \target qprogressbar-widget
        \li Supports the \l{box model}.
        \br
        \br
           The chunks of the progress bar
           can be styled using the \l{#chunk-sub}{::chunk} subcontrol.
           The chunk is displayed on the Contents rectangle of the widget.
        \br
        \br
           If the progress bar displays text, use the \l{text-align-prop}{text-align}
           property to position the text.
        \br
        \br
           Indeterminate progress bars have the
           \l{#indeterminate-ps}{:indeterminate} pseudo state set.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QProgressBar}{Customizing QProgressBar}
           for an example.
 
    \row
        \li QPushButton \target qpushbutton-widget
        \li Supports the \l{box model}.
        \br
        \br
           Supports the \l{#default-ps}{:default},
           \l{#flat-ps}{:flat}, \l{#checked-ps}{:checked} pseudo states.
        \br
        \br
           Since 5.15, the \l{#icon-prop}{icon} property can be set to
           override the button icon.
        \br
        \br
           For QPushButton with a menu, the menu indicator is styled
           using the \l{#menu-indicator-sub}{::menu-indicator}
           subcontrol. Appearance of checkable push buttons can be
           customized using the \l{#open-ps}{:open} and
           \l{#closed-ps}{: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,
 
           \snippet code/doc_src_stylesheet.qdoc 30
 
           See \l{Qt Style Sheets Examples#Customizing QPushButton}{Customizing QPushButton}
           for an example.
 
    \row
        \li QRadioButton \target qradiobutton-widget
        \li Supports the \l{box model}.
        \br
        \br
           The check indicator can be
           styled using the \l{#indicator-sub}{::indicator}
           subcontrol. By default, the indicator is placed in the Top
           Left corner of the Contents rectangle of the widget.
        \br
        \br
           The \l{#spacing-prop}{spacing} property
           specifies the spacing between the check indicator and
           the text.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QRadioButton}
           {Customizing QRadioButton} for an example.
 
    \row
        \li QScrollBar \target qscrollbar-widget
        \li Supports the \l{box model}.
        \br
        \br
           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 \l{#width-prop}{width} or \l{#height-prop}{height} property
           respectively. To determine the orientation, use the
           \l{#horizontal-ps}{:horizontal} and the \l{vertical-ps}{:vertical}
           pseudo states.
        \br
        \br
           The slider can be styled using the \l{#handle-sub}{::handle} subcontrol.
           Setting the \l{#min-width-prop}{min-width} or \l{#min-height-prop}{min-height}
           provides size constraints for the slider depending on the orientation.
        \br
        \br
           The \l{add-line-sub}{::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 \l{#right-arrow-sub}{::right-arrow} or
           \l{#down-arrow-sub}{::down-arrow}. By default, the arrows are placed in
           the center of the Contents rectangle of the add-line subcontrol.
        \br
        \br
           The \l{sub-line-sub}{::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 \l{#left-arrow-sub}{::left-arrow} or
           \l{#up-arrow-sub}{::up-arrow}. By default, the arrows are placed in
           the center of the Contents rectangle of the sub-line subcontrol.
        \br
        \br
           The \l{sub-page-sub}{::sub-page} subcontrol can be used to style the
           region of the slider that subtracts a page. The \l{add-page-sub}{::add-page}
           subcontrol can be used to style the region of the slider that adds a page.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QScrollBar}{Customizing QScrollBar}
           for an example.
 
    \row
        \li QSizeGrip \target qsizegrip-widget
        \li Supports the \l{#width-prop}{width},
           \l{#height-prop}{height}, and \l{#image-prop}{image}
           properties.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QSizeGrip}{Customizing QSizeGrip}
           for an example.
 
    \row
        \li QSlider \target qslider-widget
        \li Supports the \l{box model}.
        \br
        \br
           For horizontal slides, the
           \l{min-width-prop}{min-width} and \l{height-prop}{height}
           properties must be provided. For vertical sliders, the
           \l{min-height-prop}{min-height} and \l{width-prop}{width}
           properties must be provided.
        \br
        \br
           The groove of the slider is styled
           using the \l{#groove-sub}{::groove}. The groove is
           positioned by default in the Contents rectangle of the widget.
           The thumb of the slider is styled using \l{#handle-sub}{::handle}
           subcontrol. The subcontrol moves in the Contents rectangle of
           the groove subcontrol.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QSlider}{Customizing QSlider}
           for an example.
 
    \row
        \li QSpinBox \target qspinbox-widget
        \li The frame of the spin box can be styled using the \l{box
           model}.
        \br
        \br
           The up button and arrow can be styled using the
           \l{#up-button-sub}{::up-button} and
           \l{#up-arrow-sub}{::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.
        \br
        \br
           The down button and arrow can be styled using the
           \l{#down-button-sub}{::down-button} and
           \l{#down-arrow-sub}{::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.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QSpinBox}{Customizing QSpinBox}
           for an example.
 
    \row
        \li QSplitter \target qsplitter-widget
        \li Supports the \l{box model}. The handle of the splitter
           is styled using the \l{#handle-sub}{::handle} subcontrol.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QSplitter}{Customizing QSplitter}
           for an example.
 
    \row
        \li QStatusBar \target qstatusbar-widget
        \li Supports only the \l{Qt Style Sheets Reference#background-prop}
           {background} property.
           The frame for individual items can be style using the
           \l{#item-sub}{::item} subcontrol.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QStatusBar}{Customizing QStatusBar}
           for an example.
 
    \row
        \li QTabBar \target qtabbar-widget
        \li Individual tabs may be styled using the \l{#tab-sub}{::tab}  subcontrol.
           Close buttons using the \l{#close-button-sub}{::close-button}.
           The tabs support the
           \l{#only-one-ps}{:only-one}, \l{#first-ps}{:first},
           \l{#last-ps}{:last}, \l{#middle-ps}{:middle},
           \l{#previous-selected-ps}{:previous--selected},
           \l{#next-selected-ps}{:next-selected},
           \l{#selected-ps}{:selected} pseudo states.
        \br
        \br
            The \l{#top-ps}{:top}, \l{#left-ps}{:left}, \l{#right-ps}{:right},
            \l{#bottom-ps}{:bottom} pseudo states depending on the orientation
            of the tabs.
        \br
        \br
            Overlapping tabs for the selected state are created by using
            negative margins or using the \c{absolute} position scheme.
        \br
        \br
            The tear indicator of the QTabBar is styled using the
            \l{#tear-sub}{::tear} subcontrol.
        \br
        \br
            QTabBar used two QToolButtons for its scrollers that can be styled
            using the \c{QTabBar QToolButton} selector. To specify the width
            of the scroll button use the \l{#scroller-sub}{::scroller}
            subcontrol.
        \br
        \br
            The alignment of the tabs within the QTabBar is styled
            using the \l{#Alignment}{alignment} property.
        \br
        \warning
            To change the position of the QTabBar within a QTabWidget, use the
            \l{#tab-bar-sub}{tab-bar} subcontrol (and set subcontrol-position).
 
           See \l{Qt Style Sheets Examples#Customizing QTabWidget and QTabBar}{Customizing QTabBar}
           for an example.
 
    \row
        \li QTabWidget \target qtabwidget-widget
        \li The frame of the tab widget is styled using the
           \l{#pane-sub}{::pane} subcontrol. The left and right
           corners are styled using the \l{#left-corner-sub}{::left-corner}
           and \l{#right-corner-sub}{::right-corner} respectively.
           The position of the tab bar is controlled using the
           \l{#tab-bar-sub}{::tab-bar} subcontrol.
        \br
        \br
           By default, the subcontrols have positions of a \l QTabWidget in the
           \c windows style. To place the \l QTabBar in the center, set the
           subcontrol-position of the tab-bar subcontrol.
        \br
        \br
            The \l{#top-ps}{:top}, \l{#left-ps}{:left}, \l{#right-ps}{:right},
            \l{#bottom-ps}{:bottom} pseudo states depending on the orientation
            of the tabs.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QTabWidget and QTabBar}
           {Customizing QTabWidget} for an example.
 
    \row
        \li QTableView \target qtableview-widget
        \li Supports the \l{box model}. When
           \l{QAbstractItemView::alternatingRowColors}{alternating row colors}
           is enabled, the alternating colors can be styled using the
           \l{#alternate-background-color-prop}{alternate-background-color}
           property.
        \br
        \br
           The color and background of the selected item is styled using
           \l{#selection-color-prop}{selection-color} and
           \l{#selection-background-color-prop}{selection-background-color}
           respectively.
        \br
        \br
           The corner widget in a QTableView is implemented as a QAbstractButton
           and can be styled using the "QTableView QTableCornerButton::section"
           selector.
        \br
           \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.
 
        \br
           The color of the grid can be specified using the
           \l{#gridline-color-prop}{gridline-color} property.
        \br
        \br
           See \l{qabstractscrollarea-widget}{QAbstractScrollArea} to
           style scrollable backgrounds.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QTableView}
           {Customzing QTableView} for an example.
 
    \row
        \li QTableWidget \target qtablewidget-widget
        \li See \l{#qtableview-widget}{QTableView}.
 
    \row
        \li QTextEdit \target qtextedit-widget
        \li Supports the \l{box model}.
        \br
        \br
           The color and background of selected text is styled using
           \l{#selection-color-prop}{selection-color} and
           \l{#selection-background-color-prop}{selection-background-color}
           respectively.
        \br
        \br
           The color of the placeholder text can be set using the
           \l{#placeholder-text-color-prop}{placeholder-text-color} property.
        \br
        \br
           See \l{qabstractscrollarea-widget}{QAbstractScrollArea} to
           style scrollable backgrounds.
 
    \row
        \li QTimeEdit \target qtimeedit-widget
        \li See \l{#qspinbox-widget}{QSpinBox}.
 
    \row
        \li QToolBar \target qtoolbar-widget
        \li Supports the \l{box model}.
        \br
        \br
           The \l{#top-ps}{:top}, \l{#left-ps}{:left}, \l{#right-ps}{:right},
           \l{#bottom-ps}{:bottom} pseudo states depending on the area in
           which the tool bar is grouped.
        \br
        \br
           The \l{#first-ps}{:first}, \l{#last-ps}{:last}, \l{#middle-ps}{:middle},
           \l{#only-one-ps}{:only-one} pseudo states indicator the position
           of the tool bar within a line group (See
           QStyleOptionToolBar::positionWithinLine).
        \br
        \br
           The separator of a QToolBar is styled using the
           \l{#separator-sub}{::separator} subcontrol.
        \br
        \br
           The handle (to move the toolbar) is styled using the
           \l{#handle-sub}{::handle} subcontrol.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QToolBar}{Customizing QToolBar}
           for an example.
 
    \row
        \li QToolBox \target qtoolbox-widget
        \li Supports the \l{box model}.
     \br
     \br
       The individual tabs can by styled using the
       \l{#tab-sub}{::tab} subcontrol. The tabs support the
       \l{#only-one-ps}{:only-one}, \l{#first-ps}{:first},
       \l{#last-ps}{:last}, \l{#middle-ps}{:middle},
      \l{#previous-selected-ps}{:previous-selected},
       \l{#next-selected-ps}{:next-selected},
       \l{#selected-ps}{:selected} pseudo states.
 
    \row
        \li QToolButton \target qtoolbutton-widget
        \li Supports the \l{box model}.
        \br
        \br
           If the QToolButton has a menu, is
           \l{#menu-indicator-sub}{::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.
        \br
        \br
           If the QToolButton is in QToolButton::MenuButtonPopup mode,
           the \l{#menu-button-sub}{::menu-button} subcontrol is used to draw the
           menu button. \l{#menu-arrow-sub}{::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.
        \br
        \br
           When the QToolButton displays arrows, the \l{#up-arrow-sub}{::up-arrow},
           \l{#down-arrow-sub}{::down-arrow}, \l{#left-arrow-sub}{::left-arrow}
           and \l{#right-arrow-sub}{::right-arrow} subcontrols are used.
        \br
           \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,
 
           \snippet code/doc_src_stylesheet.qdoc 31
 
           See \l{Qt Style Sheets Examples#Customizing QToolButton}{Customizing QToolButton}
           for an example.
 
    \row
        \li QToolTip \target qtooltip-widget
        \li Supports the \l{box model}. The \l{#opacity-prop}{opacity}
           property controls the opacity of the tooltip.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QFrame}{Customizing QFrame}
           for an example (a QToolTip is a QFrame).
 
    \row
        \li QTreeView \target qtreeview-widget
        \li Supports the \l{box model}. When
           \l{QAbstractItemView::alternatingRowColors}{alternating row colors}
           is enabled, the alternating colors can be styled using the
           \l{#alternate-background-color-prop}{alternate-background-color}
           property.
        \br
        \br
           The color and background of the selected item is styled using
           \l{#selection-color-prop}{selection-color} and
           \l{#selection-background-color-prop}{selection-background-color}
           respectively.
        \br
        \br
           The selection behavior is controlled by the
           \l{#show-decoration-selected-prop}{show-decoration-selected} property.
        \br
        \br
           The branches of the tree view can be styled using the
           \l{#branch-sub}{::branch} subcontrol. The
           ::branch Sub-control supports the \l{open-ps}{:open},
           \l{closed-ps}{:closed}, \l{has-siblings-ps}{:has-sibling} and
           \l{has-children-ps}{:has-children} pseudo states.
        \br
        \br
           Use the \l{#item-sub}{::item} subcontrol for more fine grained
           control over the items in the QTreeView.
        \br
        \br
           See \l{qabstractscrollarea-widget}{QAbstractScrollArea} to
           style scrollable backgrounds.
        \br
        \br
           See \l{Qt Style Sheets Examples#Customizing QTreeView}{Customizing QTreeView}
           for an example to style the branches.
 
    \row
        \li QTreeWidget \target qtreewidget-widget
        \li See \l{#qtreeview-widget}{QTreeView}.
 
    \row
        \li QWidget \target qwidget-widget
        \li Supports only the \l{Qt Style Sheets Reference#background-prop}{background},
           \l{#background-clip-prop}{background-clip} and
           \l{#background-origin-prop}{background-origin} properties.
        \br
        \br
           If you subclass from QWidget, you need to provide a paintEvent for your
           custom QWidget as below:
           \snippet code/doc_src_stylesheet.cpp 32
 
           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.
 
    \endtable
 
    \section1 List of Properties
 
    This section lists all the properties supported by Qt Style
    Sheets. Which values can be given to a property depend on the
    \l{List of Property Types}{property's type}. 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:
    \list
    \li \l{#gridline-color*}{gridline-color*}
    \li \l{#image*}{image*}
    \li \l{#lineedit-password-character*}{lineedit-password-character*}
    \li \l{#lineedit-password-mask-delay*}{lineedit-password-mask-delay*}
    \li \l{#messagebox-text-interaction-flags*}{messagebox-text-interaction-flags*}
    \li \l{#opacity*}{opacity*}
    \li \l{#placeholder-text-color*}{placeholder-text-color*}
    \li \l{#selection-background-color*}{selection-background-color*}
    \li \l{#selection-color*}{selection-color*}
    \li \l{#show-decoration-selected*}{show-decoration-selected*}
    \li \l{#spacing*}{spacing*}
    \li \l{#subcontrol-origin*}{subcontrol-origin*}
    \li \l{#subcontrol-position*}{subcontrol-position*}
    \li \l{#widget-animation-duration*}{widget-animation-duration*}
    \endlist
 
    \section2 accent-color
 
    \table
      \row \li \b Type \li \l{#Brush}{Brush}
    \endtable
 
    The property sets the \c Accent, which is used to emphasize
    interactive UI elements. If this property is not set, it defaults to the \c highlight color.
 
    \section2 alternate-background-color
    \target alternate-background-color-prop
    \table
      \row \li \b Type \li \l{#Brush}{Brush}
    \endtable
    The \l{QAbstractItemView::alternatingRowColors}
           {alternate background color} used in QAbstractItemView subclasses.
 
           If this property is not set, the default value is
           whatever is set for the palette's
           \l{QPalette::}{AlternateBase} role.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 33
 
           See also \l{Qt Style Sheets Reference#background-prop}{background} and
           \l{#selection-background-color-prop}{selection-background-color}.
 
    \section2 background
    \target background-prop
    \table
      \row \li \b Type \li \l{#Background}{Background}
    \endtable
           Shorthand notation for setting the background. Equivalent
           to specifying \c background-color, \c background-image, \c
           background-repeat, and/or \c background-position.
 
           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 \l{QWidget}s.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 34
 
 
           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:
 
           \snippet code/doc_src_stylesheet.qdoc 35
 
           See also \l{#background-origin-prop}{background-origin},
           \l{#selection-background-color-prop}{selection-background-color},
           \l{#background-clip-prop}{background-clip},
           \l{#background-attachment-prop}{background-attachment}
           and \l{#alternate-background-color-prop}{alternate-background-color}.
 
    \section2 background-color
    \target background-color-prop
    \table
      \row \li \b Type \li \l{#Brush}{Brush}
    \endtable
           The background color used for the widget.
 
           Examples:
 
           \snippet code/doc_src_stylesheet.qdoc 36
 
    \section2 background-image
    \target background-image-prop
    \table
      \row \li \b Type \li \l{#Url}{Url}
    \endtable
           The background image used for the widget. Semi-transparent
           parts of the image let the \c background-color shine
           through.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 37
 
 
    \section2 background-repeat
    \target background-repeat-prop
    \table
      \row \li \b Type \li \l{#Repeat}{Repeat}
    \endtable
           Whether and how the background image is repeated to fill
           the \c background-origin rectangle.
 
           If this property is not specified, the background image
           is repeated in both directions (\c repeat).
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 38
 
    \section2 background-position
    \table
      \row \li \b Type \li \l{#Alignment}{Alignment}
    \endtable
           The alignment of the background image within the \c
           background-origin rectangle.
 
           If this property is not specified, the alignment is \c
           top \c left.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 39
 
    \section2 background-attachment
    \target background-attachment-prop
    \table
      \row \li \b Type \li \l{#Attachment}{Attachment}
    \endtable
           Determines whether the background-image in a QAbstractScrollArea
           is scrolled or fixed with respect to the viewport.
           By default, the background-image scrolls with the viewport.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 40
 
        See also \l{Qt Style Sheets Reference#background-prop}{background}
 
    \section2 background-clip
    \target background-clip-prop
    \table
      \row \li \b Type \li \l{#Origin}{Origin}
    \endtable
           The widget's rectangle, in which the \c background is drawn.
 
           This property specifies the rectangle to which the \c background-color
           and \c 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 \l{QWidget}s.
 
           If this property is not specified, the default is \c
           border.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 41
 
           See also \l{Qt Style Sheets Reference#background-prop}{background},
           \l{#background-origin-prop}{background-origin} and \l{The Box Model}.
 
    \section2 background-origin
    \target background-origin-prop
     \table
      \row \li \b Type \li \l{#Origin}{Origin}
    \endtable
 
           The widget's background rectangle, to use in conjunction
           with \c background-position and \c background-image.
 
           This property is supported by QAbstractItemView
           subclasses, QAbstractSpinBox subclasses, QCheckBox,
           QComboBox, QDialog, QFrame, QGroupBox, QLabel,
           QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip,
           and plain \l{QWidget}s.
 
           If this property is not specified, the default is \c
           padding.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 42
 
           See also \l{Qt Style Sheets Reference#background-prop}{background} and
           \l{The Box Model}.
 
    \section2 border
    \target border-prop
    \table
      \row \li \b Type \li \l{#Border}{Border}
    \endtable
 
           Shorthand notation for setting the widget's border. Equivalent
           to specifying \c border-color, \c border-style, and/or
           \c border-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 \l{QWidget}s.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 43
 
    \section2 border-top
 
    \table
      \row \li \b Type \li \l{#Border}{Border}
    \endtable
 
           Shorthand notation for setting the widget's top border.
           Equivalent to specifying \c border-top-color, \c
           border-top-style, and/or \c border-top-width.
 
    \section2 border-right
    \table
      \row \li \b Type \li \l{#Border}{Border}
    \endtable
 
           Shorthand notation for setting the widget's right border.
           Equivalent to specifying \c border-right-color, \c
           border-right-style, and/or \c border-right-width.
 
    \section2 border-bottom
    \table
      \row \li \b Type \li \l{#Border}{Border}
    \endtable
 
           Shorthand notation for setting the widget's bottom border.
           Equivalent to specifying \c border-bottom-color, \c
           border-bottom-style, and/or \c border-bottom-width.
 
    \section2 border-left
    \table
      \row \li \b Type \li \l{#Border}{Border}
    \endtable
 
           Shorthand notation for setting the widget's left border.
           Equivalent to specifying \c border-left-color, \c
           border-left-style, and/or \c border-left-width.
 
 
    \section2 border-color
    \target border-attrs
    \target border-color-prop
    \table
      \row \li \b Type \li \l{#Box Colors}{Box Colors}
    \endtable
 
           The color of all the border's edges. Equivalent to
           specifying \c border-top-color, \c border-right-color, \c
           border-bottom-color, and \c border-left-color.
 
           This property is supported by QAbstractItemView
           subclasses, QAbstractSpinBox subclasses, QCheckBox,
           QComboBox, QFrame, QGroupBox, QLabel, QLineEdit,
           QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter,
           QTextEdit, QToolTip, and plain \l{QWidget}s.
 
           If this property is not specified, it defaults to
           \l{#color-prop}{color} (i.e., the widget's foreground
           color).
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 44
 
           See also \l{Qt Style Sheets Reference#border-style-prop}{border-style},
           \l{Qt Style Sheets Reference#border-width-prop}{border-width},
           \l{#border-image-prop}{border-image}, and \l{The Box Model}.
 
    \section2 border-top-color
    \table
      \row \li \b Type \li \l{#Brush}{Brush}
    \endtable
 
           The color of the border's top edge.
 
    \section2 border-right-color
    \table
      \row \li \b Type \li \l{#Brush}{Brush}
    \endtable
 
           The color of the border's right edge.
 
    \section2 border-bottom-color
    \table
      \row \li \b Type \li \l{#Brush}{Brush}
    \endtable
 
           The color of the border's bottom edge.
 
    \section2 border-left-color
    \table
      \row \li \b Type \li \l{#Brush}{Brush}
    \endtable
 
           The color of the border's left edge.
 
    \section2 border-image
    \target border-image-prop
    \table
      \row \li \b Type \li \l{#Border Image}{Border Image}
    \endtable
 
           The image used to fill the border. The image is cut into
           nine parts and stretched appropriately if necessary. See
           \l{#Border Image}{Border Image} for details.
 
           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 \l{#border-color-prop}{border-color},
           \l{Qt Style Sheets Reference#border-style-prop}{border-style},
           \l{Qt Style Sheets Reference#border-width-prop}{border-width}, and
           \l{The Box Model}.
 
    \section2 border-radius
    \target border-radius-prop
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius of the border's corners. Equivalent to
           specifying \c border-top-left-radius, \c
           border-top-right-radius, \c border-bottom-right-radius,
           and \c border-bottom-left-radius.
 
           The border-radius clips the element's
           \l{Qt Style Sheets Reference#background-prop}{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:
 
           \snippet code/doc_src_stylesheet.qdoc 45
 
           See also \l{Qt Style Sheets Reference#border-width-prop}{border-width} and
           \l{The Box Model}.
 
    \section2 border-top-left-radius
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius of the border's top-left corner.
 
    \section2 border-top-right-radius
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius of the border's top-right corner.
 
    \section2 border-bottom-right-radius
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius of the border's bottom-right corner. Setting
           this property to a positive value results in a rounded
           corner.
 
    \section2 border-bottom-left-radius
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius of the border's bottom-left corner. Setting this
           property to a positive value results in a rounded corner.
 
    \section2 border-style
    \target border-style-prop
    \table
      \row \li \b Type \li \l{#Border Style}{Border Style}
    \endtable
 
           The style of all the border's edges.
 
           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 \c none.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 46
 
           See also \l{#border-color-prop}{border-color},
           \l{Qt Style Sheets Reference#border-style-prop}{border-style},
           \l{#border-image-prop}{border-image}, and \l{The Box Model}.
 
    \section2 border-top-style
    \table
      \row \li \b Type \li \l{#Border Style}{Border Style}}
    \endtable
 
           The style of the border's top edge.
 
    \section2 border-right-style
    \table
      \row \li \b Type \li \l{#Border Style}{Border Style}
    \endtable
 
           The style of the border's right edge.
 
    \section2 border-bottom-style
    \table
      \row \li \b Type \li \l{#Border Style}{Border Style}
    \endtable
 
           The style of the border's bottom edge.
 
    \section2 border-left-style
    \table
      \row \li \b Type \li \l{#Border Style}{Border Style}
    \endtable
 
           The style of the border's left edge.
 
    \section2 border-width
    \target border-width-prop
    \table
      \row \li \b Type \li \l{#Box Lengths}{Box Lengths}
    \endtable
 
           The width of the border. Equivalent to setting \c
           border-top-width, \c border-right-width, \c
           border-bottom-width, and \c border-left-width.
 
           This property is supported by QAbstractItemView
           subclasses, QAbstractSpinBox subclasses, QCheckBox,
           QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu,
           QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit,
           and QToolTip.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 47
 
           See also \l{#border-color-prop}{border-color},
           \l{#border-radius-prop}{border-radius},
           \l{Qt Style Sheets Reference#border-style-prop}{border-style},
           \l{#border-image-prop}{border-image}, and
           \l{The Box Model}.
 
    \section2 border-top-width
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The width of the border's top edge.
 
    \section2 border-right-width
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The width of the border's right edge.
 
    \section2 border-bottom-width
    \table
       \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The width of the border's bottom edge.
 
    \section2 border-left-width
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The width of the border's left edge.
 
    \section2 bottom
    \target bottom-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           If \l{#position-prop}{position} is \c relative (the
           default), moves a subcontrol by a certain offset up;
           specifying \tt{bottom: \e{y}} is then equivalent to
           specifying \tt{\l{Qt Style Sheets Reference#top-prop}{top}: -\e{y}}.
 
           If \l{#position-prop}{position} is \c absolute, the \c
           bottom property specifies the subcontrol's bottom edge
           in relation to the parent's bottom edge (see also
           \l{Qt Style Sheets Reference#subcontrol-origin-prop}
           {subcontrol-origin}).
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 48
 
           See also \l{Qt Style Sheets Reference#left-prop}{left}, \l{#right-prop}{right}, and
           \l{Qt Style Sheets Reference#top-prop}{top}.
 
 
    \section2 button-layout
    \target button-layout-prop
    \table
      \row \li \b Type \li \l{#Number}{Number}
    \endtable
 
           The layout of buttons in a QDialogButtonBox or
           a QMessageBox. The possible values are 0
           (\l{QDialogButtonBox::}{WinLayout}), 1
           (\l{QDialogButtonBox::}{MacLayout}), 2
           (\l{QDialogButtonBox::}{KdeLayout}), 3
           (\l{QDialogButtonBox::}{GnomeLayout}) and 5
           (\l{QDialogButtonBox::}{AndroidLayout}).
 
           If this property is not specified, it defaults to the
           value specified by the current style for the
           \l{QStyle::}{SH_DialogButtonLayout} style hint.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 49
 
 
    \section2 color
    \target color-prop
    \table
      \row \li \b Type \li \l{#Brush}{Brush} \br
    \endtable
 
           The color used to render text.
 
           This property is supported by all widgets that respect
           the \l 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:
 
           \snippet code/doc_src_stylesheet.qdoc 50
 
           See also \l{Qt Style Sheets Reference#background-prop}{background} and
           \l{#selection-color-prop}{selection-color}.
 
    \section2 dialogbuttonbox-buttons-have-icons
    \table
      \row \li \b Type \li \l{#Boolean}{Boolean}
    \endtable
 
           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.
 
        See the \l{Qt Style Sheets Reference#list of icons}{List of Icons}
        section for information on how to set icons.
 
        \snippet code/doc_src_stylesheet.qdoc 51
 
        \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.
 
    \omit
    \row
        \li \b{\c etch-disabled-text}*
        \li \l{#Boolean}{Boolean}
        \li Whether disabled text is drawn etched.
 
           If this property is not specified, it defaults to the
           value specified by the current style for the
           \l{QStyle::}{SH_EtchDisabledText} style hint.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 52
    \endomit
 
    \section2 font
    \target font-prop
    \table
      \row \li \b Type \li \l{#Font}{Font}
    \endtable
 
           Shorthand notation for setting the text's font. Equivalent
           to specifying \c font-family, \c font-size, \c font-style,
           and/or \c font-weight.
 
           This property is supported by all widgets that respect
           the \l QWidget::font.
 
           If this property is not set, the default is the
           QWidget::font.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 53
 
    \section2 font-family
    \table
      \row \li \b Type \li String
    \endtable
 
           The font family.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 54
 
    \section2 font-size
    \table
      \row \li \b Type \li \l{#Font Size}{Font Size}
    \endtable
 
           The font size. In this version of Qt, only pt and px metrics are
           supported.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 55
 
    \section2 font-style
    \table
      \row \li \b Type \li \l {#Font Style} {Font Style}
    \endtable
 
           The font style.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 56
 
    \section2 font-weight
    \table
      \row \li \b Type \li \l{#Font Weight}{Font Weight}
    \endtable
 
           The weight of the font.
 
    \section2 gridline-color*
    \target gridline-color-prop
    \table
      \row \li \b Type \li \l{#Color}{Color}
    \endtable
 
           The color of the grid line in a QTableView.
 
           If this property is not specified, it defaults to the
           value specified by the current style for the
           \l{QStyle::}{SH_Table_GridLineColor} style hint.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 57
 
 
    \section2 height
    \target height-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The height of a subcontrol (or in some case, a widget).
 
           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 \l{#min-width-prop}{min-height} and
           \l{#max-width-prop}{max-height} to the same value.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 58
 
           See also \l{#width-prop}{width}.
 
    \section2 icon
    \target icon-prop
    \table
      \row \li \b Type \li \l{#Url}{Url}+
    \endtable
 
           The icon that is used, for widgets that have an icon.
 
        The only widget currently supporting this property is QPushButton.
 
        \note 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.
 
        Available since 5.15.
 
    \section2 icon-size
    \target icon-size-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The width and height of the icon in a widget.
 
           The icon size of the following widgets can be set using this
           property.
               \list
               \li QCheckBox
               \li QListView
               \li QPushButton
               \li QRadioButton
               \li QTabBar
               \li QToolBar
               \li QToolBox
               \li QTreeView
               \endlist
 
    \section2 image*
    \target image-prop
    \table
      \row \li \b Type \li \l{#Url}{Url}+
    \endtable
 
           The image that is drawn in the contents rectangle of a
           subcontrol.
 
           The image property accepts a list of \l{#Url}{Url}s or
           a \c{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 \c{svg} is specified,
           the image is scaled to the size of the contents rectangle.
           Setting the size of a \c{svg} can be done with the
           \l{#width-prop}{width} and \l{#height-prop}{height} property
           (supported since Qt 6.13)
 
           Setting the image property on sub controls implicitly sets the
           width and height of the sub-control (unless the image in a SVG).
 
           Use \l{image-position-prop}{image-position} to align the image
           within the rectangle.
 
           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.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 59
 
 
    \section2 image-position
    \target image-position-prop
    \table
      \row \li \b Type \li \l{#Alignment}{alignment}
    \endtable
 
           The alignment of the image's position can be specified using relative
           or absolute position.
 
    \section2 left
    \target left-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           If \l{#position-prop}{position} is \c relative (the
           default), moves a subcontrol by a certain offset to
           the right.
 
           If \l{#position-prop}{position} is \c absolute, the \c
           left property specifies the subcontrol's left edge in
           relation to the parent's left edge (see also
           \l{Qt Style Sheets Reference#subcontrol-origin-prop}{subcontrol-origin}).
 
           If this property is not specified, it defaults to \c 0.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 60
 
           See also \l{#right-prop}{right}, \l{Qt Style Sheets Reference#top-prop}{top}, and
           \l{#bottom-prop}{bottom}.
 
    \section2 letter-spacing
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           Space between characters in a string within a widget.
 
    \section2 lineedit-password-character*
    \target lineedit-password-character-prop
    \table
      \row \li \b Type \li \l{#Number}{Number}
    \endtable
 
           The 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
           \l{QStyle::}{SH_LineEdit_PasswordCharacter} style hint.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 61
 
 
    \section2 lineedit-password-mask-delay*
    \target lineedit-password-mask-delay-prop
    \table
      \row \li \b Type \li \l{#Number}{Number}
    \endtable
 
           The QLineEdit password mask delay in milliseconds before
           \l{#lineedit-password-character-prop}{lineedit-password-character} is applied to visible character.
 
           If this property is not specified, it defaults to the
           value specified by the current style for the
           \l{QStyle::}{SH_LineEdit_PasswordMaskDelay} style hint.
 
           Available since Qt 5.4.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 160
 
    \section2 margin
    \target margin-prop
    \table
      \row \li \b Type \li \l {#Box Lengths}{Box Lengths}
    \endtable
 
           The widget's margins. Equivalent to specifying \c
           margin-top, \c margin-right, \c margin-bottom, and \c
           margin-left.
 
           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 \c 0.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 62
 
           See also \l{Qt Style Sheets Reference#padding-prop}{padding},
           \l{#spacing-prop}{spacing}, and \l{The Box Model}.
 
    \section2 margin-top
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
           The widget's top margin.
 
    \section2 margin-right
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
           The widget's right margin.
 
    \section2 margin-bottom
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
           The widget's bottom margin.
 
    \section2 margin-left
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
           The widget's left margin.
 
    \section2 max-height
    \target max-height-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The widget's or a subcontrol's maximum height.
 
           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 \l{The
           Box Model}{box model}.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 63
 
           See also \l{#max-width-prop}{max-width}.
 
    \section2 max-width
    \target max-width-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The widget's or a subcontrol's maximum 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 \l{The
           Box Model}{box model}.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 64
 
           See also \l{#max-height-prop}{max-height}.
 
    \section2 messagebox-text-interaction-flags*
    \target messagebox-text-interaction-flags-prop
    \table
      \row \li \b Type \li \l{#Number}{Number}
    \endtable
 
           The interaction behavior for text in a message box.
           Possible values are based on Qt::TextInteractionFlags.
 
           If this property is not specified, it defaults to the
           value specified by the current style for the
           \l{QStyle::}{SH_MessageBox_TextInteractionFlags} style
           hint.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 65
 
    \section2 min-height
    \target min-height-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The widget's or a subcontrol's minimum height.
 
           This property is supported by QAbstractItemView
           subclasses, QAbstractSpinBox subclasses, QCheckBox,
           QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu,
           QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox,
           QSplitter, QStatusBar, QTextEdit, QToolButton, 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 \l{The
           Box Model}{box model}.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 66
 
           \note Setting this property might allow widgets to shrink
           smaller than the space required for the contents.
 
           See also \l{#min-width-prop}{min-width}.
 
    \section2 min-width
    \target min-width-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The widget's or a subcontrol's minimum 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, QToolButton, 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 \l{The
           Box Model}{box model}.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 67
 
           \note Setting this property might allow widgets to shrink
           smaller than the space required for the contents.
 
           See also \l{#min-height-prop}{min-height}.
 
    \section2 opacity*
    \target opacity-prop
    \table
      \row \li \b Type \li \l{#Number}{Number}
    \endtable
 
           The opacity for a widget. Possible values are from 0
           (transparent) to 255 (opaque). For the moment, this is
           only supported for \l{QToolTip}{tooltips}.
 
           If this property is not specified, it defaults to the
           value specified by the current style for the
           \l{QStyle::}{SH_ToolTipLabel_Opacity} style hint.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 68
 
    \section2 outline
 
           The outline drawn around the object's border.
 
    \section2 outline-color
    \table
      \row \li \b Type \li \l{#Color}{Color}
    \endtable
 
           The color of the outline.
            See also \l{Qt Style Sheets Reference#border-color-prop}{border-color}
 
    \section2 outline-offset
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The outline's offset from the border of the widget.
 
    \section2 outline-style
 
           Specifies the pattern used to draw the outline.
           See also \l{Qt Style Sheets Reference#border-style-prop}{border-style}
 
    \section2 outline-radius
 
           Adds rounded corners to the outline.
 
    \section2 outline-bottom-left-radius
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius for the bottom-left rounded corner of the outline.
 
    \section2 outline-bottom-right-radius
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius for the bottom-right rounded corner of the outline.
 
    \section2 outline-top-left-radius
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius for the top-left corner of the outline.
 
    \section2 outline-top-right-radius
    \table
      \row \li \b Type \li \l{#Radius}{Radius}
    \endtable
 
           The radius for the top-right rounded corner of the outline.
 
    \section2 padding
    \target padding-prop
    \table
      \row \li \b Type \li \l{#Box Lengths}{Box Lengths}
    \endtable
 
           The widget's padding. Equivalent to specifying \c
           padding-top, \c padding-right, \c padding-bottom, and \c
           padding-left.
 
           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 \c 0.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 69
 
           See also \l{#margin-prop}{margin},
           \l{#spacing-prop}{spacing}, and \l{The Box Model}.
 
    \section2 padding-top
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The widget's top padding.
 
    \section2 padding-right
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The widget's right padding.
 
    \section2 padding-bottom
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The widget's bottom padding.
 
    \section2 padding-left
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           The widget's left padding.
 
    \section2 paint-alternating-row-colors-for-empty-area
    \target paint-alternating-row-colors-for-empty-area-prop
    \table
      \row \li \b Type \li \c bool
    \endtable
 
           Whether the QTreeView paints alternating row colors for the empty
           area (i.e the area where there are no items)
 
    \section2 placeholder-text-color*
    \target placeholder-text-color-prop
    \table
      \row \li \b Type \li \l{#Brush}{Brush} \br
    \endtable
 
           The color used for the placeholder text of text editing widgets.
 
           If this property is not set, the default value is whatever
           is set for the palette's \l{QPalette::}{PlaceholderText}
           role.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 163
 
           Available since 6.5.
 
    \section2 position
    \target position-prop
    \table
      \row \li \b Type \li \c relative \br
            | \c absolute
    \endtable
 
           Whether offsets specified using \l{Qt Style Sheets Reference#left-prop}{left},
           \l{#right-prop}{right}, \l{Qt Style Sheets Reference#top-prop}{top}, and
           \l{#bottom-prop}{bottom} are relative or absolute
           coordinates.
 
           If this property is not specified, it defaults to \c
           relative.
 
    \section2 right
    \target right-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           If \l{#position-prop}{position} is \c relative (the
           default), moves a subcontrol by a certain offset to
           the left; specifying \tt{right: \e{x}} is then equivalent
           to specifying \tt{\l{Qt Style Sheets Reference#left-prop}{left}: -\e{x}}.
 
           If \l{#position-prop}{position} is \c absolute, the \c
           right property specifies the subcontrol's right edge in
           relation to the parent's right edge (see also
           \l{Qt Style Sheets Reference#subcontrol-origin-prop}{subcontrol-origin}).
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 70
 
           See also \l{Qt Style Sheets Reference#left-prop}{left}, \l{Qt Style Sheets Reference#top-prop}{top}, and
           \l{#bottom-prop}{bottom}.
 
    \section2 selection-background-color*
    \target selection-background-color-prop
    \table
      \row \li \b Type \li \l{#Brush}{Brush}
    \endtable
 
           The background of selected text or items.
 
           This property is supported by all widgets that respect
           the \l QWidget::palette and that show selection text.
 
           If this property is not set, the default value is
           whatever is set for the palette's
           \l{QPalette::}{Highlight} role.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 71
 
           See also \l{#selection-color-prop}{selection-color} and
           \l{Qt Style Sheets Reference#background-prop}{background}.
 
 
    \section2 selection-color*
    \target selection-color-prop
    \table
      \row \li \b Type \li \l{#Brush}{Brush} \br
    \endtable
 
           The foreground of selected text or items.
 
           This property is supported by all widgets that respect
           the \l QWidget::palette and that show selection text.
 
           If this property is not set, the default value is
           whatever is set for the palette's
           \l{QPalette::}{HighlightedText} role.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 72
 
           See also
           \l{#selection-background-color-prop}{selection-background-color}
           and \l{#color-prop}{color}.
 
 
    \section2 show-decoration-selected*
    \target show-decoration-selected-prop
    \table
      \row \li \b Type \li \l{#Boolean}{Boolean}
    \endtable
 
           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
           \l{QStyle::}{SH_ItemView_ShowDecorationSelected} style
           hint.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 73
 
    \section2 spacing*
    \target spacing-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           Internal spacing in the widget.
 
           This property is supported by QCheckBox, checkable
           \l{QGroupBox}es, QMenuBar, and QRadioButton.
 
           If this property is not specified, the default value
           depends on the widget and on the current style.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 74
 
           See also \l{Qt Style Sheets Reference#padding-prop}{padding} and
           \l{#margin-prop}{margin}.
 
 
    \section2 subcontrol-origin*
    \target subcontrol-origin-prop
    \table
      \row \li \b Type \li \l{#Origin}{Origin}
    \endtable
 
           The origin rectangle of the subcontrol within the
           parent element.
 
           If this property is not specified, the default is \c
           padding.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 75
 
           See also
           \l{Qt Style Sheets Reference#subcontrol-position-prop}{subcontrol-position}.
 
    \section2 subcontrol-position*
    \target subcontrol-position-prop
    \table
      \row \li \b Type \li \l{#Alignment}{Alignment}
    \endtable
 
           The alignment of the subcontrol within the origin
           rectangle specified by \l{Qt Style Sheets Reference#subcontrol-origin-prop}
           {subcontrol-origin}.
 
           If this property is not specified, it defaults to a value
           that depends on the subcontrol.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 76
 
           See also
           \l{Qt Style Sheets Reference#subcontrol-origin-prop}{subcontrol-origin}.
 
    \section2 titlebar-show-tooltips-on-buttons
    \target titlebar-show-tooltips-on-buttons-prop
    \table
      \row \li \b Type \li \c bool
    \endtable
 
           Whether tool tips are shown on window title bar buttons.
 
 
    \section2 widget-animation-duration*
    \target widget-animation-duration
    \table
      \row \li \b Type \li \l{#Number}{Number}
    \endtable
 
           How much an animation should last (in milliseconds).
            A value equal to zero means that the animations will be disabled.
 
           If this property is not specified, it defaults to the
           value specified by the current style for the
           \l{QStyle::}{SH_Widget_Animation_Duration} style hint.
 
           Available since Qt 5.10.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 162
 
    \section2 text-align
    \target text-align-prop
    \table
      \row \li \b Type \li \l{#Alignment}{Alignment}
    \endtable
 
           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.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 77
 
            This property is currently supported only by QPushButton
            and QProgressBar.
 
    \section2 text-decoration
    \table
      \row \li \b Type
            \li \c none \br
           \c underline \br
           \c overline \br
           \c line-through
    \endtable
 
           Additional text effects.
 
 
    \section2 top
    \target top-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           If \l{#position-prop}{position} is \c relative (the
           default), moves a subcontrol by a certain offset
           down.
 
           If \l{#position-prop}{position} is \c absolute, the \c top
           property specifies the subcontrol's top edge in relation
           to the parent's top edge (see also
           \l{Qt Style Sheets Reference#subcontrol-origin-prop}{subcontrol-origin}).
 
           If this property is not specified, it defaults to \c 0.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 78
 
           See also \l{Qt Style Sheets Reference#left-prop}{left}, \l{#right-prop}{right}, and
           \l{#bottom-prop}{bottom}.
 
    \section2 width
    \target width-prop
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           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.
 
           \warning Unless otherwise specified, this property has no effect
           when set on widgets. If you want a widget with a fixed width, set
           the \l{#min-width-prop}{min-width} and
           \l{#max-width-prop}{max-width} to the same value.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 79
 
           See also \l{#height-prop}{height}.
 
    \section2 word-spacing
    \table
      \row \li \b Type \li \l{#Length}{Length}
    \endtable
 
           Space between each word in a string within a widget.
 
    \section2 -qt-background-role
    \table
      \row \li \b Type \li \l{#paletterole}{PaletteRole}
    \endtable
 
           The \c{background-color} for the subcontrol or widget based on the
            chosen role.
 
    \section2 -qt-style-features
    \table
      \row \li \b Type \li \c list
    \endtable
 
           The list of CSS properties that you want to apply Qt-specific styles on.
 
            \note The \c list can only include properties that are not pixmap-based.
 
    \target list of icons
    \section1 List of Icons
 
    Icons used in Qt can be customized using the following properties. Each of
    the properties listed in this section have the type \l{#Icon}{Icon}.
 
    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.
 
    \table 100%
    \header
        \li Name
        \li QStyle::StandardPixmap
 
    \row
        \li backward-icon
        \li QStyle::SP_ArrowBack
 
    \row
        \li cd-icon
        \li QStyle::SP_DriveCDIcon
 
    \row
        \li computer-icon
        \li QStyle::SP_ComputerIcon
 
    \row
        \li desktop-icon
        \li QStyle::SP_DesktopIcon
 
    \row
        \li dialog-apply-icon
        \li QStyle::SP_DialogApplyButton
 
    \row
        \li dialog-cancel-icon
        \li QStyle::SP_DialogCancelButton
 
    \row
        \li dialog-close-icon
        \li QStyle::SP_DialogCloseButton
 
    \row
        \li dialog-discard-icon
        \li QStyle::SP_DialogDiscardButton
 
    \row
        \li dialog-help-icon
        \li QStyle::SP_DialogHelpButton
 
    \row
        \li dialog-no-icon
        \li QStyle::SP_DialogNoButton
 
    \row
        \li dialog-ok-icon
        \li QStyle::SP_DialogOkButton
 
    \row
        \li dialog-open-icon
        \li QStyle::SP_DialogOpenButton
 
    \row
        \li dialog-reset-icon
        \li QStyle::SP_DialogResetButton
 
    \row
        \li dialog-save-icon
        \li QStyle::SP_DialogSaveButton
 
    \row
        \li dialog-yes-icon
        \li QStyle::SP_DialogYesButton
 
    \row
        \li directory-closed-icon
        \li QStyle::SP_DirClosedIcon
 
    \row
        \li directory-icon
        \li QStyle::SP_DirIcon
 
    \row
        \li directory-link-icon
        \li QStyle::SP_DirLinkIcon
 
    \row
        \li directory-open-icon
        \li QStyle::SP_DirOpenIcon
 
    \row
        \li dockwidget-close-icon
        \li QStyle::SP_DockWidgetCloseButton
 
    \row
        \li downarrow-icon
        \li QStyle::SP_ArrowDown
 
    \row
        \li dvd-icon
        \li QStyle::SP_DriveDVDIcon
 
    \row
        \li file-icon
        \li QStyle::SP_FileIcon
 
    \row
        \li file-link-icon
        \li QStyle::SP_FileLinkIcon
 
    \omit
    \row
        \li filedialog-backward-icon
        \li QStyle::SP_FileDialogBack
    \endomit
 
    \row
        \li filedialog-contentsview-icon
        \li QStyle::SP_FileDialogContentsView
 
    \row
        \li filedialog-detailedview-icon
        \li QStyle::SP_FileDialogDetailedView
 
    \row
        \li filedialog-end-icon
        \li QStyle::SP_FileDialogEnd
 
    \row
        \li filedialog-infoview-icon
        \li QStyle::SP_FileDialogInfoView
 
    \row
        \li filedialog-listview-icon
        \li QStyle::SP_FileDialogListView
 
    \row
        \li filedialog-new-directory-icon
        \li QStyle::SP_FileDialogNewFolder
 
    \row
        \li filedialog-parent-directory-icon
        \li QStyle::SP_FileDialogToParent
 
    \row
        \li filedialog-start-icon
        \li  QStyle::SP_FileDialogStart
 
    \row
        \li floppy-icon
        \li QStyle::SP_DriveFDIcon
 
    \row
        \li forward-icon
        \li QStyle::SP_ArrowForward
 
    \row
        \li harddisk-icon
        \li QStyle::SP_DriveHDIcon
 
    \row
        \li home-icon
        \li QStyle::SP_DirHomeIcon
 
    \row
        \li lineedit-clear-button-icon
        \li QStyle::SP_LineEditClearButton
 
    \row
        \li leftarrow-icon
        \li QStyle::SP_ArrowLeft
 
    \row
        \li messagebox-critical-icon
        \li QStyle::SP_MessageBoxCritical
 
    \row
        \li messagebox-information-icon
        \li QStyle::SP_MessageBoxInformation
 
    \row
        \li messagebox-question-icon
        \li QStyle::SP_MessageBoxQuestion
 
    \row
        \li messagebox-warning-icon
        \li QStyle::SP_MessageBoxWarning
 
    \row
        \li network-icon
        \li QStyle::SP_DriveNetIcon
 
    \row
        \li rightarrow-icon
        \li QStyle::SP_ArrowRight
 
    \row
        \li titlebar-contexthelp-icon
        \li QStyle::SP_TitleBarContextHelpButton
 
    \row
        \li titlebar-maximize-icon
        \li QStyle::SP_TitleBarMaxButton
 
    \row
        \li titlebar-menu-icon
        \li QStyle::SP_TitleBarMenuButton
 
    \row
        \li titlebar-minimize-icon
        \li QStyle::SP_TitleBarMinButton
 
    \row
        \li titlebar-normal-icon
        \li QStyle::SP_TitleBarNormalButton
 
    \row
        \li titlebar-shade-icon
        \li QStyle::SP_TitleBarShadeButton
 
    \row
        \li titlebar-unshade-icon
        \li QStyle::SP_TitleBarUnshadeButton
 
    \row
        \li trash-icon
        \li QStyle::SP_TrashIcon
 
    \row
        \li uparrow-icon
        \li QStyle::SP_ArrowUp
 
    \endtable
 
    \section1 List of Property Types
 
    The following table summarizes the syntax and meaning of the
    different property types.
 
    \table 100%
    \header
        \li Type
        \li Syntax
        \li Description
 
    \row
        \li \b Alignment \target Alignment
        \li \{ \c top \br
           | \c bottom \br
           | \c left \br
           | \c right \br
           | \c center \}*
        \li Horizontal and/or vertical alignment.
 
           Example:
 
    \snippet code/doc_src_stylesheet.qdoc 80
 
    \row
        \li \b Attachment \target Attachment
        \li \{ \c scroll \br
           | \c fixed \}*
        \li Scroll or fixed attachment.
 
    \row
        \li \b Background \target Background
        \li \{ \l{#Brush}{Brush} \br
           | \l{#Url}{Url} \br
           | \l{#Repeat}{Repeat} \br
           | \l{#Alignment}{Alignment} \}*
        \li A sequence of \l{#Brush}{Brush}, \l{#Url}{Url},
           \l{#Repeat}{Repeat}, and \l{#Alignment}{Alignment}.
 
    \row
        \li \b Boolean \target Boolean
        \li 0 | 1
        \li True (\c 1) or false (\c 0).
 
           Example:
 
    \snippet code/doc_src_stylesheet.qdoc 81
 
    \row
        \li \b Border \target Border
        \li \{ \l{#Border Style}{Border Style} \br
           | \l{#Length}{Length} \br
           | \l{#Brush}{Brush} \}*
        \li Shorthand border property.
 
    \row
        \li \b{Border Image} \target Border Image
        \li \c none \br
           | \l{Url} \l{Number}\{4\} \br (\c stretch | \c repeat){0,2}
        \li A border image is an image that is composed of nine parts
           (top left, top center, top right, center left, center,
           center right, bottom left, bottom center, and bottom
           right). When a border of a certain size is required, the
           corner parts are used as is, and the top, right, bottom,
           and left parts are stretched or repeated to produce a
           border with the desired size.
 
           See the
           \l{http://www.w3.org/TR/css3-background/#the-border-image}
           {CSS3 Draft Specification} for details.
 
    \row
        \li \b{Border Style} \target Border Style
        \li \c dashed \br
           | \c dot-dash \br
           | \c dot-dot-dash \br
           | \c dotted \br
           | \c double \br
           | \c groove \br
           | \c inset \br
           | \c outset \br
           | \c ridge \br
           | \c solid \br
           | \c none
        \li Specifies the pattern used to draw a border.
           See the \l{http://www.w3.org/TR/css3-background/#border-style}
           {CSS3 Draft Specification} for details.
 
    \row
        \li \b{Box Colors} \target Box Colors
        \li \l{#Brush}{Brush}\{1,4\}
        \li One to four occurrences of \l{#Brush}{Brush}, specifying the top,
           right, bottom, and left edges of a box, respectively. If
           the left color is not specified, it is taken to be the
           same as the right color. If the bottom color is not
           specified, it is taken to be the same as the top color. If
           the right color is not specified, it is taken to be the
           same as the top color.
 
           Example:
 
           \snippet code/doc_src_stylesheet.qdoc 82
 
    \row
        \li \b{Box Lengths} \target Box Lengths
        \li \l{#Length}{Length}\{1,4\}
        \li One to four occurrences of \l{#Length}{Length}, specifying the
           top, right, bottom, and left edges of a box,
           respectively. If the left length is not specified, it is
           taken to be the same as the right length. If the bottom
           length is not specified, is it taken to be the same as the
           top length. If the right length is not specified, it is
           taken to be the same as the top length.
 
           Examples:
 
           \snippet code/doc_src_stylesheet.qdoc 83
 
    \row
        \li \b{Brush} \target Brush
        \li \l{#Color}{Color} \br
           | \l{Gradient} \br
           | \l{PaletteRole}
        \li Specifies a Color or a Gradient or an entry in the Palette.
 
    \row
        \li \b{Color} \target Color
        \li \tt{rgb(\e{r}, \e{g}, \e{b})} \br
           | \tt{rgba(\e{r}, \e{g}, \e{b}, \e{a})} \br
           | \tt{hsv(\e{h}, \e{s}, \e{v})} \br
           | \tt{hsva(\e{h}, \e{s}, \e{v}, \e{a})} \br
           | \tt{hsl(\e{h}, \e{s}, \e{l})} \br
           | \tt{hsla(\e{h}, \e{s}, \e{l}, \e{a})} \br
           | \tt{#\e{rrggbb}} \br
           | \l{QColor::fromString()}{Color Name} \br
        \li Specifies a color as RGB (red, green, blue), RGBA (red,
           green, blue, alpha), HSV (hue, saturation, value), HSVA
           (hue, saturation, value, alpha), HSL (hue, saturation,
           lightness), HSLA (hue, saturation, lightness, alpha) or a
           named color. The \c rgb() or \c rgba() syntax can be used
           with integer values between 0 and 255, or with percentages.
           The value of s, v, l and a in \c hsv(), \c hsva() \c hsl()
           or \c hsla() must all be in the range 0-255 or with
           percentages, the value of h must be in the range 0-359.
           The support for HSL(A) is available since 5.13.
 
           Examples:
 
            \snippet code/doc_src_stylesheet.qdoc 84
 
            \note The RGB colors allowed are the same as those allowed with
            CSS 2.1, as listed
            \l{http://www.w3.org/TR/CSS21/syndata.html#color-units}{here}.
 
    \row
        \li \b{Font} \target Font
        \li (\l{#Font Style}{Font Style} | \l{#Font Weight}{Font Weight}){0,2} \l{#Font Size}{Font Size} String
        \li Shorthand font property.
 
    \row
        \li \b{Font Size} \target Font Size
        \li \l{Length}
        \li The size of a font.
 
    \row
        \li \b{Font Style} \target Font Style
        \li \c normal \br
           | \c italic \br
           | \c oblique
        \li The style of a font.
 
    \row
        \li \b{Font Weight} \target Font Weight
        \li \c normal \br
           | \c bold \br
           | \c 100 \br
           | \c 200 \br
           ... \br
           | \c 900
        \li The weight of a font.
 
    \row
        \li \b{Gradient} \target Gradient
        \li \c qlineargradient \br
           | \c qradialgradient \br
           | \c qconicalgradient
        \li Specifies gradient fills. There are three types of gradient fills:
 
           \list
           \li \e{Linear} gradients interpolate colors between start and
              end points.
           \li \e{Radial} gradients interpolate colors between a focal
              point and end points on a circle surrounding it.
           \li \e{Conical} gradients interpolate colors around a center
              point.
           \endlist
 
        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:
 
        \snippet code/doc_src_stylesheet.qdoc 85
 
    \row
        \li \b{Icon} \target Icon
        \li (\l{#Url}{Url} (\c disabled | \c active | \c normal | \c selected)?
            (\c on | \c off)? )*
        \li A list of url, QIcon::Mode and QIcon::State.
 
            Example:
            \snippet code/doc_src_stylesheet.qdoc 86
 
    \row
        \li \b{Length} \target Length
        \li \l{#Number}{Number} (\c px | \c pt | \c em | \c ex)?
        \li A number followed by a measurement unit. The CSS standard recommends
           that user agents must
           \l{http://www.w3.org/TR/CSS21/syndata.html#illegalvalues}{ignore}
           a declaration with an illegal value. In Qt, it is mandatory to
           specify measurement units. For compatibility with earlier versions
           of Qt, numbers without measurement units are treated as pixels
           in most contexts. The supported units are:
 
           \list
           \li \c px: pixels
           \li \c pt: the size of one point (i.e., 1/72 of an inch)
           \li \c em: the size relative to the font size of the element
                  (e.g., 2em means 2 times the size of the font)
           \li \c ex: the x-height of the font (i.e., the height of 'x')
           \endlist
 
           However, Qt is limited to font sizes in \c pt and \c px and any other
           size must be in \c px, \c em or \c ex.
 
    \row
        \li \b{Number} \target Number
        \li A decimal integer or a real number
        \li Examples: \c 0, \c 18, \c +127, \c -255, \c 12.34, \c -.5,
           \c 0009.
 
    \row
        \li \b{Origin} \target Origin
        \li \c margin \br
           | \c border \br
           | \c padding \br
           | \c content
        \li Indicates which of four rectangles to use.
 
           \list
           \li \c margin: The margin rectangle. The margin falls outside the border.
           \li \c border: The border rectangle. This is where any border is drawn.
           \li \c padding: The padding rectangle. Unlike the margins,
                          padding is located inside the border.
           \li \c content: The content rectangle. This specifies where
                          the actual contents go, excluding any
                          padding, border, or margin.
           \endlist
 
           See also \l{The Box Model}.
 
    \row
        \li \b{PaletteRole} \target PaletteRole
        \li \c alternate-base \br
              | \c accent \br
              | \c base \br
              | \c bright-text \br
              | \c button \br
              | \c button-text \br
              | \c dark \br
              | \c highlight \br
              | \c highlighted-text \br
              | \c light \br
              | \c link \br
              | \c link-visited \br
              | \c mid \br
              | \c midlight \br
              | \c placeholder-text \br
              | \c shadow \br
              | \c text \br
              | \c tooltip-base \br
              | \c tooltip-text \br
              | \c window \br
              | \c window-text \br
        \li These values correspond the \l{QPalette::ColorRole}{Color roles}
           in the widget's QPalette.
 
            For example,
            \snippet code/doc_src_stylesheet.qdoc 87
 
    \row
        \li \b{Radius} \target Radius
        \li \l{#Length}{Length}\{1, 2\}
        \li One or two occurrences of \l{#Length}{Length}. If only one length is
           specified, it is used as the radius of the quarter circle
           defining the corner. If two lengths are specified, the
           first length is the horizontal radius of a quarter
           ellipse, whereas the second length is the vertical radius.
 
    \row
        \li \b{Repeat} \target Repeat
        \li \c repeat-x \br
           | \c repeat-y \br
           | \c repeat \br
           | \c no-repeat
        \li A value indicating the nature of repetition.
 
           \list
           \li \c repeat-x: Repeat horizontally.
           \li \c repeat-y: Repeat vertically.
           \li \c repeat: Repeat horizontally and vertically.
           \li \c no-repeat: Don't repeat.
           \endlist
 
    \row
        \li \b{Url} \target Url
        \li \tt{url(\e{filename})}
        \li \tt{\e{filename}} is the name of a file on the local disk
           or stored using \l{The Qt Resource System}. Setting an
           image implicitly sets the width and height of the element.
 
    \endtable
 
    \section1 List of Pseudo-States
 
    The following pseudo-states are supported:
 
    \table 100%
    \header
        \li Pseudo-State
        \li Description
 
    \row \li \c :active \target active
          \li This state is set when the widget resides in an active window.
 
    \row
        \li \c :adjoins-item \target adjoins-item-ps
        \li This state is set when the \l{#branch-sub}{::branch} of a QTreeView
           is adjacent to an item.
 
    \row
        \li \c :alternate \target alternate-ps
        \li This state is set for every alternate row whe painting the row of
           a QAbstractItemView when QAbstractItemView::alternatingRowColors()
           is  set to true.
 
    \row
        \li \c :bottom \target bottom-ps
        \li The item is positioned at the bottom. For example, a QTabBar
           that has its tabs positioned at the bottom.
 
    \row
        \li \c :checked \target checked-ps
        \li The item is checked. For example, the
            \l{QAbstractButton::checked}{checked} state of QAbstractButton.
 
    \row
        \li \c :closable \target closable-ps
        \li The items can be closed. For example, the QDockWidget has the
           QDockWidget::DockWidgetClosable feature turned on.
 
    \row
        \li \c :closed \target closed-ps
        \li The item is in the closed state. For example, an non-expanded
           item in a QTreeView
 
    \row
        \li \c :default \target default-ps
        \li The item is the default. For example, a
           \l{QPushButton::default}{default} QPushButton or a default action
           in a QMenu.
 
    \row
        \li \c :disabled \target disabled-ps
        \li The item is \l{QWidget::enabled}{disabled}.
 
    \row
        \li \c :editable \target editable-ps
        \li The QComboBox is editable.
 
    \row
        \li \c :enabled \target enabled-ps
        \li The item is \l{QWidget::enabled}{enabled}.
 
    \row
        \li \c :exclusive \target exclusive-ps
        \li The item is part of an exclusive item group. For example, a menu
           item in a exclusive QActionGroup.
 
    \row
        \li \c :first \target first-ps
        \li The item is the first (in a list). For example, the first
           tab in a QTabBar.
 
    \row
        \li \c :flat \target flat-ps
        \li The item is flat. For example, a
           \l{QPushButton::flat}{flat} QPushButton.
 
    \row
        \li \c :floatable \target floatable-ps
        \li The items can be floated. For example, the QDockWidget has the
           QDockWidget::DockWidgetFloatable feature turned on.
 
    \row
        \li \c :focus \target focus-ps
        \li The item has \l{QWidget::hasFocus()}{input focus}.
 
    \row
        \li \c :has-children \target has-children-ps
        \li The item has children. For example, an item in a
           QTreeView that has child items.
 
    \row
        \li \c :has-siblings \target has-siblings-ps
        \li The item has siblings. For example, an item in a
           QTreeView that siblings.
 
    \row
        \li \c :horizontal \target horizontal-ps
        \li The item has horizontal orientation
 
    \row
        \li \c :hover \target hover-ps
        \li The mouse is hovering over the item.
 
    \row
        \li \c :indeterminate \target indeterminate-ps
        \li The item has indeterminate state. For example, a QCheckBox
           or QRadioButton is \l{Qt::PartiallyChecked}{partially checked}.
 
    \row
        \li \c :last \target last-ps
        \li The item is the last (in a list). For example, the last
           tab in a QTabBar.
 
    \row
        \li \c :left \target left-ps
        \li The item is positioned at the left. For example, a QTabBar
           that has its tabs positioned at the left.
 
    \row
        \li \c :maximized \target maximized-ps
        \li The item is maximized. For example, a maximized QMdiSubWindow.
 
    \row
        \li \c :middle \target middle-ps
        \li The item is in the middle (in a list). For example, a tab
           that is not in the beginning or the end in a QTabBar.
 
    \row
        \li \c :minimized \target minimized-ps
        \li The item is minimized. For example, a minimized QMdiSubWindow.
 
    \row
        \li \c :movable \target movable-ps
        \li The item can be moved around. For example, the QDockWidget has the
           QDockWidget::DockWidgetMovable feature turned on.
 
    \row
        \li \c :no-frame \target no-frame-ps
        \li The item has no frame. For example, a frameless QSpinBox
           or QLineEdit.
 
    \row
        \li \c :non-exclusive \target non-exclusive-ps
        \li The item is part of a non-exclusive item group. For example, a menu
           item in a non-exclusive QActionGroup.
 
    \row
        \li \c :off \target off-ps
        \li For items that can be toggled, this applies to items
           in the "off" state.
 
    \row
        \li \c :on \target on-ps
        \li For items that can be toggled, this applies to widgets
           in the "on" state.
 
    \row
        \li \c :only-one \target only-one-ps
        \li The item is the only one (in a list). For example, a lone tab
           in a QTabBar.
 
    \row
        \li \c :open \target open-ps
        \li The item is in the open state. For example, an expanded
           item in a QTreeView, or a QComboBox or QPushButton with
           an open menu.
 
    \row
        \li \c :next-selected \target next-selected-ps
        \li The next item (in a list) is selected. For example, the
           selected tab of a QTabBar is next to this item.
 
    \row
        \li \c :pressed \target pressed-ps
        \li The item is being pressed using the mouse.
 
    \row
        \li \c :previous-selected \target previous-selected-ps
        \li The previous item (in a list) is selected. For example, a
           tab in a QTabBar that is next to the selected tab.
 
    \row
        \li \c :read-only \target read-only-ps
        \li The item is marked read only or non-editable. For example,
           a read only QLineEdit or a non-editable QComboBox.
 
    \row
        \li \c :right \target right-ps
        \li The item is positioned at the right. For example, a QTabBar
           that has its tabs positioned at the right.
 
    \row
        \li \c :selected \target selected-ps
        \li The item is selected. For example, the selected tab in
           a QTabBar or the selected item in a QMenu.
 
    \row
        \li \c :top \target top-ps
        \li The item is positioned at the top. For example, a QTabBar
           that has its tabs positioned at the top.
 
    \row
        \li \c :unchecked \target unchecked-ps
        \li The item is
           \l{QAbstractButton::checked}{unchecked}.
 
    \row
        \li \c :vertical \target vertical-ps
        \li The item has vertical orientation.
 
    \row
        \li \c :window \target window-ps
        \li The widget is a window (i.e top level widget)
 
    \endtable
 
    \target subcontrols
    \section1 List of Sub-Controls
 
    The following subcontrols are available:
 
    \table 100%
    \header
        \li Sub-Control
        \li Description
 
    \row
        \li \c ::add-line \target add-line-sub
        \li The button to add a line of a QScrollBar.
 
    \row
        \li \c ::add-page \target add-page-sub
        \li The region between the handle (slider) and the \l{#add-line-sub}{add-line}
           of a QScrollBar.
 
    \row
        \li \c ::branch \target branch-sub
        \li The branch indicator of a QTreeView.
 
    \row
        \li \c ::chunk \target chunk-sub
        \li The progress chunk of a QProgressBar.
 
    \row
        \li \c ::close-button \target close-button-sub
        \li The close button of a QDockWidget or tabs of QTabBar
 
    \row
        \li \c ::corner \target corner-sub
        \li The corner between two scrollbars in a QAbstractScrollArea
 
    \row
        \li \c ::down-arrow \target down-arrow-sub
        \li The down arrow of a QComboBox, QHeaderView (sort indicator),
           QScrollBar or QSpinBox.
 
    \row
        \li \c ::down-button \target down-button-sub
        \li  The down button of a QScrollBar or a QSpinBox.
 
    \row
        \li \c ::drop-down \target drop-down-sub
        \li The drop-down button of a QComboBox.
 
    \row
        \li \c ::float-button \target float-button-sub
        \li The float button of a QDockWidget
 
    \row
        \li \c ::groove \target groove-sub
        \li The groove of a QSlider.
 
    \row
        \li \c ::indicator \target indicator-sub
        \li The indicator of a QAbstractItemView, a QCheckBox, a QRadioButton,
           a checkable QMenu item or a checkable QGroupBox.
 
    \row
        \li \c ::handle \target handle-sub
        \li The handle (slider) of a QScrollBar, a QSplitter, or a QSlider.
 
    \row
        \li \c ::icon \target icon-sub
        \li The icon of a QAbstractItemView or a QMenu.
 
    \row
        \li \c ::item \target item-sub
        \li An item of a QAbstractItemView, a QMenuBar, a QMenu, or
        a QStatusBar.
 
    \row
        \li \c ::left-arrow \target left-arrow-sub
        \li The left arrow of a QScrollBar.
 
    \row
        \li \c ::left-corner \target left-corner-sub
        \li The left corner of a QTabWidget. For example, this control can be
           used to control position the left corner widget in a QTabWidget.
 
    \row
        \li \c ::menu-arrow \target menu-arrow-sub
        \li The arrow of a QToolButton with a menu.
 
    \row
        \li \c ::menu-button \target menu-button-sub
        \li The menu button of a QToolButton.
 
    \row
        \li \c ::menu-indicator \target menu-indicator-sub
        \li The menu indicator of a QPushButton.
 
    \row
        \li \c ::right-arrow \target right-arrow-sub
        \li The right arrow of a QMenu or a QScrollBar.
 
    \row
        \li \c ::pane \target pane-sub
        \li The pane (frame) of a QTabWidget.
 
    \row
        \li \c ::right-corner \target right-corner-sub
        \li The right corner of a QTabWidget. For example, this control can be
           used to control the position the right corner widget in a QTabWidget.
 
    \row
        \li \c ::scroller \target scroller-sub
        \li The scroller of a QMenu or QTabBar.
 
    \row
        \li \c ::section \target section-sub
        \li The section of a QHeaderView.
 
    \row
        \li \c ::separator \target separator-sub
        \li The separator of a QMenu or in a QMainWindow.
 
    \row
        \li \c ::sub-line \target sub-line-sub
        \li The button to subtract a line of a QScrollBar.
 
    \row
        \li \c ::sub-page \target sub-page-sub
        \li The region between the handle (slider) and the \l{#sub-line-sub}{sub-line}
           of a QScrollBar.
 
    \row
        \li \c ::tab \target tab-sub
        \li The tab of a QTabBar or QToolBox.
 
    \row
        \li \c ::tab-bar \target tab-bar-sub
        \li The tab bar of a QTabWidget. This subcontrol exists only to
           control the position of the QTabBar inside the QTabWidget. To
           style the tabs using the \l{#tab-sub}{::tab} subcontrol.
 
    \row
        \li \c ::tear \target tear-sub
        \li The tear indicator of a QTabBar.
 
    \row
        \li \c ::tearoff \target tearoff-sub
        \li The tear-off indicator of a QMenu.
 
    \row
        \li \c ::text \target text-ps
        \li The text of a QAbstractItemView.
 
    \row
        \li \c ::title \target title-sub
        \li The title of a QGroupBox or a QDockWidget.
 
    \row
        \li \c ::up-arrow \target up-arrow-sub
        \li The up arrow of a QHeaderView (sort indicator), QScrollBar
           or a QSpinBox.
 
    \row
        \li \c ::up-button \target up-button-sub
        \li The up button of a QSpinBox.
 
    \endtable
 
    See \l{Customizing the QPushButton's Menu Indicator Sub-Control}
    for an example of how to customize a subcontrol.
    */