Qt开发：QColorDialog的使用

一、QColorDialog的基本介绍

QColorDialog 继承自 QDialog，用于让用户选择颜色。它可以以模态或非模态的方式运行，并支持 QColor 作为输入和输出。

二、QColorDialog的基本用法

1. 使用静态方法
最简单的方式是调用 QColorDialog::getColor()，它会显示一个颜色选择对话框，并返回用户选择的颜色：

QColor color = QColorDialog::getColor(Qt::white, this, "选择颜色");
if (color.isValid()) {
    qDebug() << "用户选择的颜色：" << color.name();
}

• Qt::white：默认颜色。
• this：父窗口（可选）。
• “选择颜色”：对话框标题。
• color.isValid()：检查用户是否取消了选择。

2.使用实例对象
可以创建 QColorDialog 实例，以便进行更多的定制：

QColorDialog dialog(this);
dialog.setCurrentColor(Qt::red);  // 设置初始颜色
dialog.setOption(QColorDialog::ShowAlphaChannel);  // 显示透明度选项
if (dialog.exec() == QDialog::Accepted) {
    QColor color = dialog.selectedColor();
    qDebug() << "用户选择的颜色：" << color.name();
}

• setCurrentColor(Qt::red)：预选颜色。
• setOption(QColorDialog::ShowAlphaChannel)：允许调整透明度。
• xec()：以模态方式显示对话框。

3. 信号与槽
如果 QColorDialog 以非模态方式（open() 或 show()）显示，可以使用信号槽：

QColorDialog *dialog = new QColorDialog(this);
connect(dialog, &QColorDialog::colorSelected, this, [](const QColor &color) {
    qDebug() << "选择的颜色：" << color.name();
});
dialog->open();

• colorSelected(QColor)：用户最终选择颜色时触发。
• currentColorChanged(QColor)：颜色变化时触发。

4. 自定义颜色面板
可以手动添加颜色：

QColorDialog dialog(this);
dialog.setCustomColor(0, Qt::blue);  // 设置自定义颜色索引 0 为蓝色
dialog.exec();

也可以批量设置：

QColorDialog dialog(this);
QList<QColor> colors = {Qt::red, Qt::green, Qt::blue};
for (int i = 0; i < colors.size(); ++i) {
     dialog.setCustomColor(i, colors[i]);
}
dialog.exec();

5. 隐藏部分UI
如果想隐藏某些功能，例如透明度滑块、RGB 编辑框等，可以使用 setOptions()：

QColorDialog dialog(this);
dialog.setCustomColor(0, Qt::blue);  // 设置自定义颜色索引 0 为蓝色
dialog.setOptions(QColorDialog::NoButtons | QColorDialog::DontUseNativeDialog);
dialog.exec();

三、完整示例

Dialog::Dialog(QWidget *parent)
    : QDialog(parent)
{
    this->setFixedSize(800, 600);
    this->setWindowTitle("颜色对话框测试");

    m_gLayout = new QGridLayout(this);
    m_colorBtn = new QPushButton("调用颜色对话框", this);

    m_colorFrame = new QFrame;
    m_colorFrame->setFrameShape(QFrame::Box); // 设置形状
    m_colorFrame->setAutoFillBackground(true); // 填充背景处理

    m_gLayout->addWidget(m_colorBtn, 0, 0);
    m_gLayout->addWidget(m_colorFrame, 1, 0);

    // 信号槽函数链接
    connect(m_colorBtn, &QPushButton::clicked, this, &Dialog::dispcolorFunc);
}

void Dialog::dispcolorFunc()
{
    QColor colorValues = QColorDialog::getColor(Qt::red);
    if (colorValues.isValid()) {
        m_colorFrame->setPalette(QPalette(colorValues));
    }
}