【QPalette】调色板简介

描述

QPalette类包含每个小部件状态的颜色组。
调色板由三个颜色组组成:活动的、禁用的和非活动的。Qt中的所有小部件都包含一个调色板，并使用它们的调色板来绘制自己。这使得用户界面易于配置和保持一致。如果您创建一个新的小部件，我们强烈建议您使用调色板中的颜色，而不是硬编码特定的颜色。

颜色组:
1.活动组用于具有键盘焦点的窗口。
2.非活动组用于其他窗口。
3.禁用组用于由于某种原因禁用的小部件(而不是窗口)。

活动窗口和非活动窗口都可以包含禁用的小部件。禁用的小部件通常被称为不可访问或变灰。在大多数样式中，活动和非活动看起来是一样的。
可以使用setColor()和setBrush()为调色板的任何颜色组中的特定角色设置颜色和画笔。包含一组颜色的颜色组被小部件用来绘制自己。
我们建议小部件使用调色板中的颜色组角色，如“前景”和“基础”，而不是“红色”或“蓝绿色”等文字颜色。颜色角色在ColorRole文档中枚举和定义。
我们强烈建议您使用当前样式的默认调色板(由QGuiApplication::palette()返回)，并根据需要修改它。这是由Qt的小部件在绘制时完成的。
要修改颜色组，可以调用函数setColor()和setBrush()，这取决于您是想要纯颜色还是像素图模式。还有相应的color()和brush() getter函数，以及一个常用的方便函数来获取当前ColorGroup的ColorRole: window()、windowText()、base()等。
您可以使用copy构造函数复制调色板，然后使用isCopyOf()测试两个调色板是否相同。
QPalette通过使用隐式共享进行优化，因此将QPalette对象作为参数传递是非常有效的。
警告：调色板不能绘制某些样式，例如，如果这些样式使用了本地主题引擎。Windows Vista和macOS风格都是如此。
还请参见QApplication::setPalette()、QWidget::setPalette()和QColor。

成员类型的文档

enum QPalette::ColorGroup

Constant	Value	Description
QPalette::Disabled	1
QPalette::Active	0
QPalette::Inactive	2
QPalette::Normal	Active	与Active 同义

enum QPalette::ColorRole
ColorRole enum定义了当前gui中使用的不同角色。重要的角色有：

常数	值	描述
QPalette::Window	10	一般的背景色。
QPalette::Background	Window	此值已过时。使用Window代替.
QPalette::WindowText	0	一般的前景色。
QPalette::Foreground	WindowText	此值已过时。使用WindowText代替。
QPalette::Base	9	主要用作文本输入小部件的背景颜色，但也可用于其他绘图——例如combobox下拉列表和工具栏句柄的背景。通常是白色或其他浅色。
QPalette::AlternateBase	16	在具有交替行颜色的视图中用作交替的背景颜色(参见QAbstractItemView::setAlternatingRowColors())
QPalette::ToolTipBase	18	用作QToolTip和QWhatsThis的背景颜色。工具提示使用QPalette的非活动颜色组，因为工具提示不是活动窗口。
QPalette::ToolTipText	19	用作QToolTip和QWhatsThis的前景色。工具提示使用QPalette的非活动颜色组，因为工具提示不是活动窗口。
QPalette::PlaceholderText	20	用作各种文本输入小部件的占位符颜色。这个enum值是在Qt 5.12中引入的
QPalette::Text	6	与底色一起使用的前景色。这通常与WindowText相同，在这种情况下，它必须与Window和Base提供良好的对比。
QPalette::Button	1	通用按钮的背景颜色。这个背景可能与窗口不同，因为有些样式要求按钮的背景颜色不同。
QPalette::ButtonText	8	与按钮颜色一起使用的前景色。
QPalette::BrightText	7	一种与WindowText非常不同的文本颜色，与例如Dark等颜色有很好的对比。通常用于需要在文本或WindowText对比度较差的地方绘制的文本，如按下的按钮。注意，文本颜色不仅可以用于单词，还可以用于其他东西;文本颜色通常用于文本，但是将文本颜色角色用于行、图标等非常常见。

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

常数	值	描述
QPalette::Light	2	比按钮颜色浅。
QPalette::Midlight	3	在按钮和浅色之间。
QPalette::Dark	4	比按钮颜色深。
QPalette::Mid	5	在按钮和深色之间。
QPalette::Shadow	11	非常深的颜色。默认情况下，阴影颜色是Qt::black。

选择(标记)的项目有两个角色:

常数	值	描述
QPalette::Highlight	12	表示选定项或当前项的颜色。默认情况下，突出显示的颜色是Qt::darkBlue。
QPalette::HighlightedText	13	与突出显示形成对比的文本颜色。默认情况下，突出显示的文本颜色是Qt::white.

超链接有两个颜色角色:

常数	值	描述
QPalette::Link	14	用于未访问的超链接的文本颜色。默认情况下，链接的颜色是Qt::blue。
QPalette::LinkVisited	15	用于已访问的超链接的文本颜色。默认情况下，linkvisited颜色是Qt::品红。

注意，在Qt中呈现富文本时，我们不使用Link和LinkVisited角色，我们建议使用CSS和QTextDocument::setDefaultStyleSheet()函数来更改链接的外观。例如:

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

空角色：

常数	值	描述
QPalette::NoRole	17	空角色;这个特殊的角色通常用来表示没有分配角色。