Qt （13）【Qt窗口 —— 颜色对话框 QColorDialog】

news2024/11/22 14:35:10

阅读导航

引言
一、颜色对话框 QColorDialog简介
二、常用方法介绍
- ⭕参数说明
三、使用示例

引言

在深入探讨了Qt的QMessageBox之后，我们现在转向QColorDialog，一个让用户轻松选择颜色的实用对话框，为Qt应用增添色彩选择的便捷性。

一、颜色对话框 QColorDialog简介

颜色对话框的主要功能是允许用户从预定义的颜色选项或通过自定义方式选择颜色。它继承自Qt框架中的QDialog类，作为对话框的一种，提供了丰富的颜色选择界面，如下图所示展示了颜色对话框的一个典型示例。
在这里插入图片描述

二、常用方法介绍

创建颜色对话框实例
- QColorDialog(QWidget *parent = nullptr): 创建一个颜色对话框的实例，并可选择性地指定其父窗口（parent）。如果不指定父窗口，则默认为 nullptr。
- QColorDialog(const QColor &initial, QWidget *parent = nullptr): 创建一个颜色对话框的实例，并使用 initial 参数设置初始颜色，同时可选择性地指定其父窗口（parent）。如果不指定父窗口，则默认为 nullptr。
设置当前颜色
- void setCurrentColor(const QColor &color): 设置颜色对话框中当前选中的颜色为 color。这不会立即打开对话框，但会影响后续对话框打开时显示的颜色选择。
获取当前颜色
- QColor currentColor() const: 返回颜色对话框中当前选中的颜色。如果对话框尚未打开或用户未选择颜色，则返回的颜色可能依赖于之前的设置或默认颜色。
静态方法获取颜色
- QColor getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = QColorDialog::ColorDialogOptions()): 这是一个静态成员函数，用于弹出一个颜色选择对话框。它允许你指定初始颜色（默认为白色）、父窗口、对话框标题以及一系列选项（如是否允许自定义颜色等）。用户选择颜色并关闭对话框后，该函数返回用户选择的颜色。如果用户取消操作，则返回一个无效的 QColor 对象。
非阻塞式打开颜色对话框
- void open(QObject *receiver, const char *member): 此方法以非阻塞方式打开颜色对话框，并允许你指定一个接收者（receiver）和一个槽函数（member），当对话框关闭时（无论是通过选择颜色还是取消操作），都会通过信号-槽机制调用指定的槽函数。注意，这种方法不直接返回颜色，而是依赖于信号-槽机制来处理用户的选择。

⭕参数说明

initial: 用于设置颜色对话框打开时默认显示的颜色。
parent: 指定颜色对话框的父窗口。如果指定了父窗口，颜色对话框将相对于父窗口进行定位，并在父窗口关闭时自动关闭。
title: 设置颜色对话框的标题文本。
options: 用于定义颜色对话框的行为选项，如是否显示颜色选择器的某些部分。
receiver 和 member: 在使用 open 方法时，分别指定当对话框关闭时应接收信号的QObject对象以及该对象上应调用的槽函数的名称（通过成员函数指针指定）。

三、使用示例

🎯功能说明：点击一个按钮时弹出一个颜色选择对话框，让用户选择一种颜色，并根据用户选择的颜色来修改窗口的背景色。

void MainWindow::on_pushButton_clicked()
{
    // 使用QColorDialog的静态函数getColor来弹出一个颜色选择对话框
    // 函数返回一个QColor对象，代表用户选择的颜色
    QColor color = QColorDialog::getColor(QColor(0, 255, 0), this, "选择颜色");
    qDebug() << color;

    // 准备一个字符数组用于存储QSS（Qt样式表）字符串
    // 样式表将用于设置窗口的背景色
    char style[1024] = { 0 }; // 初始化数组，确保它是空的

    // 使用sprintf函数将背景色的RGB值格式化为QSS字符串
    // 注意：这里假设RGB值都不会超过255，因此不会造成数组越界
    sprintf(style, "background-color: rgb(%d, %d, %d);", color.red(), color.green(), color.blue());

    // 使用setStyleSheet函数应用QSS字符串到MainWindow上
    this->setStyleSheet(style);
}