QColorDialog类继承于QDialog,是一个设计用来选择颜色的对话框部件。
对话框窗口 QDialog
QColorDialog颜色选择器一般用来让用户选择颜色,比如画图工具中选择画笔的颜色、刷子的颜色等。你可以使用静态函数QColorDialog::getColor()直接显示对话框,然后重新选择颜色,还能选择具有透明度的颜色,选择的颜色保存在函数返回的一个QColor类型的返回值。
用户通过预设的颜色表格选择颜色,或者通过输入RGB值选择,或者通过鼠标在触屏上滑动寻找想要的颜色。按下Enter键触发确认,按下ESC键触发退出。
QColorDialog *cdia = new QColorDialog(this);
cdia->setWindowTitle("my color dialog");
cdia->setCurrentColor(QColor("red"));
cdia->exec();
或者:
QColorDialog::getColor(QColor("red"),
this,
"my color dialog",
QColorDialog::DontUseNativeDialog);
该属性表示当前在对话框中选择的颜色。
QColor currentColor() const
void setCurrentColor(const QColor &color)
该属性表示外观的一些显示策略,默认没有策略。如果需要的话,需要在显示之前设置此策略。
QColorDialog::ColorDialogOptions options() const
void setOptions(QColorDialog::ColorDialogOptions options)
QColorDialog::ColorDialogOption 描述 ShowAlphaChannel 允许用户选择颜色的alpha分量。 NoButtons 不要显示OK和Cancel按钮。 DontUseNativeDialog 使用Qt的标准颜色对话框,而不是操作系统自带的颜色对话框。
在linux下颜色对话框样式为:
设置DontUseNativeDialog|ShowAlphaChannel之后会恢复成标准对话框,并且多了一个alpha通道数值的输入。
打开对话框,并且连接colorSelected信号绑定的槽,当对话框关闭的时候,这个信号槽连接会被断开。
void open(QObject *receiver, const char *member)
示例:打开的同时绑定colorSelected信号的作用槽函数,控制台输出选择的颜色RGB。
public slots:
void onColorSelected(const QColor &color);
void MainWindow::onColorSelected(const QColor &color)
{
qDebug()<
QColorDialog *dia = new QColorDialog(this);
dia->resize(800,600);
dia->setWindowTitle("my color dialog");
dia->setCurrentColor(QColor("red"));
dia->setOptions(QColorDialog::DontUseNativeDialog | QColorDialog::ShowAlphaChannel);
dia->open(this,SLOT(onColorSelected(const QColor &)));
单独设置某一项显示策略的使能,参考上文options。
void setOption(QColorDialog::ColorDialogOption option, bool on = true)
返回某一项显示策略的使能,对应上文setOption。
bool testOption(QColorDialog::ColorDialogOption option) const
返回当前选择的颜色。
QColor selectedColor() const
返回自定义颜色的索引对应的颜色。
QColor customColor(int index)
设置自定义颜色每个索引对应的颜色。
void setCustomColor(int index, QColor color)
返回标准颜色的索引对应的颜色。
QColor standardColor(int index)
设置标准颜色的索引对应的颜色
void setStandardColor(int index, QColor color)
返回自定义颜色的数量。
int customCount()
使用模式状态打开对话框,默认给定颜色initial为白色可修改,还可传入窗口标题title和颜色对话框显示策略options。
QColor getColor(const QColor &initial = Qt::white,
QWidget *parent = nullptr,
const QString &title = QString(),
QColorDialog::ColorDialogOptions options = ColorDialogOptions())
用户按下ok之后或者确认之后触发该信号。
void colorSelected(const QColor &color)
当窗口的颜色发生变化就会触发该信号。
void currentColorChanged(const QColor &color)