QColorDialog Class

成员函数文档

[explicit] QColorDialog::QColorDialog(QWidget *parent = nullptr)

根据给定的parent 创建一个颜色对话框。

[explicit] QColorDialog::QColorDialog(const QColor &initial, QWidget *parent = nullptr)

根据给定的parent 和指定的initial 颜色，构建一个颜色对话框。

[virtual noexcept] QColorDialog::~QColorDialog()

关闭颜色对话框。

[override virtual protected] void QColorDialog::changeEvent(QEvent *e)

重写了：QWidget::changeEvent(QEvent *event)。

[signal] void QColorDialog::colorSelected(const QColor &color)

当用户点击OK 选择要使用的颜色后，系统会立即触发此信号。所选颜色由color 指定。

另请参阅 color和currentColorChanged()。

[signal] void QColorDialog::currentColorChanged(const QColor &color)

每当对话框中的当前颜色发生变化时，都会触发此信号。当前颜色由color 指定。

另请参阅 color和colorSelected()。

[static] QColor QColorDialog::customColor(int index)

返回位于指定index 处的自定义颜色，其值为QColor 。

另请参阅 setCustomColor()。

[static] int QColorDialog::customCount()

返回QColorDialog 支持的自定义颜色数量。所有颜色对话框共享相同的自定义颜色。

[override virtual protected] void QColorDialog::done(int result)

重写：QDialog::done(int r)。

关闭对话框，并将结果代码设置为result 。如果该对话框是通过exec()显示的，则done()会导致本地事件循环结束，并使exec()返回result 。

另请参阅 QDialog::done()。

[static] QColor QColorDialog::getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions())

弹出一个模态颜色对话框，其窗口title （若未指定则默认为“Select Color”），允许用户选择颜色，并返回该颜色。颜色初始值设为initial 。该对话框是parent 的子窗口。如果用户取消对话框，则返回一个无效的颜色（参见QColor::isValid()）。

通过options 参数，您可以自定义该对话框。

void QColorDialog::open(QObject *receiver, const char *member)

打开对话框，并将该对话框的colorSelected()信号连接到由receiver 和member 指定的槽。

当对话框关闭时，该信号将与该槽断开连接。

QColor QColorDialog::selectedColor() const

返回用户通过单击OK 或等效按钮所选定的颜色。

[static] void QColorDialog::setCustomColor(int index, QColor color)

将index 中的自定义颜色设置为QColor color 的值。

另请参阅 customColor()。

void QColorDialog::setOption(QColorDialog::ColorDialogOption option, bool on = true)

如果on 为真，则启用给定的option ；否则，清除给定的option 。

另请参阅 options 和testOption()。

[static] void QColorDialog::setStandardColor(int index, QColor color)

将“index ”中的标准颜色设置为“QColor ”的color 值。

另请参阅 standardColor()。

[override virtual] void QColorDialog::setVisible(bool visible)

重写：QDialog::setVisible （bool visible）。

更改对话框的可见性。如果visible 为 true，则显示对话框；否则，则隐藏对话框。

[static] QColor QColorDialog::standardColor(int index)

返回给定坐标index 处标准颜色的QColor 值。

另请参阅 setStandardColor()。

bool QColorDialog::testOption(QColorDialog::ColorDialogOption option) const

如果给定的option 已启用，则返回true ；否则，返回false。

另请参阅 options 和setOption()。