当前位置：首页 > news >正文

PySide6 GUI 学习笔记——常用类及控件使用方法（常用控件调色板QPalette）

news 来源：原创 2025/5/21 14:13:44

文章目录

- 1. 概述
- 2. 颜色角色表（ColorRole）
- 3. 常用方法
- 4. Python示例
- 5. 关键特性说明
- 6. 最佳实践

1. 概述

QPalette管理Qt控件的颜色方案，它的颜色组ColorGroup包含3个状态：

• Active：激活状态，获得焦点；

• Inactive：非激活状态，失去焦点；

• Disabled：失效状态，控件不可用。

通过修改调色板可实现应用程序主题的统一管理。

2. 颜色角色表（ColorRole）

枚举值	描述
Window	窗口背景色
WindowText	窗口前景色（文本）
Base	文本输入控件背景色
Text	与Base搭配的文本颜色
Button	按钮背景色
ButtonText	按钮文本颜色
Highlight	选中项背景色
HighlightedText	选中项文本颜色
ToolTipBase	工具提示背景色
ToolTipText	工具提示文本颜色
BrightText	高对比度文本色
Link	超链接颜色
LinkVisited	已访问链接颜色
AlternateBase	交替行背景色
PlaceholderText	输入占位符文本颜色
Shadow	阴影颜色

（完整枚举共21个角色，此处列出常用15个，详细内容可参考官方文档）

3. 常用方法

方法	参数	返回类型	描述
color()	ColorGroup, ColorRole	QColor	获取颜色值
brush()	ColorGroup, ColorRole	QBrush	获取画刷对象
setColor()	ColorRole, QColor	void	设置颜色（所有组）
setBrush()	ColorGroup, ColorRole, QBrush	void	设置指定组画刷
currentColorGroup()	-	ColorGroup	获取当前颜色组
isEqual()	ColorGroup, ColorGroup	bool	比较颜色组是否相同

4. Python示例

import sys
from PySide6.QtWidgets import QApplication, QWidget, QPushButton
from PySide6.QtGui import QPalette, QColor
from PySide6.QtCore import Qtclass DemoWindow(QWidget):def __init__(self):super().__init__()# 创建按钮self.btn = QPushButton("测试按钮", self)self.btn.setGeometry(50, 50, 120, 40)# 获取当前调色板palette = self.palette()# 修改颜色角色palette.setColor(QPalette.Button, QColor("#009688"))  # 按钮背景palette.setColor(QPalette.ButtonText, QColor("white"))  # 按钮文本palette.setColor(QPalette.Highlight, QColor("#FF5722"))  # 选中背景# 应用调色板self.setPalette(palette)self.resize(200, 150)self.setWindowTitle("调色板演示")if __name__ == "__main__":app = QApplication(sys.argv)window = DemoWindow()window.show()sys.exit(app.exec())

运行效果

import sys
from PySide6.QtWidgets import QApplication, QWidget, QLabel
from PySide6.QtGui import QFont, QColor, QPalette
from random import randint, seedclass SetPalette(QWidget):def __init__(self,parent=None):super().__init__(parent)self.setGeometry(200,200,1200,500)  #设置窗口尺寸self.setWindowTitle("设置调色板实例")self.createLabels()  #调用函数self.setLabelColor()  #调用函数self.getLabelColorRGB()  #调用函数def createLabels(self):  #创建10个标签self.labels = list()font = QFont("黑体",pointSize=20)string = "Nice to meet you! 很高兴认识你！"for i in range(10):label = QLabel(self)  #在窗口上创建标签控件label.setGeometry(5,50*i,1200,40)  #标签位置和尺寸label.setText(str(i)+': '+string)  #设置标签文字label.setFont(font)  #设置标签文字的字体self.labels.append(label) #标签列表def setLabelColor(self):seed(12)for label in self.labels:colorBase = QColor(randint(0,255), randint(0,255), randint(0,255))  #定义颜色colorText = QColor(randint(0,255), randint(0,255), randint(0,255))  #定义颜色palette = label.palette()# palette.setColor(palette.Active,palette.Window,colorBase)  #定义背景色# palette.setColor(palette.Active,palette.WindowText,colorText) #定义前景色palette.setColor(QPalette.ColorGroup.Active,QPalette.ColorRole.Window,colorBase)  #定义背景色palette.setColor(QPalette.ColorGroup.Active,QPalette.ColorRole.WindowText,colorText) #定义前景色label.setAutoFillBackground(True)  #设置背景自动填充label.setPalette(palette)  #设置调色板def getLabelColorRGB(self):  #获取标签前景颜色和背景颜色RGB值for label in self.labels:r,g,b,a = label.palette().window().color().getRgb()  #获取背景颜色的RGB值rT,gT,bT,a = label.palette().windowText().color().getRgb()#获取文字颜色的RGB值text = (f"{label.text()}背景颜色：{r} {g} {b} 文字颜色：{rT} {gT} {bT}")label.setText(text)
if __name__ == '__main__':app = QApplication(sys.argv)window = SetPalette()window.show()sys.exit(app.exec())