PyQt5 – QColorDialog

当你想要选择颜色时，QColorDialog 是一个非常方便的组件。它可以打开一个颜色选择器，以便用户从自定义颜色、标准颜色或近似颜色中选择颜色。

安装 PyQt5

在开始之前，确保你已经安装了 PyQt5 库，否则需要先安装它。可以通过 pip 命令来安装，如下面的代码所示：

pip install PyQt5

使用 QColorDialog

使用 QColorDialog 非常简单，只需要实例化它并调用 exec_() 方法即可。以下是一个简单的示例代码，该代码打开一个颜色选择器并将选择的颜色打印出来：

from PyQt5.QtWidgets import QApplication, QColorDialog

app = QApplication([])
color = QColorDialog.getColor()
print(color.name())

在上述代码中，getColor() 方法将打开颜色选择器。此时用户可以在颜色选择器中选择一个颜色，单击对应的颜色之后，颜色选择器窗口将自动关闭，并且在终端中输出所选的颜色的名称。

为了使用更多 QColorDialog 的特性，例如设置默认颜色、预定义颜色、自定义颜色、隐藏特定的颜色模型等，需要使用 QColorDialog 的更多方法。以下代码演示了一个包括所有 QColorDialog 选项的示例：

from PyQt5.QtWidgets import QApplication, QColorDialog

app = QApplication([])
colorDialog = QColorDialog()

# 设置默认颜色
colorDialog.setCurrentColor('#ff69b4')

# 设置预定义颜色
colorDialog.setStandardColor(3)

# 隐藏 HSV 和 CMYK 颜色模型
colorDialog.setOptions(QColorDialog.NoButtons |
                       QColorDialog.DontUseNativeDialog |
                       QColorDialog.NoHsv |
                       QColorDialog.NoCmyk)

# 打开对话框
if colorDialog.exec_():
    # 获取选定的颜色
    color = colorDialog.selectedColor()
    print(color.name())

示例说明

示例 1

在这个示例中，我们打开一个颜色选择器，并在选择完成后将颜色应用于 QLabel 控件的背景色。以下是示例代码：

from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QColorDialog, QVBoxLayout, QPushButton


class Example(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.color = 'white'
        self.label = QLabel('颜色选择器默认颜色')
        self.label.setStyleSheet(f'background-color: {self.color}; width: 100px; height: 100px')

        button = QPushButton('选择颜色', self)
        button.clicked.connect(self.showColorDialog)

        vBox = QVBoxLayout()
        vBox.addWidget(self.label)
        vBox.addWidget(button)

        self.setLayout(vBox)
        self.setWindowTitle('QColorDialog 示例')
        self.setGeometry(100, 100, 200, 200)
        self.show()

    def showColorDialog(self):
        color = QColorDialog.getColor()
        if color.isValid():
            self.color = color.name()
            self.label.setStyleSheet(f'background-color: {self.color}; width: 100px; height: 100px')


if __name__ == '__main__':
    app = QApplication([])
    ex = Example()
    app.exec_()

在这个示例中，我们使用 QLabel 控件来显示当前所选颜色，并使用 setStyleSheet() 方法设置其背景颜色。当用户单击按钮时，将打开颜色选择器。选择完成后，将颜色应用于 QLabel 控件的背景色。

示例 2

在这个示例中，我们打开一个自定义窗口，该窗口包含一个 QColorDialog 组件和一个选择颜色按钮。在 QColorDialog 的属性选项中，我们设置了默认颜色和预定义颜色，并隐藏了 HSV 和 CMYK 颜色模型。以下是示例代码：

from PyQt5.QtWidgets import QApplication, QWidget, QPushButton, QGridLayout, QColorDialog


class Example(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.color = '#ff69b4'

        colorButton = QPushButton('选择颜色', self)
        colorButton.clicked.connect(self.showColorDialog)

        grid = QGridLayout()
        grid.addWidget(colorButton, 0, 0)

        self.setLayout(grid)
        self.setWindowTitle('QColorDialog 示例')
        self.setGeometry(100, 100, 200, 200)
        self.show()

    def showColorDialog(self):
        colorDialog = QColorDialog()
        colorDialog.setCurrentColor(self.color)
        colorDialog.setStandardColor(3)
        colorDialog.setOptions(QColorDialog.NoButtons |
                               QColorDialog.DontUseNativeDialog |
                               QColorDialog.NoHsv |
                               QColorDialog.NoCmyk)
        if colorDialog.exec_():
            self.color = colorDialog.selectedColor().name()
            self.setStyleSheet(f'''
                background-color: {self.color};
                width: 100px;
                height: 100px;
                margin: auto;
            ''')


if __name__ == '__main__':
    app = QApplication([])
    ex = Example()
    app.exec_()

在这个示例中，我们使用 QGridLayout 进行布局，并在网格中添加了一个 QPushButton 控件。当点击按钮时，将会打开包含默认颜色、预定义颜色和隐藏 HSV 和 CMYK 颜色模型的 QColorDialog 窗口。选择颜色后，颜色会应用于 QWidget 的背景色。