QColorDialog 类

成员函数文档

[显式] QColorDialog::QColorDialog(QWidget *parent = nullptr)

以给定的 parent 构造颜色对话框。

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

以给定的 parent 和指定的 initial 颜色构造颜色对话框。

[虚 效果无副作用] QColorDialog::~QColorDialog()

销毁颜色对话框。

[重写 虚 纯保护] void QColorDialog::changeEvent(QEvent *e)

重新实现: QWidget::changeEvent(QEvent *event).

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

在用户点击 OK 选中颜色后发出此信号。所选颜色由 color 指定。

另请参阅color 和 currentColorChanged。

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

每当对话框中当前颜色改变时发出此信号。当前颜色由 color 指定。

另请参阅color 和 colorSelected。

[静态] QColor QColorDialog::customColor(int index)

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

另请参阅setCustomColor。

[静态] int QColorDialog::customCount()

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

[重写 虚 纯保护] void QColorDialog::done(int result)

重新实现: QDialog::done(int r).

关闭对话框并将其实际结果代码设置为 result。如果使用 exec() 显示此对话框，则 done() 会结束本地事件循环，并导致 exec() 返回 result。

另请参阅QDialog::done。

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

弹出带有指定窗口 标题（如果未指定，则为“选择颜色”）的模态颜色对话框，让用户选择一种颜色，并返回该颜色。颜色初始设置为 initial。对话框是 parent 的子项。如果用户取消对话框，则返回无效（见 QColor::isValid()）的颜色。

options 参数允许您自定义对话框。

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

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

当对话框关闭时，将从槽中断开信号。

QColor QColorDialog::selectedColor() const

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

[静态] 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。

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

将索引为 index 的标准颜色设置为 QColor color 值。

另请参阅 standardColor。

[覆盖虚函数] void QColorDialog::setVisible(bool visible)

重新实现： QDialog::setVisible(bool visible).

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

[静态] QColor QColorDialog::standardColor(int index)

返回给定 索引 的标准颜色作为 QColor 值。

另请参阅setStandardColor。

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

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

另请参阅options 和 setOption。