ColorGroup QML Type
按角色划分的颜色集。更多...
属性
- accent : color
(since 6.6) - alternateBase : color
- base : color
- brightText : color
- button : color
- buttonText : color
- dark : color
- highlight : color
- highlightedText : color
- light : color
- link : color
- linkVisited : color
- mid : color
- midlight : color
- placeholderText : color
(since 6.2) - shadow : color
- text : color
- toolTipBase : color
- toolTipText : color
- window : color
- windowText : color
信号
- changed()
详细说明
ColorGroup 类型用于定义一组具有特定作用的颜色。虽然 ColorGroup 本身没有视觉外观,但它定义了用于自定义渲染项的颜色。
颜色的默认值等于默认构造的 `QPalette` 的活动组颜色。
可使用以下代码创建一个包含指定颜色的颜色组:
ColorGroup {
alternateBase: "red"
base: "green"
}Palette 类型为每个QML项的状态提供了相应的颜色组。
属性文档
accent : color [since 6.6]
一种通常与base 、window 和button 颜色形成对比或互补的颜色。它通常代表用户对桌面个性化的选择。交互式组件的样式设置是一个典型的用例。除非显式设置,否则默认值为highlight 。
该属性在 Qt 6.6 中引入。
alternateBase : color
在采用行交替着色的项目视图中,用作备用背景色。
base : color
主要用于文本编辑器控件和项目视图的背景色。通常为白色或其他浅色。
brightText : color
一种与windowText 差异显著的文字颜色,与dark 等颜色形成良好对比。通常用于需要在text 、windowText 或buttonText 等颜色下对比度较差的位置显示的文本,例如高亮显示的按钮。
button : color
按钮的默认背景色。该背景色可以与window 不同,因为某些样式需要为按钮设置不同的背景色。
buttonText : color
与palette 颜色搭配使用的前景色。
dark : color
与palette 颜色配合使用的前景色。
highlight : color
一种用于标识已选项目或当前项目的颜色。
highlightedText : color
一种与highlight 形成对比的文字颜色。
light : color
比button 更轻。
link : color
用于超链接的文本颜色。
linkVisited : color
用于已访问超链接的文字颜色。
mid : color
介于palette.button 和dark 之间。
midlight : color
介于button 和light 之间。
placeholderText : color [since 6.2]
用作可编辑单行字段的占位符颜色。
该属性在 Qt 6.2 中引入。
shadow : color
一种非常深的颜色。
text : color
base 使用的 foreground color。该颜色通常与windowText 相同,在这种情况下,它必须与window 和base 形成良好的对比。
toolTipBase : color
用作工具提示的背景色。
toolTipText : color
用作工具提示的前景色。
window : color
一种通用的背景色。
windowText : color
通用前景色。
Signal 文档
changed()
附加信号表明该颜色组的当前状态已发生变化。通常这意味着其中一种颜色发生了变化。
注意: 相应的处理程序 为onChanged 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.