QColorDialog、QFontDialog

QColorDialog

一、描述

颜色对话框的功能是允许用户选择颜色。

二、类型成员

1、enum QColorDialog::ColorDialogOption：此枚举指定影响颜色对话框外观的各种选项。

• ShowAlphaChannel：允许用户选择颜色的 alpha 分量。
• NoButtons：不显示确定和取消按钮。
• DontUseNativeDialog：使用 Qt 的标准颜色对话框而不是操作系统的原生颜色对话框。Windows系统看不出效果，下图是Mac下Qt标准颜色对话框和操作系统原生颜色对话框：

三、属性成员

1、currentColor : QColor

对话框中当前选定的颜色。

2、options : ColorDialogOptions

影响对话框外观的各种选项。默认情况下，所有选项都被禁用。

应在显示对话框之前设置选项。不能保证在对话框可见时设置它们会立即对对话框产生影响（取决于选项和平台）。

四、成员函数

1、QColorDialog(const QColor &initial, QWidget *parent = nullptr)

使用给定的父级和指定的初始颜色构造一个颜色对话框。

2、【信号】void colorSelected(const QColor &color)

在用户单击确定以选择要使用的颜色后，立即发出此信号。参数是所选颜色。

3、【信号】void currentColorChanged(const QColor &color)

只要对话框中的当前颜色发生变化，就会发出此信号。

4、【static】int customCount()

返回 QColorDialog 支持的自定义颜色的数量。

5、void done(int result)

重新实现：QDialog::done(int r)。

关闭对话框并将其结果代码设置为 result。如果此对话框与 exec() 一起显示，则 done() 导致本地事件循环完成，并且 exec() 返回结果。

6、【static】QColor getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions())

弹出带有给定窗口标题的模式颜色对话框，让用户选择一种颜色，然后返回该颜色。

如果用户取消对话框，它会返回一个无效的（QColor::isValid()）颜色。

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

7、void open(QObject *receiver, const char *member)

打开对话框并将其 colorSelected() 信号连接到接收者 receiver 和成员指定的槽 member。

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

8、QColor selectedColor()

返回用户通过单击确定选择的颜色。

此颜色并不总是与 currentColor 属性所持有的颜色相同，因为用户可以在最终选择要使用的颜色之前选择不同的颜色。

9、【static】void setCustomColor(int index, QColor color)

      【static】QColor customColor(int index)

设置 index 处的自定义颜色值。见上图。此功能不适用于 macOS 平台的原生颜色框。

      【static】void setStandardColor(int index, QColor color)

      【static】QColor standardColor(int index)

设置 index 处的标准颜色值。见上图。此功能不适用于 macOS 平台的原生颜色框。 

10、void setOption(QColorDialog::ColorDialogOption option，bool on = true)

启用或清除给定的选项。

      bool testOption(QColorDialog::ColorDialogOption option )

是否启用给定选项。

---

QFontDialog

一、描述

字体对话框。

二、类型成员

1、enum QFontDialog::FontDialogOption：此枚举指定影响字体对话框外观的各种选项。

• NoButtons：不显示确定和取消按钮。
• DontUseNativeDialog：在 Mac 上使用 Qt 的标准字体对话框而不是 Apple 的本机字体面板。
• ScalableFonts：显示可缩放字体
• NonScalableFonts：显示不可缩放字体
• MonospacedFonts：显示等宽字体
• ProportionalFonts：显示比例字体

三、属性成员

1、currentFont : QFont

对话框的当前字体。

2、options : FontDialogOptions

影响对话框外观的各种选项。默认所有选项都被禁用。应在显示对话框之前设置选项。

三、成员函数

1、【信号】void currentFontChanged(const QFont &newFont)

当前字体更改时发出此信号。

2、【信号】void fontSelected(const QFont &font)

当用户选择要使用的最终字体时发出信号。

3、QFont currentFont()

返回当前字体。

4、void done(int result)

重新实现：QDialog::done(int r)。

关闭对话框并将其结果代码设置为 result。如果此对话框与 exec() 一起显示，则 done() 导致本地事件循环完成，并且 exec() 返回结果。

5、【static】QFont getFont(bool *ok, const QFont &initial, QWidget *parent = nullptr, const QString &title = QString(), QFontDialog::FontDialogOptions options = FontDialogOptions())

      【static】QFont getFont(bool *ok, QWidget *parent = nullptr)

执行模态字体对话框并返回字体。

如果用户单击确定，则返回所选字体。如果用户单击取消，则返回初始字体。

该对话框由给定的父级和选项中指定的选项构成。title 显示为对话框的窗口标题，initial 是最初选择的字体。如果 ok 参数不为空，则当用户单击确定按钮时，它所引用的值设置为 true，如果用户单击取消按钮时，则设置为 false。

bool ok;
QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
if (ok) 
{
    //字体设置为用户选择的字体
} 
else 
{
    // 用户取消了对话框； 字体设置为初始值
}

6、void open(QObject *receiver, const char *member)

打开对话框并将其 fontSelected() 信号连接到接收者 receiver 和成员指定的槽 member。

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

7、QFont selectedFont()

返回用户通过单击确定选择的字体。

8、void setCurrentFont(const QFont &font)

将 QFontDialog 中突出显示的字体设置为给定字体。

9、void setOption(QFontDialog::FontDialogOption option，bool on = true)

启用或清除选项。

      bool testOption(QFontDialog::FontDialogOption option)

是否启用了选项。