【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全

马肤

温馨提示:这篇文章已超过448天没有更新,请注意相关的内容是否还可用!

【QT】本文介绍了QSS样式表的使用方法,包括详细的用例说明。内容全面,涵盖了QSS样式表的基本语法、属性和用法,旨在帮助读者更好地理解和应用QSS样式表,提升开发效率和用户体验。摘要字数控制在100-200字以内。

目录

  • 1. Qt样式表语法
  • 2. 选择器
    • 2.1 可设置样式的部件
    • 2.2 选择器类型
    • 2.3 子控件
    • 2.4 伪状态
    • 3. 属性列表
    • 4. 冲突解决
    • 5. QSS示例
    • 6. 如何为全局添加QSS样式(全局加载QSS的方法)

      1. Qt样式表语法

      Qt样式表支持各种属性、伪状态和子控件,可以自定义小部件的外观。

              selector { attribute: value }
              selector:选择器,如 QWidget、QPushButton、QGroupBox等
              attribute:属性,如color、background-color、border、padding等
              value:值,与属性对应
      

      2. 选择器

      2.1 可设置样式的部件

      Widget如何设置
      QWidget只支持background, background-clip和background-origin属性。
      如果你继承于QWidget,那么你需要为你自定义的QWidget提供一个paintEvent,如下所示:
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第1张
      如果没有进行QSS样式表设置,上面的代码就是一个空操作
      注意:请确保自定义小部件定义了Q_OBJECT宏。
      QAbstractScrollArea支持box model
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第2张
      margin、border-width和padding属性都默认为0。在这种情况下,所有四个矩形(边距、边框、填充和内容)都完全重合。
      QCheckBox支持盒子模型。检查指示器可以使用::indicator子控件样式化。默认情况下,指示器被放置在左边。spacing属性指定检查指示器和文本之间的间距。
      QColumnView可以使用image属性进行样式化。箭头指示器可以使用 ::left-arrow子控件和 ::right-arrow 子控件进行样式化
      QComboBoxcombobox周围的框架可以使用box model设置样式。下拉按钮可以使用::drop-down子控件设置样式。默认情况下,下拉按钮放置在小部件的内边距矩形的右边。下拉按钮内的箭头标记可以使用::down-arrow子控件设置样式。默认情况下,箭头放置在下拉子控件的内容矩形的中心。
      QDateEdit看QSpinBox
      QDateTimeEdit看QSpinBox
      QDialogQDialog继承于QWidget,看QWidget
      QDialogButtonBox可以使用button-layout属性更改按钮的布局。
      QDockWidget停靠时支持标题栏和标题栏按钮的样式化。可以使用border属性对dock小部件边框进行样式化。::title子控件可用于自定义标题栏。关闭和浮动按钮分别使用::close按钮和::float按钮相对于::title子控件进行定位。当标题栏垂直时,设置:vertical伪类。另外,根据QDockWidget::DockWidgetFeature,设置了:closable,:floatable和:movable伪状态。
      QDoubleSpinBox看QSpinBox
      QFrame支持box model。从4.3开始,在QLabel上设置样式表会自动将QFrame:: framstyle属性设置为QFrame::StyledPanel。
      QGroupBox支持box model。标题可以使用::title子控件设置样式。默认情况下,标题的放置取决于QGroupBox::textAlignment。在可选QGroupBox的情况下,标题包括检查指示器。指示器使用::indicator子控件设置样式。spacing属性可以用来控制文本和指示符之间的间距。
      QHeaderView支持box model。头视图的部分使用::section子控件进行样式化。子控件部分支持:middle、:first、:last、:only-one、:next-selected、:previous-selected、:selected和:checked伪状态。排序指示器可以使用::up-arrow和 ::down-arrow 子控件进行样式化。
      QLabel支持box model。不支持:hover伪状态。从4.3开始,在QLabel上设置样式表会自动将QFrame:: framstyle属性设置为QFrame::StyledPanel。
      QLineEdit支持box model。选中项的颜色和背景分别使用selection-color和selection-background-color设置样式。可以使用lineedit-password-character属性设置密码字符的样式。可以使用lineedit-password-mask-delay更改密码掩码延迟。
      QListView支持box model。启用交替行颜色后,可以使用属性alternative -background-color设置交替行颜色的样式。选中项的颜色和背景分别使用selection-color和selection-background-color设置样式。选择行为由show-decoration-selected属性控制。使用::item子控件对QListView中的项进行更细的控制。
      QListWidget看QListView
      QMainWindow支持分隔符的样式化。使用QDockWidget时,QMainWindow中的分隔符使用::separator子控件进行样式化。
      QMenu单个项目使用::item子控件设置样式。除了通常支持的伪状态外,item子控件还支持:selected、:default、:exclusive和 :non-exclusive伪状态。可选菜单项的指示符使用::indicator子控件设置样式。分隔符使用::separator子控件设置样式。对于子菜单项,箭头标记使用::right-arrow 和::left-arrow设置样式。使用::scroller对滚动条进行样式化。撕裂式使用::tearoff。
      QMenuBarspacing属性指定菜单项之间的间距。使用::item子控件对单个项进行样式化。
      QMessageBoxmessage - box-text-interaction-flags属性可用于更改与消息框中的文本的交互。
      QProgressBar进度条的块可以使用::chunk子控件设置样式。该块显示在小部件的内容矩形上。如果进度条显示文本,请使用text-align属性来定位文本。不确定进度条有:Indeterminate伪状态设置。
      QPushButton支持:default、:flat、:checked伪状态。从5.15开始,icon属性可以被设置为覆盖按钮图标。对于带有菜单的QPushButton,菜单指示器使用::menu-indicator子控件样式化。可检查按钮的外观可以使用:open和:closed伪状态定制。
      警告:如果你只在一个QPushButton上设置了背景色,背景可能不会出现,除非你设置了border属性为某个值。这是因为,在默认情况下,QPushButton绘制了一个与背景色完全重叠的本机边框。例如:
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第3张
      QRadioButton检查指示器可以使用::indicator子控件样式化。默认情况下,指示器被放置在小部件Contents矩形的左上角。spacing属性指定检查指示器和文本之间的间距。
      QScrollBar窗口组件的内容矩形被认为是滑块移动的槽。QScrollBar的范围(即宽度或高度,取决于方向)分别使用width或height属性设置。要确定方向,可以使用:horizontal和:vertical伪状态。可以使用::handle子控件设置滑块的样式。设置min-width或min-height可以根据方向为滑块提供尺寸约束。
      ::add-line子控件可用于设置按钮的样式以添加行。默认情况下,add-line子控件放置在小部件边框矩形的右上角,取决于::right-arrow 或 ::down-arrow. 。默认情况下,箭头放置在添加行子控件的Contents矩形的中心。
      :: subline子控件可用于设置按钮的样式以减去一行。默认情况下,subline子控件放置在小部件边框矩形的右下角,取决于::left-arrow 或 ::up-arrow。默认情况下,箭头放置在子行子控件的Contents矩形的中心。:: subpage子控件可用于设置滑块减去页面的区域的样式。::add-page子控件可用于设置添加页面的滑块区域的样式。
      QSizeGrip支持 width、height和image 属性。
      QSlider对于水平滑动,必须提供 min-width和 height属性。对于垂直滑块,必须提供min-height和width属性。滑块的凹槽采用::groove样式。默认情况下,凹槽位于小部件的内容矩形中。滑块的头部使用::handle子控件设置样式。子控件在槽子控件的内容矩形中移动。
      QSpinBox向上按钮和箭头可以使用::up-button和::up-arrow子控件设置样式。默认情况下,向上按钮放置在小部件的内边距矩形的右上角。如果没有明确的尺寸,它将占据其参考矩形高度的一半。向上箭头放置在向上按钮的内容矩形的中心。可以使用::down-button和::down-arrow子控件为down按钮和箭头设置样式。默认情况下,down按钮放置在小部件的内边距矩形的右下角。如果没有明确的尺寸,它将占据其参考矩形高度的一半。底部箭头放置在底部按钮的内容矩形的中心。
      QSplitter分割器的句柄使用::handle子控件进行样式化
      QStatusBar只支持background属性。可以使用::item子控件对单个项的框架进行样式化。
      QTabBar单个选项卡可以使用::tab子控件设置样式。选项卡支持:only-one、:first、:last、:middle、:previous--selected、:next-selected、:selected等伪状态。:top、:left、:right、:bottom伪状态取决于选项卡的方向。选择状态的重叠制表符可以使用负边距或绝对位置模式创建。QTabBar的撕裂指示器使用::tear子控件进行样式设置。QTabBar为它的滚动条使用了两个QToolButton,可以使用QTabBar QToolButton选择器设置样式。要指定滚动按钮的宽度,可以使用::scroller子控件。QTabBar中选项卡的对齐方式使用alignment属性设置样式。要更改QTabBar在QTabWidget中的位置,请使用tab-bar子控件(并设置subcontrol-position)。
      QTabWidget选项卡部件的框架使用::pane子控件设置样式。左角和右角分别使用::left-corner和::right-corner设置样式。tab bar的位置由::tab-bar子控件控制。默认情况下,子控件具有QTabWidget在QWindowsStyle中的位置。要将QTabBar放在中间,请设置tab-bar子控件的subcontrol-position。:top、:left、:right、:bottom伪状态取决于选项卡的方向。.
      QTableView启用交替行颜色后,可以使用属性alternative-background-color设置交替行颜色的样式。选中项的颜色和背景分别使用selection-color和selection-background-color设置样式。QTableView中的拐角部件是作为QAbstractButton实现的,可以使用“QTableView QTableCornerButton::section”选择器设置样式。
      警告:如果你只在QTableCornerButton上设置了背景色,背景可能不会出现,除非你设置border属性为某个值。这是因为,在默认情况下,QTableCornerButton绘制了一个完全重叠背景色的本机边框。网格的颜色可以使用gridline-color属性指定。
      QTextEdit所选文本的颜色和背景分别使用selection-color和selection-background-color进行样式化。.
      QTimeEdit看QSpinBox
      QToolBar:top, :left, :right, :bottom伪状态取决于工具栏所在的分组区域。:first,:last,:middle,:only-one伪状态指示工具栏在一个行组中的位置(参见QStyleOptionToolBar::positionWithinLine)。QToolBar的分隔符使用::separator子控件设置样式。手柄(移动工具栏)使用::handle子控件设置样式。
      QToolButton如果QToolButton有菜单,则可以使用::menu-indicator子控件来设置指示器的样式。默认情况下,菜单指示符位于widget的内边距矩形的右下角。如果QToolButton处于QToolButton::MenuButtonPopup模式,则使用::menu-button子控件来绘制菜单按钮。::menu-arrow子控件用于在菜单按钮内绘制菜单箭头。默认情况下,它位于menu-button子控件内容矩形的中心。当QToolButton显示箭头时,将使用::up-arrow、::down-arrow、::left-arrow和::right-arrow子控件。
      警告:如果你只在QToolButton上设置了背景色,背景将不会出现,除非你设置border属性为某个值。这是因为,在默认情况下,QToolButton绘制了一个与背景颜色完全重叠的本机边框。例如:
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第4张
      QToolBox可以使用::tab子控件对单个选项卡进行样式化。选项卡支持:only-one、:first、:last、:middle、:previous-selected、:next-selected、:selected伪状态。
      QToolTipopacity属性控制工具提示的不透明度。
      QTreeView当设置交替行颜色 enabled后,可以使用属性alternative -background-color设置交替行颜色的样式。选中项的颜色和背景分别使用selection-color和selection-background-color设置样式。选择行为由show-decoration-selected属性控制。树视图的分支可以使用::branch子控件设置样式。::branch子控制支持:open、:closed、:has-sibling和:has-children伪状态。使用::item子控件对QTreeView中的项进行更细粒度的控制。
      QTreeWidget看QTreeView

      2.2 选择器类型

      选择器示例说明
      通用选择器*匹配所有部件
      类型选择器QPushButton匹配所有QPushButton示例及它的所有子类
      属性选择器QPushButton[flat = “false”]匹配QPushButton的属性flat为false的示例
      类选择器.QPushButton匹配所有QPushButton示例,但不包括它的子类
      ID选择器QPushButton#myButton匹配所有QPushButton中myButton对象的实例
      后代选择器QDialog QPushButton匹配所有QPushButton实例,它们必须是QDialog的子孙部件
      孩子选择器QDialog>QPushButton匹配所有QPushButton实例,它们必须是QDialog直系孩子部件

      2.3 子控件

      子控件是双冒号"::"

      对于一些复杂的部件修改样式,可能需要访问它们的子部件,如QComboBox的下拉按钮,QSpinBox的向上、向下箭头灯。

      如:下拉按钮设置图片属性:QComboBox::drop-down{image:url(dropdown.png)}

      子控件描述
      ::add-line在QScrollBar中跳转下一行的按钮
      ::add-page在QScrollBar中滑动条和add-line之间的区域
      ::branch在QTreeView中的分支指示器
      ::chunk在QProgressBar中的进度块
      ::close-button在QDockWidget或QTabBar选项卡的关闭按钮
      ::corner在QAbstractScrollArea中两个滚动条之间的角落
      ::down-arrow在QComboBox、QHeaderView(排序指示器)、QScrollBar或QSpinBox的向下箭头
      ::down-button在QScrollBar或QSpinBox中的向下按钮
      ::drop-down在QComboBox中的下拉框
      ::float-button在QDockWidget中的浮动按钮
      ::groove在QSlider中的滑动槽
      ::indicator在QAbstractItemVIew、QCheckBox、QRadioButton、可选中的菜单项或可选中的QGroupBox中的指示器
      ::handle在QScrollBar、QSplitter和QSlider中的操作条(滑动条)
      ::icon在QAbstractItemVIew或QMenu中的图标
      ::item在QAbstractItemVIew、QMenuBar、QMenu或QStatuBar中的一项
      ::left-arrow在QScrollBar中的向左箭头
      ::left-corner在QTabWidget中的左上角
      ::menu-arrow带有菜单的QToolButton中的箭头
      ::menu-button在QToolButton中的菜单按钮
      ::menu-indicator在QPushButton中的菜单指示器
      ::right-arrow在QMenu或QScrollBar中的向右箭头
      ::pane在QTabWidget中的边或框
      ::right-corner在QTabWidget中的右上角
      ::scroller在QMenu或QTabBar中的滚动条
      ::section在QHeaderView中的区块
      ::separator在QMenu或QMainWIndow中分隔条
      ::sub-line在QScrollBar中跳转上一行的按钮
      ::sub-page在QScrollBar中滑动条和sub-line之间的区域
      ::tab在QTabBar或QToolBox中选项卡
      ::tab-bar在QTabWidget中的选项卡栏
      ::tear在QTabBar中的tear指示器
      ::tearoff在QMenu中的tear-off指示器
      ::text在QAbstractItemView中的文本
      ::title在QGroupBox或QDockWidget中的标题栏
      ::up-arrow在QComboBox、QHeaderView(排序指示器)、QScrollBar或QSpinBox的向上箭头
      ::up-button在QScrollBar或QSpinBox中的向上按钮

      2.4 伪状态

      伪状态使用单冒号":"

      1. 选择器可以使用状态来限制在部件的指定状态上的应用。伪状态在选择器之后,用冒号隔离。如:

        鼠标悬停在按钮上时其按钮的颜色为白色:QPushButton:hover{color:white}

        鼠标不悬停在按钮上时其按钮的颜色为l蓝色(!表否定):QPushButton:!hover{color:blue}

      2. 伪状态可多个连用,达到逻辑与效果。如:

        鼠标悬停在一个被选中的QCheckBox部件上时才应用规则:QCheckBox:hover:checked{color:white}

      3. 伪状态可通过逗号达到逻辑或效果。如:QCheckBox:hover,checked{color:white}
      4. 伪状态和子部件联合使用。如:QComboBox::drop-down:hover{image:url(dropdown_bright.png)}
      伪状态描述
      :active此状态在小部件驻留在活动窗口时设置
      :adjoins-item此状态在QTreeView的::branch与一个item相邻时设置
      :alternate当QAbstractItemView::alternatingRowColors()设置为真时,在绘制QAbstractItemView的行时,为每个交替行设置此状态
      :bottom此item位于底部。例如,QTabBar有位于底部的选项卡
      :checked此item被选中。例如,QAbstractButton的checked状态
      :closable此item可以被关闭。例如,QDockWidget的QDockWidget::DockWidgetClosable特性开启时
      :closed此item处于关闭状态。例如,QTreeView中未展开的item
      :default此item的默认状态。例如,一个default的QPushButton或QMenu中的一个默认动作
      :disabled此item被禁用时的状态
      :editable如QComboBox是可编辑的
      :edit-focus此item具有编辑焦点(参考QStyle::State_HasEditFocus)。此状态仅对Qt扩展应用程序可用
      :enabled此item已启用
      :exclusive此item是一个独占项组的一部分。例如,独占QActionGroup中的菜单项
      :first此item是列表中的第一项。例如,QTabBar中的第一个选项卡
      :flat此item是平的。例如,一个扁平的QPushButton
      :floatable此item可以浮动。例如,QDockWidget的QDockWidget::DockWidgetFloatable的特性开启时
      :focus此item具有输入焦点
      :has-children此item具有子对象。例如,QTreeView中具有子项的项
      :has-sibling此item具有兄弟对象。例如,QTreeView中与之相邻的项
      :horizontal此item处于水平方向
      :hover鼠标悬浮在此item上
      :indeterminate此item处于不确定状态。例如,QCheckBox或QRadioButton被部分选中
      :last此item是列表中的最后一项。例如,QTabBar中的最后一个选项卡
      :left此item位于左侧。例如,QTabBar有位于左侧的选项卡
      :maximized此item处于最大化状态。例如,一个最大化的QMdiSubWindow
      :middle此item是列表中的中间一项。例如,一个不在QTabBar中的开头或结尾的选项卡
      :minimized此item处于最小化状态。例如,一个最小化的QMdiSubWindow
      :movable此item可以被移动。例如, QDockWidget的QDockWidget::DockWidgetMovable特性开启时
      :no-frame此item没有边框。例如,没有边框的QSpinBox或QLineEdit
      :non-exclusive此item是一个非独占项组的一部分。例如,非独占QActionGroup中的菜单项
      :off对可以切换的items,这适用于处于off状态的item
      :on对可以切换的items,这适用于处于on状态的widget
      :only-one此item是列表中的唯一的一项。例如,一个在QTabBar中单独的选项卡
      :open此item处于打开状态。例如,QTreeView中的展开项,或带有菜单的QComboBox或QPushButton
      :next-selected此item是列表中的下一个被选中的项。例如,在QTabBar中当前选项卡的下一个要选中的选项卡
      :pressed鼠标正在按压在此item上
      :previous-selected此item是列表中的上一个被选中的项。例如,在QTabBar中当前选项卡的上一个要选中的选项卡
      :read-only此item处于只读或不可编辑状态。例如,一个只读QLineEdit或不可编辑的QComboBox
      :right此item位于右侧。例如,QTabBar有位于右侧的选项卡
      :selected此item处于选中状态。例如,一个在QTabBar中被选中的选项卡或一个在菜单中被选中的菜单项
      :top此item位于顶部。例如,QTabBar有位于顶部的选项卡
      :unchecked此item处于未被选中状态
      :vertical此item处于垂直方向
      :window小部件是一个窗口(例如,一个顶层小部件)

      3. 属性列表

      QSS官方参考

      对于不理解的地方可以参考CSS:CSS参考手册(里面有测试,可以很直观的看到不同属性值的区别)

      attribute属性类型描述
      alternate-background-colorBrush交替背景色。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第5张
      backgroundBackground背景,相当于指定background-color、background-image、background-repeat和background-position。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第6张
      background-colorBrush背景颜色,例如:
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第7张
      background-imageUrl背景图像(图像的半透明部分会被背景颜色穿透)。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第8张
      background-repeatRepeat背景图像如何充满背景矩形,如果未指定此属性,背景图像将在两个方向上重复(repeat)。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第9张
      background-positionAlignment背景图像在背景原点矩形内的对齐。如果未指定此属性,则对齐方式为左上角。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第10张
      background-attachmentAttachment背景图像是否相对于视口进行滚动或固定。默认情况下,背景图像随视口滚动。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第11张
      background-clipOrigin规定背景的绘制区域。如果未指定此属性,则默认为border。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第12张
      border:背景被裁剪到边框盒
      padding:背景被裁剪到内边距框
      content:背景被裁剪到内容框
      background-originOrigin背景图像相对于什么来定位。如果未指定此属性,则默认为 padding 填充。
      padding:背景图像相对于内边距框来定位
      border:背景图像相对于边框盒来定位
      content:背景图像相对于内容框来定位
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第13张
      borderBorder设置 4 个边框的样式,按照一下顺序进行设置:border-width,border-style,border-color。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第14张
      border-topBorder顶部边框
      border-bottomBorder底部边框
      border-rightBorder右边边框
      border-leftBorder左边边框
      border-colorBox Colors边框的颜色。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第15张
      border-top-colorBrush边框上边缘颜色
      border-bottom-colorBrush边框下边缘颜色
      border-right-colorBrush边框右边缘颜色
      border-left-colorBrush边框左边缘颜色
      border-imageBorder Image填充边框的图像
      border-radiusRadius边角的半径,即边角圆弧。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第16张
      border-top-left-radiusRadius左上角圆弧
      border-top-right-radiusRadius右上角圆弧
      border-bottom-right-radiusRadius右下角圆弧
      border-bottom-left-radiusRadius左下角圆弧
      border-styleBorder Style边框边缘的样式,若未指定默认为none。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第17张
      border-top-styleBorder Style边框上边缘的样式
      border-bottom-styleBorder Style边框下边缘的样式
      border-right-styleBorderStyle边框右边缘的样式
      border-left-styleBorderStyle边框左边缘的样式
      border-widthBox Lengths边框的宽度。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第18张
      border-top-widthBox Lengths上边框的宽度
      border-bottom-widthBox Lengths下边框的宽度
      border-right-widthBox Lengths右边框的宽度
      border-left-widthBox Lengths左边框的宽度
      bottomLength在部件边底部其子控件向上的偏移量,即元素与底部边缘的距离。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第19张
      topLength在部件边顶部其子控件向下的偏移量,即元素与顶部边缘的距离。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第20张
      rightLength在部件右边其子控件向左的偏移量,即元素与右边缘的距离。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第21张
      leftLength在部件左边其子控件向右的偏移量,即元素与左边缘的距离。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第22张
      button-layoutNumberQDialogButtonBox或QMessageBox中的按钮布局。取值为0 (WinLayout)、1 (MacLayout)、2 (KdeLayout)、3 (GnomeLayout)和5 (AndroidLayout)。如果未指定此属性,它默认为SH_DialogButtonLayout样式提示的当前样式所指定的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第23张
      colorBrush渲染文本的颜色,默认值为黑色。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第24张
      dialogbuttonbox-buttons-have-iconsBooleanQDialogButtonBox中的按钮是否显示图标如果这个属性被设置为1,QDialogButtonBox的按钮显示图标;如果设置为0,则不显示图标。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第25张
      fontFont设置字体。相当于指定font-family、font-size、font-style和/或font-weight。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第26张
      font-familyString字体类型。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第27张
      font-sizeFont Size字体大小。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第28张
      font-styleFont Style字体风格(倾斜)。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第29张
      font-weightFont Weight字体的粗细。
      gridline-color*ColorQTableView中网格线的颜色。如果没有指定此属性,它默认为SH_Table_GridLineColor样式提示的当前样式所指定的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第30张
      heightLength子部件的高度。如果希望小部件具有固定的高度,请将min-height和max-height设置为相同的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第31张
      widthLength子控件(在某些情况下是小部件)的宽度。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第32张
      iconUrl+所使用的图标,用于具有图标的小部件。目前唯一支持此属性的小部件是QPushButton。
      icon-sizeLength小部件中图标的宽度和高度。可以使用此属性设置以下小部件的图标大小:QCheckBox、QListView、QPushButton、QRadioButton、QTabBar、QToolBar、QToolBox、QTreeView。
      image*Url+在子控件的内容矩形中绘制图像。image属性接受一个url列表或者一个svg。绘制的实际图像使用与QIcon相同的算法。图像从不放大,但在必要时总是缩小。如果指定了svg,则图像会被缩放为内容矩形的大小。警告:渲染SVG图像需要QIcon SVG插件。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第33张
      隐式设置down-button的大小为spindown.png的大小
      image-positionAlignment图像位置的对齐方式
      lineedit-password-character*NumberQLineEdit密码字符作为Unicode数字。如果没有指定此属性,它默认为SH_LineEdit_PasswordCharacter样式提示的当前样式所指定的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第34张
      lineedit-password-mask-delay*Number在lineedit-password-character应用到可见字符之前,QLineEdit密码掩码延迟毫秒。如果未指定此属性,它默认为SH_LineEdit_PasswordMaskDelay样式提示的当前样式所指定的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第35张
      marginBox Lengths设置元素的4个外边距。相当于指定margin-top、margin-right、margin-bottom和margin-left。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第36张
      margin-topLength上边距
      margin-rightLength右边距
      margin-bottomLength下边距
      margin-leftLength左边距
      max-heightLength小部件或子控件(例如Item)的最大高度。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第37张
      max-widthLength小部件或子控件(例如Item)的最大宽度。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第38张
      min-heightLength小部件或子控件(例如Item)的最小高度。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第39张
      min-widthLength小部件或子控件(例如Item)的最小宽度。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第40张
      messagebox-text-interaction-flags*Number消息框中文本的交互行为。可能的值基于Qt::TextInteractionFlags。如果未指定此属性,则默认为SH_MessageBox_TextInteractionFlags样式提示的当前样式所指定的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第41张
      opacity*Number小部件的不透明度。取值范围为0(透明)~ 255(不透明)。目前,这只支持tooltips。如果未指定此属性,它默认为SH_ToolTipLabel_Opacity样式提示的当前样式指定的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第42张
      outline边框的轮廓
      outline-colorColor轮廓的颜色
      outline-offsetLength轮廓与小部件边界的偏移量
      outline-style指定用于绘制轮廓的模式
      outline-radius在轮廓中添加圆角
      outline-bottom-left-radiusRadius轮廓左下角的圆角
      outline-bottom-right-radiusRadius轮廓右下角的圆角
      outline-top-right-radiusRadius轮廓右上角的圆角
      outline-top-left-radiusRadius轮廓左上角的圆角
      paddingBox Lengths小部件的填充。相当于指定填充顶部、填充右侧、填充底部和填充左侧。如果未指定此属性,则默认为0。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第43张
      padding-topLength顶部填充
      padding-rightLength右侧填充
      padding-bottomLength底部填充
      padding-leftLength左侧填充
      paint-alternating-row-colors-for-empty-areaboolQTreeView是否为空区域(即没有项目的区域)绘制交替的行色
      posotionrelative | absolute使用左、右、上和下指定的偏移量是相对坐标还是绝对坐标。如果未指定此属性,则默认为relative。
      selection-background-color*Brush所选文本或项的背景。如果未设置此属性,则默认值是为调色板palette的Highlight角色设置的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第44张
      selection-color*Brush所选文本或项的前景。如果未设置此属性,则默认值是为调色板palette的HighlightedText角色设置的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第45张
      show-decoration-selected*Boolean控制QListView中的选择是覆盖整行还是仅覆盖文本的范围。如果未指定此属性,它默认为SH_ItemView_ShowDecorationSelected样式提示的当前样式指定的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第46张
      spacing*Length小部件中的内部间距。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第47张
      subcontrol-origin*Origin父元素中子控件的起始矩形。如果未指定此属性,则默认为填充。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第48张
      subcontrol-position*Alignment子控件在subcontrol-origin指定的原点矩形内的对齐。如果未指定此属性,则默认为依赖于子控件的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第49张
      titlebar-show-tooltips-on-buttonsbool工具提示是否显示在窗口标题栏按钮上。
      widget-animation-duration*Number动画应该持续多长时间(以毫秒为单位)。值等于零意味着动画将被禁用。如果没有指定此属性,它默认为SH_Widget_Animation_Duration样式提示的当前样式指定的值。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第50张
      text-alignAlignment小部件内容中的文本和图标的对齐方式。
      【QT】史上最全最详细的QSS样式表用法及用例说明,QT,QSS样式表用法详解及案例大全 第51张
      text-decorationnone
      underline
      overline
      line-through
      附加文本效果
      -qt-background-rolePaletteRole基于所选角色的子控件或小部件的背景色。
      -qt-style-featureslist要在其上应用特定于qt的样式的CSS属性列表。注意:列表只能包含非基于像素图的属性。

      4. 冲突解决

      几个样式规则对相同的属性指定不同的值时会产生冲突。如

      QPushButton#okButton{color:gray}
      QPushButton{color:red}
      

      冲突原则:特殊的选择器优先。此例中QPushButton#okButton代表的是单一对象,而不是一个类的所有实例,所以okButton的文本颜色会是灰色的。同样的有伪状态的比没有伪状态的优先。

      5. QSS示例

      点这里:QSS用例显示

      6. 如何为全局添加QSS样式(全局加载QSS的方法)

      在Resource文件中添加qss文件,构造函数中直接调用

      void MainWindow::loadStyleSheet(const QString &styleSheetFile){  //styleSheetFile是qss文件的Path
      	QFile file(styleSheetFile);
      	if(file.open(QFile::ReadOnly)){
      		//如果在MainWindow使用了setStyleSheet,对qss文件的内容进行追加
      		//QString styleSheet = this->styleSheet();
      		//styleSheet += QLatin1String(file.readAll());//读取样式表文件
      		QString styleSheet = QLatin1String(file.readAll());  //QByteArray可直接转换为QString
          	this->setStyleSheet(styleSheet);
          	file.close();
      	}else{
      		QMessageBox::information(this,"tip","Failed to open file");
      	}
      }
      

      注意:

      1. 对同一个对象调用多次setStyleSheet,先前的设置将无效,只有最后设置的才会生效。
      this->setStyleSheet(styleSheet1);
      this->setStyleSheet(styleSheet2);  //styleSheet1中的所有设置完全失效,使用styleSheet2的定义
      
      1. 若是不同的对象,可以在函数中多次调用setStyleSheet是可以的,是对不同的对象进行样式设置,但是对同一对象多次调用setStyleSheet,最后设置的才有效。例如:
      //对不同的对象进行样式设置
      QDialog dia1;
      QDialog dia2;
      dia1.setStyleSheet(styleSheet1);
      dia2.setStyleSheet(styleSheet2);
      
      //对同一对象dia1调用setStyleSheet,只有最后调用的setStyleSheet才有效,即styleSheet2会覆盖掉styleSheet1,使得styleSheet2设置成功
      QDialog dia1;
      dia1.setStyleSheet(styleSheet1);
      dia1.setStyleSheet(styleSheet2);
      

