一、描述
1、调色板由三个颜色组组成::Active、Disabled和Inactive。
2、Qt中的所有小部件都包含一个调色板,并使用它来绘制它们自己。这使得用户界面易于配置和保持一致。如果您创建新小部件,我们强烈建议您使用调色板中的颜色,而不是硬编码特定颜色。
3、颜色组:包含小部件用来绘制自身的一组颜色。分成:
Active 组用于具有键盘焦点的窗口。
Inactive 组用于其他窗口。
Disabled 组用于由于某种原因被禁用的小部件(不是窗口)。
4、活动窗口和非活动窗口都可以包含禁用的小部件。(禁用的小部件通常称为不可访问或灰显)
5、在大多数样式中,Active 和 Inactive 看起来是一样的。
6、可以使用setColor()和setBrush()为调色板的任何颜色组中的特定角色设置颜色和画笔。
7、强烈建议使用当前样式的默认调色板(由QGuiApplication::palette()返回),并根据需要进行修改。 这是由Qt的小部件在绘制时完成的。
8、QPalette使用隐式共享进行了优化,因此将QPalette对象作为参数传递非常有效。
警告:某些样式不会对所有绘图都使用调色板,例如,如果它们使用本机主题引擎。Windows Vista 和 macOS 样式都是这种情况。
enum QPalette::ColorGroup颜色组
常量 | 值 | 描述 |
---|---|---|
QPalette::Disabled | 1 | 不可用状态 |
QPalette::Active | 0 | 获得焦点的状态 |
QPalette::Inactive | 2 | 未获得焦点的状态 |
QPalette::Normal | Active | synonym for Active |
enum QPalette::ColorRole颜色角色
常量 | 值 | 描述 |
---|---|---|
QPalette::Window | 10 | 背景色 |
QPalette::Background | Window | 这个值是废弃的,使用window代替 |
QPalette::WindowText | 0 | 前景色 |
QPalette::Foreground | WindowText | 这个值是废弃的,使用windowText代替 |
QPalette::Base | 9 | 主要用作文本输入窗口小部件的背景色,但也可以用于其他绘制——比如组合框下拉列表和工具栏手柄的背景色。它通常是白色或其他浅色。 |
QPalette::AlternateBase | 16 | 在视图中用交替的行颜色作为交替的背景颜色(参见QAbstractItemView::setAlternatingRowColors())。 |
QPalette::ToolTipBase | 18 | 用作QToolTip和QWhatsThis的背景颜色。工具提示使用QPalette的Inactive颜色组,因为工具提示不是活动窗口。 |
QPalette::ToolTipText | 19 | 用作QToolTip和QWhatsThis的前景色。工具提示使用QPalette的Inactive颜色组,因为工具提示不是活动窗口。 |
QPalette::PlaceholderText | 20 | 用作各种文本输入小部件,给予用户一些提示信息。这个enum值在Qt 5.12中已经引入 |
QPalette::Text | 6 | Base作为背景色时的前景色。这通常与WindowText相同,在这种情况下,它必须提供与Window和Base的良好对比。 |
QPalette::Button | 1 | 通用按钮背景颜色。这个背景可以与Window不同,因为一些样式要求按钮有不同的背景颜色。 |
QPalette::ButtonText | 8 | 与按钮颜色一起使用的前景色。 |
QPalette::BrightText | 7 | 一种与WindowText非常不同的文本颜色,并与Dark等颜色形成良好的对比。通常用于需要绘制的文本,其中text或WindowText会给出较差的对比,如按下按钮。注意,text colors不仅可以用于文字,还可以用于其他内容;text colors通常用于文本,但将文本颜色角色用于线条、图标等也很常见。 |
以下的颜色角色用于3D斜角和阴影效果。
常量 | 值 | 描述 |
---|---|---|
QPalette::Light | 2 | 比Button颜色浅。 |
QPalette::Midlight | 3 | 在Button和Light之间。 |
QPalette::Dark | 4 | 比Button暗。 |
QPalette::Mid | 5 | 在Button和Dark之间。 |
QPalette::Shadow | 11 | 非常暗的颜色。默认情况下为Qt::black。 |
标示已选项的颜色角色:
常量 | 值 | 描述 |
---|---|---|
QPalette::Highlight | 12 | 用于指示选定项或当前项的颜色。默认情况为Qt::darkBlue。 |
QPalette::HighlightedText | 13 | 与突出显示形成对比的文本颜色。 默认情况为Qt::white。 |
超链接有关的颜色角色:
常量 | 值 | 描述 |
---|---|---|
QPalette::Link | 14 | 用于未访问的超链接的文本颜色。 默认情况为Qt::blue。 |
QPalette::LinkVisited | 15 | 用于已访问的超链接的文本颜色。 默认情况为Qt::magenta(洋红色)。 |
其它
常量 | 值 | 描述 |
---|---|---|
QPalette::NoRole: | 没有作用。通常用于指示尚未分配角色。 |
以下是枚举值的图示