样式规则

QSS包含了一个样式规则序列，一个样式规则由一个选择器和声明组成，选择器指定哪些部件由规则影响，声明指定哪些属性应该在部件上进行设置。例如：

QPushButton { color: red }

• 1

• 1

上面的例子中QPushButton是选择器，{ color: red }是声明，该规则指定QPushButton及其子类（例如：MyPushButton）应使用红色作为前景色。

QSS通常不区分大小写（即：color、Color、COLOR、cOloR指同一属性），唯一例外就是类名（class names）、对象名（object names）、属性名（property names）区分大小写。

几个选择器可以指定相同的声明，使用逗号（,）来分隔选择器。例如：

QPushButton, QLineEdit, QComboBox { color: red }

• 1

• 1

相当于三个规则序列：

1.  
   QPushButton { color: red }
2.  
   QLineEdit { color: red }
3.  
   QComboBox { color: red }

声明部分的规则是一个属性值对（property: value）列表，包含在花括号中，以分号分隔。例如：

QPushButton { color: red; background-color: white }

• 1

• 1

参考助手：Qt Style Sheets Reference中List of Properties部分。

选择器类型

目前为止，所有的示例使用选择器中最简单的类型，类型选择器。QSS支持所有的selectors defined in CSS2。下表总结了最有用的类型选择器。

子控件

对于样式复杂的部件，需要访问子控件，例如：QComboBox的下拉按钮或QSpinBox的上下箭头。选择器可能包含子控件，使得可以限制特有部件子控件的应用规则。例如：

QComboBox::drop-down { image: url(dropdown.png) }

• 1

• 1

上述规则指定了QComboBoxe下拉按钮样式，虽然双冒号（::）语法让人想起CSS3伪元素，但Qt子控件从概念上讲有不同的级联语义。

子控件定位总是相对于另一个参考元素。这个参考元素可能是小部件或其它子控件。例如：QComboBox的::drop-down放置，默认的放置在QComboBox区域的右上角，::drop-down放置，默认的在::drop-down子控件的*，参考助手：Qt Style Sheets Reference中List of Stylable Widgets部分。

可以使用subcontrol-origin改变子控件原始的默认位置，

1.  
   QComboBox {
2.  
   margin-right: 20px;
3.  
   }
4.  
   QComboBox::drop-down {
5.  
   subcontrol-origin: margin;
6.  
   }

下拉的对齐方式可以通过subcontrol-position属性改变。

width和height属性可用于控制子控件的大小，注意：设置一个图片会隐式地设置子控件的大小。

相对定位（position : relative）：可以改变子控件相对初始位置的偏移量。例如：按下QComboBox下拉按钮时，我们可能更喜欢用内部箭头偏移量来产生一个被按下的效果。要做到这一点，我们可以指定：

1.  
   QComboBox::down-arrow {
2.  
   image: url(down_arrow.png);
3.  
   }
4.  
   QComboBox::down-arrow:pressed {
5.  
   position: relative;
6.  
   top: 1px; left: 1px;
7.  
   }

绝对定位（position : absolute）：允许子控件改变位置和的大小而不受参考元素限制。一旦位置被设定，这些子控件将被和普通部件（widgets）视为相同，并且可以使用盒模型样式（参考助手：Customizing Qt Widgets Using Style Sheets中The Box Model部分）。

参考助手：Qt Style Sheets Reference中List of Sub-Controls部分，及Qt Style Sheets Examples中Customizing the QPushButton‘s Menu Indicator Sub-Control部分。

注意：对于复杂的部件，如：QComboBox和QScrollBar，如果一个属性或子控件被定制，所有其它属性或子控件必须被定制好。

伪选择器

选择器可以包含伪状态，意味着限制基于部件状态的应用程序规则。伪状态出现在选择器后面，用冒号（:）关联。例如，鼠标划过按钮：

QPushButton:hover { color: white }

• 1

• 1

伪状态可以用感叹号（!）运算符表示否定。例如，当鼠标不划过QRadioButton：

QRadioButton:!hover { color: red }

• 1

• 1

伪状态可以连接使用，这种情况下，相当于隐含了一个逻辑与。例如，当鼠标滑过选中的QCheckBox：

QCheckBox:hover:checked { color: white }

• 1

• 1

否定的伪状态也可以连接使用，例如，当鼠标划过一个非按下时按钮：

QPushButton:hover:!pressed { color: blue; }

• 1

• 1

如果需要，也可以使用逗号操作来表示逻辑或：

QCheckBox:hover, QCheckBox:checked { color: white }

• 1

• 1

伪状态也可以与子控件组合，例如：

QComboBox::drop-down:hover { image: url(dropdown_bright.png) }

• 1

• 1

参见助手：Qt Style Sheets Reference中List of Pseudo-States部分。

解决冲突

当样式中指定相同的属性具有不同的值时，就会出现冲突。例如：

1.  
   QPushButton#okButton { color: gray }
2.  
   QPushButton { color: red }

两个规则匹配objectName为okButton的QPushButton实例，color属性有冲突。要解决这个冲突，必须考虑到的选择器的特殊性。上面的例子，QPushButton＃okButton被认为比QPushButton更具体，因为它通常是指单个对象，而不是一类的所有实例。

同样的，利用伪状态比不指定伪状态那些选择器更具体。因此，下面的样式指定一个QPushButton应该有鼠标悬停文本白色，否则文本红色效果：

1.  
   QPushButton:hover { color: white }
2.  
   QPushButton { color: red }

　　这里有一个复杂的：

1.  
   QPushButton:hover { color: white }
