描述
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 | 空角色;这个特殊的角色通常用来表示没有分配角色。 |