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)

以QColor 值返回给定index 的自定义颜色。

另请参阅 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 （如果没有指定，则使用 "选择颜色"）弹出模式颜色对话框，让用户选择颜色，并返回该颜色。颜色初始设置为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 为 true，则设置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)

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

另请参阅 setStandardColor()。

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

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

另请参阅 options 和setOption()。