2.  
   QPushButton:enabled { color: red }

这里，两个选择器有相同的特殊性，如果鼠标在按钮上时，第二条规则优先。如果在这种情况下我们想要白色文本，需要重新排序规则：

1.  
   QPushButton:enabled { color: red }
2.  
   QPushButton:hover { color: white }

或者，可以使第一条规则更加具体：

1.  
   QPushButton:hover:enabled { color: white }
2.  
   QPushButton:enabled { color: red }

类似的问题出现在类型选择器一起使用。请看下面的例子：

1.  
   QPushButton { color: red }
2.  
   QAbstractButton { color: gray }

两个规则应用于QPushButton实例（因为QPushButton继承自QAbstractButton）并有color属性的冲突。因为QPushButton继承QAbstractButton，所以QPushButton比QAbstractButton更具体。

然而，对于QSS的计算，所有的类型选择具有相同的特殊性，最后出现的规则优先。换句话说，所有的QAbstractButton颜色设置为灰色（包括QPushButton）。如果需要设置QPushButtons为红色文字，我们总能重新排序规则。

为了确定一个规则的特殊性，QSS遵循CSS2规范：

一个选择器的特殊性的计算方法如下：

• 计算选择器中ID属性的数量（= a）
• 计算选择器中伪状态类和其它属性的数量（= b）
• 计算选择器中元素名的数量（= c）
• 忽略伪元素（即子控件）。

串联的三个数字a-b-c（在具有大基数的数字系统）给出的特殊性。

一些例子：

1.  
   * {} /* a=0 b=0 c=0 -> specificity = 0 */
2.  
   LI {} /* a=0 b=0 c=1 -> specificity = 1 */
3.  
   UL LI {} /* a=0 b=0 c=2 -> specificity = 2 */
4.  
   UL OL+LI {} /* a=0 b=0 c=3 -> specificity = 3 */
5.  
   H1 + *[REL=up]{} /* a=0 b=1 c=1 -> specificity = 11 */
6.  
   UL OL LI.red {} /* a=0 b=1 c=3 -> specificity = 13 */
7.  
   LI.red.level {} /* a=0 b=2 c=1 -> specificity = 21 */
8.  
   #x34y {} /* a=1 b=0 c=0 -> specificity = 100 */

级联效应

QSS可以在QApplication、父部件、子部件中设置。任意部件的有效样式表通过合并部件的祖先（父亲，祖父等）以及任何QApplication上设置的样式表。

冲突发生时，不论冲突规则的特殊性，部件自身的样式表总优先于任何继承样式表。同样，父窗口部件样式表优先于祖父等。

这样，一个部件设置样式自动使得它比在祖先部件或QApplication的样式表中指定的其它规则的优先级高。考虑下面的例子。首先，我们在QApplication中设置样式表：

qApp->setStyleSheet("QPushButton { color: white }");

• 1

• 1

然后，我们设置QPushButton的样式表：

myPushButton->setStyleSheet("* { color: blue }");

• 1

• 1

QPushButton样式表强制QPushButton（以及任何子部件）显示蓝色文字，尽管应用程序范围内的样式表提供的规则更具体。

如果按照下面这种方式写，其结果是相同的：

myPushButton->setStyleSheet("color: blue");

• 1

• 1

但如果QPushButton有孩子(不太可能)，样式表就不会对它们有效果。

样式表级联是一个复杂的话题。请参考CSS2 Specification，要知道目前Qt没有实现。

继承性

在经典的CSS中，当字体和颜色没有明确设置时，它就会自动从父继承。当使用QSS时，部件不会自动从父继承字体和颜色。

例如，一个QGroupBox中包含QPushButton：

qApp->setStyleSheet("QGroupBox { color: red; } ");

• 1

• 1

QPushButton没有一个明确的颜色设置，因此，不是继承其父QGroupBox的颜色，而是显示系统的颜色。如果要建立一个QGroupBox及其孩子的颜色，可以这样写：

qApp->setStyleSheet("QGroupBox, QGroupBox * { color: red; }");

• 1

• 1

相比之下，可以用QWidget::setFont() 和 QWidget::setPalette()为子部件设置字体和画板 。

Namespaces中的部件

类型选择器可用于某一特定类型的部件。例如：

1.  
   class MyPushButton : public QPushButton {
2.  
   // ...
3.  
   }
4.  
    
5.  
   // ...
6.  
   qApp->setStyleSheet("MyPushButton { background: yellow; }");

QSS使用部件的QObject::className()来确定何时应用类型选择器。当自定义的部件在命名空间中时，QObject::className()返回<namespace>::<classname>。这与子控件的语法冲突。为了解决这个问题，当命名空间内的部件使用类型选择器时，必须更换”::” 为 “–”。 例如：

1.  
   namespace ns {
2.  
   class MyPushButton : public QPushButton {
3.  
   // ...
4.  
   }
5.  
   }
6.  
    
7.  
   // ...
8.  
   qApp->setStyleSheet("ns--MyPushButton { background: yellow; }");

设置对象属性

从4.3及以后，任何可被识别的Q_PROPERTY都可以使用qproperty-<property name>语法设置。

例如：

1.  
   MyLabel { qproperty-pixmap: url(pixmap.png); }
2.  
   MyGroupBox { qproperty-titleColor: rgb(100, 200, 100); }
3.  
   QPushButton { qproperty-iconSize: 20px 20px; }

如果属性引用Q_ENUMS声明的枚举，则应该参考其常量的名字，而不是数值。

转自：https://blog.csdn.net/liang19890820/article/details/51691212

QSS 样式表语法