QT QPalette

亦凉 2022-10-07 11:47 42阅读 0赞

QPalette类包含每个小部件状态的颜色组。

调色板由三个颜色组组成：活动、禁用和非活动。Qt中的所有小部件都包含一个调色板，并使用它们的调色板来绘制它们自己。这使得用户界面易于配置和保持一致。

如果您创建一个新的小部件，我们强烈建议您使用调色板中的颜色，而不是硬编码特定的颜色。

**颜色组**：  
活动组用于具有键盘焦点的窗口。  
非活动组用于其他窗口。  
禁用组用于由于某种原因被禁用的小部件（而不是窗口）。

活动窗口和非活动窗口都可以包含禁用的小部件(禁用的小部件通常称为不可访问或灰显。）

在大多数样式中，活动和非活动的外观相同。

可以使用setColor（）和setBrush（）为调色板的任何颜色组中的特定角色设置颜色和笔刷。一个颜色组包含一组小部件用于绘制自己的颜色。我们建议小部件使用调色板中的颜色组角色，例如“前景”和“基础”，而不是像“红色”或“绿松石色”这样的文字颜色。颜色角色在ColorRole文档中枚举和定义。

强烈建议您使用当前样式的默认调色板（由QGuiApplication:：palete（）返回），并根据需要进行修改。这是由Qt的小部件在绘制时完成的。

要修改颜色组，需要调用函数setColor（）和setBrush（），具体取决于您想要的是纯色还是像素贴图图案。

还有相应的color（）和brush（）getter，以及一个常用的方便函数来获取当前ColorGroup的ColorRole:window（）、windowText（）、base（）等。

可以使用复制构造函数复制一个选项板，并使用isCopyOf（）测试两个选项板是否相同。  
QPalette通过使用隐式共享进行优化，因此将QPalette对象作为参数传递是非常有效的。

警告：某些样式不会对所有图形使用调色板，例如，如果它们使用本机主题引擎。Windows XP、Windows Vista和Mac OS X样式都是这样。

另请参见QApplication:：setpalete（）、QWidget:：setpalete（）和QColor。

**成员类型说明**

enum QPalette::ColorGroup

<table style="width:273pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:bottom;width:110pt;">Constant</td> 
 <td style="vertical-align:bottom;width:54pt;">Value</td> 
 <td style="vertical-align:bottom;width:109pt;">Description</td> 
 </tr> 
 <tr> 
 <td style="vertical-align:bottom;">QPalette::Disabled</td> 
 <td style="vertical-align:bottom;">1</td> 
 <td style="vertical-align:bottom;">&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="vertical-align:bottom;">QPalette::Active</td> 
 <td style="vertical-align:bottom;">0</td> 
 <td style="vertical-align:bottom;">&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="vertical-align:bottom;">QPalette::Inactive</td> 
 <td style="vertical-align:bottom;">2</td> 
 <td style="vertical-align:bottom;">&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="vertical-align:bottom;">QPalette::Normal</td> 
 <td style="vertical-align:bottom;">Active</td> 
 <td style="vertical-align:bottom;">synonym for Active</td> 
 </tr> 
 </tbody> 
</table>

enum QPalette::ColorRole

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70][]

ColorRole枚举定义当前GUI中使用的不同符号颜色角色。  
中心角色是：

<table style="width:507pt;"> 
 <tbody> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">Constant</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">Value</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">Description</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::Window</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">10</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">A general background color.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::Background</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">Window</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">This value is obsolete. Use Window instead.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::WindowText</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">0</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">A general foreground color.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::Foreground</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">WindowText</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">This value is obsolete. Use WindowText instead.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::Base</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">9</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">Used mostly as the background color for text entry widgets, but can also be used for other painting - such as the background of combobox drop down lists and toolbar handles. It is usually white or another light color.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::AlternateBase</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">16</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">Used as the alternate background color in views with alternating row colors (seeQAbstractItemView::setAlternatingRowColors()).</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::ToolTipBase</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">18</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">Used as the background color for&nbsp;QToolTip&nbsp;and&nbsp;QWhatsThis. Tool tips use the Inactive color group of&nbsp;QPalette, because tool tips are not active windows.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::ToolTipText</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">19</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">Used as the foreground color for&nbsp;QToolTip&nbsp;and&nbsp;QWhatsThis. Tool tips use the Inactive color group of&nbsp;QPalette, because tool tips are not active windows.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::Text</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">6</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">The foreground color used with&nbsp;Base. This is usually the same as the&nbsp;WindowText, in which case it must provide good contrast with&nbsp;Window&nbsp;and&nbsp;Base.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::Button</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">1</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">The general button background color. This background can be different from&nbsp;Window&nbsp;as some styles require a different background color for buttons.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::ButtonText</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">8</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">A foreground color used with the&nbsp;Button&nbsp;color.</td> 
 </tr> 
 <tr> 
 <td style="text-align:left;vertical-align:middle;width:132pt;">QPalette::BrightText</td> 
 <td style="text-align:left;vertical-align:middle;width:124pt;">7</td> 
 <td style="text-align:left;vertical-align:middle;width:251pt;">A text color that is very different from&nbsp;WindowText, and contrasts well with e.g.&nbsp;Dark. Typically used for text that needs to be drawn where&nbsp;Text&nbsp;or&nbsp;WindowText&nbsp;would give poor contrast, such as on pressed push buttons. Note that text colors can be used for things other than just words; text colors are&nbsp;usually&nbsp;used for text, but it's quite common to use the text color roles for lines, icons, etc.</td> 
 </tr> 
 </tbody> 
</table>

有一些颜色角色主要用于三维斜面和阴影效果。所有这些通常都是从Window派生的，并以依赖于这种关系的方式使用。例如，按钮依赖于它使斜面看起来很有吸引力，而主题滚动条依赖于中间使其与窗口略有不同。

Selected (marked) items have two roles:

There are two color roles related to hyperlinks:

Note that we do not use the Link and LinkVisited roles when rendering rich text in Qt, and that we recommend that you use CSS and the QTextDocument::setDefaultStyleSheet() function to alter the appearance of links. For example:

QTextBrowser browser;
    QColor linkColor(Qt::red);
    QString sheet = QString::fromLatin1("a { text-decoration: underline; color: %1 }").arg(linkColor.name());
    browser.document()->setDefaultStyleSheet(sheet);

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70]: /images/20221005/450e76319f40412391169bc898a17211.png