Qt样式表参考

阳光穿透心脏的1/2处 2022-10-09 04:50 202阅读 0赞

Qt样式表支持各种属性、伪状态和子控件，使得定制小部件的外观成为可能。

### 可设置样式的小部件列表 ###

下表列出了可以使用样式表自定义的Qt小部件：

<table> 
 <tbody> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QT控件</td> 
 <td style="text-align:left;vertical-align:middle;">如何设置样式</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QAbstractScrollArea</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。 QAbstractScrollArea的所有衍生物，包括QTextEdit和QAbstractItemView(所有的项目视图类)，支持使用背景附件滚动背景。将背景附件设置为fixed将提供一个不随视口滚动的背景图像。将背景附件设置为滚动，当滚动条移动时滚动背景图像。 有关示例，请参见自定义QAbstractScrollArea。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QCheckBox</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。检查指示灯可以使用::指示灯子控制风格。默认情况下，该指示器位于小部件Contents矩形的左上角。 spacing属性指定检查指示器和文本之间的间距。 请参阅自定义QCheckBox的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QColumnView</td> 
 <td style="text-align:left;vertical-align:middle;">手柄可以使用image属性进行样式设置。&nbsp;箭头指示器可以使用::左箭头子控件和::右箭头子控件样式化。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QComboBox</td> 
 <td style="text-align:left;vertical-align:middle;">组合框周围的框架可以使用框模型进行样式化。 下拉按钮可以使用::下拉子控件设置样式。 默认情况下，下拉按钮位于小部件填充矩形的右上角。 下拉按钮内的箭头标记可以使用::向下箭头子控件样式化。 默认情况下，箭头放置在下拉子控件的内容矩形的中心。&nbsp; 参见自定义QComboBox的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QDateEdit</td> 
 <td style="text-align:left;vertical-align:middle;">参见QSpinBox.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QDateTimeEdit</td> 
 <td style="text-align:left;vertical-align:middle;">参见QSpinBox.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QDialog</td> 
 <td style="text-align:left;vertical-align:middle;">只支持background, background-clip和background-origin属性。 警告:确保您为自定义小部件定义了Q_OBJECT宏。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QDialogButtonBox</td> 
 <td style="text-align:left;vertical-align:middle;">可以使用button-layout属性更改按钮的布局。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QDockWidget</td> 
 <td style="text-align:left;vertical-align:middle;">当停靠时，支持标题栏和标题栏按钮的样式。 可以使用border属性设置停靠小部件边框的样式。::title子控件可用于自定义标题栏。close和float按钮分别使用::close-button和::float-button相对于::title子控件进行定位。 当标题栏是垂直的，则设置:vertical伪类。此外，根据QDockWidget::DockWidgetFeature，设置了:closeable、:float和:movable伪状态。 注意:使用QMainWindow::separator样式调整手柄。 警告:当QDockWidget未停靠时，样式表将无效，因为Qt在未停靠时使用本地顶级窗口。 参见自定义QDockWidget以获得示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QDoubleSpinBox</td> 
 <td style="text-align:left;vertical-align:middle;">参见QSpinBox.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QFrame</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。 从4.3开始，在QLabel上设置样式表会自动将QFrame::frameStyle属性设置为QFrame::StyledPanel。 有关示例，请参见自定义QFrame。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QGroupBox</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。标题可以使用::title子控件设置样式。默认情况下，标题的放置取决于QGroupBox:: textalign。 对于可检查的QGroupBox，标题包括检查指示器。指示灯使用::指示灯子控件样式。spacing属性可用于控制文本和指示符之间的间距。 有关示例，请参见自定义QGroupBox。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QHeaderView</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。头视图的节使用::section子控件样式化。子控制节支持:middle、:first、:last、:only-one、:next-selected、:previous-selected、:selected和:checked伪状态。 排序指示符可以使用::向上箭头和::向下箭头子控制样式。 参见自定义QHeaderView的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QLabel</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。不支持:hover伪状态。 从4.3开始，在QLabel上设置样式表会自动将QFrame::frameStyle属性设置为QFrame::StyledPanel。 请参阅自定义QFrame的示例(QLabel源自QFrame)。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QLineEdit</td> 
 <td style="text-align:left;vertical-align:middle;">支持盒模型。 所选项目的颜色和背景分别使用selection-color和selection-background-color进行样式化。 可以使用lineedit-password-character属性样式化密码字符。 可以使用lineedit-password-mask-delay修改密码掩码延迟 有关示例，请参见自定义QLineEdit。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QListView</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。当交替行颜色被启用时，可以使用alternate-background-color属性设置交替颜色的样式。 所选项目的颜色和背景分别使用selection-color和selection-background-color进行样式化。 选择行为由show-decoration-selected属性控制。 使用::item子控制对QListView中的项进行更细粒度的控制。 参见QAbsractScrollArea设置可滚动的背景。 请看自定义QListView的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QListWidget</td> 
 <td style="text-align:left;vertical-align:middle;">参见QListView.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QMainWindow</td> 
 <td style="text-align:left;vertical-align:middle;">支持分隔符的样式化 当使用QDockWidget时，QMainWindow中的分隔符使用::separator子控件进行样式化。 请参阅自定义QMainWindow的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QMenu</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。 单个项使用::item子控件样式化。除了通常支持的伪状态外，项子控件还支持:selected、:default、:exclusive和非exclusive伪状态。 可检查菜单项的指示符使用::指示符子控件样式化。 分隔符使用::分隔符子控件样式化。 对于带有子菜单的项，箭头标记使用右箭头和左箭头样式。 滚轮使用::滚轮样式。 撕掉的风格使用::撕掉。 有关示例，请参见自定义QMenu。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QMenuBar</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。spacing属性指定菜单项之间的间距。单个项使用::item子控件样式化。 警告:在Qt/Mac上运行时，菜单栏通常嵌入到系统范围的菜单栏中。在这种情况下，样式表将没有效果。 参见自定义QMenuBar以获得示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QMessageBox</td> 
 <td style="text-align:left;vertical-align:middle;">messagebox-text-interaction-flags属性可用于更改与消息框中的文本的交互。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QProgressBar</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。可以使用::chunk子控件样式化进度条的块。块显示在小部件的Contents矩形上。 如果进度条显示文本，则使用文本对齐属性来定位文本。 不确定进度条的状态设置为:不确定伪状态。 参见自定义QProgressBar的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QPushButton</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。支持:default，:flat，:checked伪状态。 对于带有菜单的QPushButton，菜单指示符使用::菜单指示符子控件样式化。可检查按钮的外观可以使用:打开和:关闭的伪状态进行定制。 警告:如果你只在QPushButton上设置背景色，背景可能不会出现，除非你将border属性设置为某个值。这是因为，默认情况下，QPushButton绘制一个完全与背景色重叠的本地边框。例如, QPushButton{背景色:红色;边界:没有;｝ 有关示例，请参见自定义QPushButton。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QRadioButton</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。检查指示灯可以使用::指示灯子控制风格。默认情况下，该指示器位于小部件Contents矩形的左上角。 spacing属性指定检查指示器和文本之间的间距。 请参阅自定义QRadioButton的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;"></td> 
 <td style="text-align:left;vertical-align:middle;"></td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;"></td> 
 <td style="text-align:left;vertical-align:middle;"></td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QScrollBar</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。小部件的Contents矩形被认为是滑块在其上移动的槽。QScrollBar的范围(即宽度或高度取决于方向)分别使用width或height属性设置。要确定方向，请使用:horizontal和:vertical伪状态。 滑块可以使用::handle子控件设置样式。设置最小宽度或最小高度将根据方向为滑块提供大小约束。 ::add-line子控件可用于设置按钮的样式以添加一行。默认情况下，add-line子控件放置在小部件的Border矩形的右上角。根据方向::右箭头或::向下箭头。默认情况下，箭头放置在附加行子控件的Contents矩形的中心。 sub-line子控件可用于设置按钮的样式以减去一行。默认情况下，子行子控件放置在小部件的Border矩形的右下角。根据方向::左箭头或::向上箭头。默认情况下，箭头放置在子行子控件的Contents矩形的中心。 子页面子控件可用于样式化减去页面的滑块区域。::add-page子控件可用于设置添加页面的滑块区域的样式。 请参阅自定义QScrollBar的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QSizeGrip</td> 
 <td style="text-align:left;vertical-align:middle;">支持宽度，高度和图像属性。 请参阅自定义QSizeGrip的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QSlider</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。对于水平滑块，必须提供最小宽度和高度特性。对于垂直滑块，必须提供最小高度和宽度属性。 滑块的槽采用::槽样式。槽默认位置在小部件的Contents矩形中。滑块的拇指使用::handle子控制样式。子控件在槽子控件的内容矩形中移动。 请参阅自定义QSlider的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QSpinBox</td> 
 <td style="text-align:left;vertical-align:middle;">旋转盒的框架可以使用盒模型进行设计。 向上按钮和箭头可以使用::向上按钮和::向上箭头子控件样式。默认情况下，向上按钮被放置在小部件的Padding矩形的右上角。如果没有明确的大小，它将占据参考矩形的一半高度。向上箭头位于向上按钮的内容矩形的中心。 向下按钮和箭头可以使用::向下按钮和::向下箭头子控件样式。默认情况下，向下按钮被放置在小部件的Padding矩形的右下角。如果没有明确的大小，它将占据参考矩形的一半高度。底部箭头位于底部按钮的Contents矩形的中心。 参见自定义QSpinBox的示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QSplitter</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。拆分器的句柄使用::handle子控件样式化。 有关示例，请参见自定义QSplitter。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QStatusBar</td> 
 <td style="text-align:left;vertical-align:middle;">只支持background属性。单个项的框架可以使用::item子控件进行样式化。 参见自定义QStatusBar以获得示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QTabBar</td> 
 <td style="text-align:left;vertical-align:middle;">单个制表符可以使用::制表符子控件进行样式设置。选项卡支持:only-one、:first、:last、:middle、:previous——selected、:next-selected、:selected伪状态。 根据选项卡的方向，:top，:left，:right，:bottom的伪状态。 选定状态的重叠制表符是通过使用负边距或使用绝对位置方案创建的。 QTabBar的撕裂指示器使用::tear子控件样式。 QTabBar使用了两个QToolButton滚动条，可以使用QTabBar QToolButton选择器进行样式化。要指定滚动按钮的宽度，请使用::滚动子控件。 QTabBar中选项卡的对齐使用对齐属性进行样式化。 警告: 要在QTabWidget中更改QTabBar的位置，请使用选项卡栏子控件(并设置子控件-position)。 有关示例，请参见自定义QTabBar。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QTabWidget</td> 
 <td style="text-align:left;vertical-align:middle;">选项卡小部件的框架使用::pane子控件进行样式化。左、右角分别为::左角和::右角。选项卡栏的位置使用::选项卡栏子控件来控制。 默认情况下，子控件在QWindowsStyle中有一个QTabWidget的位置。要将QTabBar放置在中心，请设置选项卡栏子控件的子控件位置。 根据选项卡的方向，:top，:left，:right，:bottom的伪状态。 参见自定义QTabWidget以获得示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QTableView</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。当交替行颜色被启用时，可以使用alternate-background-color属性设置交替颜色的样式。 所选项目的颜色和背景分别使用selection-color和selection-background-color进行样式化。 QTableView中的角落小部件被实现为一个QAbstractButton，并且可以使用“QTableView QTableCornerButton::section”选择器进行样式化。 警告:如果您只在QTableCornerButton上设置背景色，背景可能不会出现，除非您将border属性设置为某个值。这是因为，默认情况下，QTableCornerButton绘制一个完全与背景色重叠的本地边框。 网格的颜色可以使用gridline-color属性指定。 参见QAbsractScrollArea设置可滚动的背景。 请看自定义QTableView的例子。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QTableWidget</td> 
 <td style="text-align:left;vertical-align:middle;">参见QTableView.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QTextEdit</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。 所选文本的颜色和背景分别使用selection-color和selection-background-color进行样式化。 参见QAbsractScrollArea设置可滚动的背景。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QTimeEdit</td> 
 <td style="text-align:left;vertical-align:middle;">参见QSpinBox.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QToolBar</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。 :顶部、:左侧、:右侧、:底部的伪状态取决于工具栏分组的区域。 :first，:last，:middle，:only-一个伪状态指示了工具栏在行组中的位置(参见QStyleOptionToolBar::positionWithinLine)。 QToolBar的分隔符使用::separator子控件样式化。 句柄(用于移动工具栏)使用::handle子控件进行样式化。 有关示例，请参见自定义QToolBar。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QToolButton</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。 如果QToolButton有一个菜单，就是::菜单指示符子控件可以用来样式指示符。默认情况下，菜单指示器位于小部件的Padding矩形的右下角。 如果QToolButton处于QToolButton::MenuButtonPopup模式，则使用::menu-button子控件绘制菜单按钮。::菜单箭头子控件用于绘制菜单按钮内的菜单箭头。默认情况下，它位于菜单按钮子控件的Contents矩形的中心。 当QToolButton显示箭头时，使用::向上箭头，::向下箭头，::左箭头和::右箭头子控件。 警告:如果你只在QToolButton上设置背景色，背景将不会出现，除非你将border属性设置为某个值。这是因为，默认情况下，QToolButton绘制一个完全与背景色重叠的本地边框。例如, QToolButton{背景色:红色;边界:没有;｝ 参见自定义QToolButton以获得一个示例。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QToolBox</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。&nbsp; 可以使用::tab子控件样式化各个选项卡。 选项卡支持:only-one、:first、:last、:middle、:previous-selected、:next-selected、:selected伪状态。&nbsp;&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QToolTip</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。 不透明度属性控制工具提示的不透明度。&nbsp; 请参阅自定义QFrame的示例(QToolTip就是一个QFrame)。&nbsp;&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QTreeView</td> 
 <td style="text-align:left;vertical-align:middle;">支持Box模型。当交替行颜色被启用时，可以使用alternate-background-color属性设置交替颜色的样式。 所选项目的颜色和背景分别使用selection-color和selection-background-color进行样式化。 选择行为由show-decoration-selected属性控制。 可以使用::branch子控件样式化树视图的分支。::branch子控制支持:open，:closed，:has-sibling和:has-children伪状态。 使用::item子控件对QTreeView中的项进行更细粒度的控制。 参见QAbsractScrollArea设置可滚动的背景。 请参阅自定义QTreeView的示例来样式化分支。</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QTreeWidget</td> 
 <td style="text-align:left;vertical-align:middle;">参见QTreeView.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:127pt;">QWidget</td> 
 <td style="text-align:left;vertical-align:middle;">只支持background, background-clip和background-origin属性。 如果你继承了QWidget的子类，你需要为你的自定义QWidget提供一个paintEvent，如下所示: 空白CustomWidget:: paintEvent (QPaintEvent *) ｛ QStyleOption选择; opt.init(这个); QPainter p(这个); drawtext (QStyle::PE_Widget， &amp;opt， &amp;p, this); ｝ 如果没有样式表集，那么上面的代码是无操作的。 警告:确保您为自定义小部件定义了Q_OBJECT宏。</td> 
 </tr> 
 </tbody> 
</table>