0
收藏0
文章版权声明:除非注明,否则均为VPS857原创文章,转载或复制请以超链接形式并注明出处。

相关阅读

  • 【研发日记】Matlab/Simulink自动生成代码(二)——五种选择结构实现方法,Matlab/Simulink自动生成代码的五种选择结构实现方法(二),Matlab/Simulink自动生成代码的五种选择结构实现方法详解(二)
  • 超级好用的C++实用库之跨平台实用方法,跨平台实用方法的C++实用库超好用指南,C++跨平台实用库使用指南,超好用实用方法集合,C++跨平台实用库超好用指南,方法与技巧集合
  • 【动态规划】斐波那契数列模型(C++),斐波那契数列模型(C++实现与动态规划解析),斐波那契数列模型解析与C++实现(动态规划)
  • 【C++】,string类底层的模拟实现,C++中string类的模拟底层实现探究
  • uniapp 小程序实现微信授权登录(前端和后端),Uniapp小程序实现微信授权登录全流程(前端后端全攻略),Uniapp小程序微信授权登录全流程攻略,前端后端全指南
  • Vue脚手架的安装(保姆级教程),Vue脚手架保姆级安装教程,Vue脚手架保姆级安装指南,Vue脚手架保姆级安装指南,从零开始教你如何安装Vue脚手架
  • 如何在树莓派 Raspberry Pi中本地部署一个web站点并实现无公网IP远程访问,树莓派上本地部署Web站点及无公网IP远程访问指南,树莓派部署Web站点及无公网IP远程访问指南,本地部署与远程访问实践,树莓派部署Web站点及无公网IP远程访问实践指南,树莓派部署Web站点及无公网IP远程访问实践指南,本地部署与远程访问详解,树莓派部署Web站点及无公网IP远程访问实践详解,本地部署与远程访问指南,树莓派部署Web站点及无公网IP远程访问实践详解,本地部署与远程访问指南。
  • vue2技术栈实现AI问答机器人功能(流式与非流式两种接口方法),Vue2技术栈实现AI问答机器人功能,流式与非流式接口方法探究,Vue2技术栈实现AI问答机器人功能,流式与非流式接口方法详解
  • 发表评论

    快捷回复:表情:
    评论列表 (暂无评论,0人围观)

    还没有评论,来说两句吧...

    目录[+]

    取消
    微信二维码
    微信二维码
    支付宝二维码