QML类型：FileDialog、FolderDialog、ColorDialog、FontDialog （Qt Labs Platform）

FileDialog

一、描述

此类型提供原生平台文件选择对话框。继承自 Qt Labs Platform 模块版本的 Dialog。

Qt Labs Platform 模块使用 Qt Widgets 作为没有可用本机实现的平台的后备。因此，使用来自 Qt Labs Platform 模块的类型的应用程序应该链接到 QtWidgets 并使用 QApplication 而不是 QGuiApplication。

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

二、属性成员

1、acceptLabel : string

对话框上接受按钮显示的标签文本。默认值为空字符串。

当设置为空字符串时，使用底层平台的默认标签。 默认标签通常是打开或保存，具体取决于使用对话框的文件模式。

      rejectLabel : string

对话框上拒绝按钮显示的标签文本。默认值为空字符串。

当设置为空字符串时，使用底层平台的默认标签。 默认标签通常是取消。

2、currentFile : url

对话框中当前选定的文件。此属性会在用户在对话框中选择文件时更新。

3、currentFiles : list<url>

对话框中当前选定的文件列表。此属性会在用户在对话框中选择文件时更新，

4、defaultSuffix : string

添加到未指定后缀的选定文件的后缀。后缀通常用于表示文件类型（如“txt”表示文本文件）。

如果第一个字符是点 ('.')，则将其删除。

5、file : url

最终接受的文件。

当用户在对话框中选择文件时，此属性不会更新，而只会在最终选择完成后更新。即当用户单击确定接受文件或处理 accepted() 信号以获得最终选择。本篇其他对话框也类似。

6、fileMode : enumeration

对话框的模式。

• FileDialog.OpenFile：该对话框用于选择现有文件（默认）。
• FileDialog.OpenFiles：该对话框用于选择多个现有文件。
• FileDialog.SaveFile：该对话框用于选择任何文件。该文件不必存在。

7、files : list<url>

最终接受的文件。当用户在对话框中选择文件时，此属性不会更新，而只会在最终选择完成后更新。即当用户单击确定接受文件或处理 accepted() 信号以获得最终选择。

8、folder : url

选择文件的文件夹。

9、nameFilters : list<string>

限制可以选择的文件类型的过滤器。

注意：*.* 不是可移植过滤器，因为文件扩展名决定文件类型的历史假设在每个操作系统上都不一致。在本机 Windows 文件对话框中，*.* 将匹配此类文件，而在其他类型的文件对话框中可能不会。 因此，如果您要选择任何文件，最好使用 *。

FileDialog {
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

10、options : flags

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

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

• FileDialog.DontResolveSymlinks：不解析文件对话框中的符号链接。
• FileDialog.DontConfirmOverwrite：如果选择了现有文件，则不要求确认。
• FileDialog.ReadOnly：指示对话框不允许创建目录。
• FileDialog.HideNameFilterDetails：指示文件名过滤器详细信息是否隐藏。

11、selectedNameFilter 组：这些属性包含当前选定的名称过滤器。

       【只读】selectedNameFilter.extensions : list<string>

所选过滤器的扩展名列表。在下面的示例中，第一个过滤器的扩展名列表是 ["txt"]，第二个是 ["html", "htm"]。

       selectedNameFilter.index : int

确定选择哪个名称过滤器。打开对话框时选择指定的过滤器。 当用户选择另一个过滤器时，该值会更新。

       【只读】selectedNameFilter.name : string

所选过滤器的名称。在下面的示例中，第一个过滤器的名称是“Text files”，第二个是“HTML files”。

FileDialog {
    id: fileDialog
    selectedNameFilter.index: 1
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

MyDocument {
    id: document
    fileType: fileDialog.selectedNameFilter.extensions[0]
}

---

FolderDialog

一、描述

此类型提供原生平台文件夹选择对话框。继承自 Qt Labs Platform 模块版本的 Dialog。

二、属性成员

1、currentFolder : url

对话框中当前选定的文件夹。

2、folder : url

最终接受的文件夹。

3、options : flags

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

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

• FolderDialog.ShowDirsOnly：仅在文件夹对话框中显示目录。
• FolderDialog.DontResolveSymlinks：不解析文件夹对话框中的符号链接。
• FolderDialog.ReadOnly：指示对话框不允许创建目录。

其他属性见 FileDialog。

---

ColorDialog

一、描述

颜色对话框。

二、属性成员

1、color : color

最终接受的颜色。

2、currentColor : color

对话框中当前选定的颜色。此属性会在用户在对话框中选择颜色时更新。

3、options : flags

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

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

• ColorDialog.ShowAlphaChannel：允许用户选择颜色的 alpha 分量。
• ColorDialog.NoButtons：不显示确定和取消按钮。

---

FontDialog

一、描述

字体对话框。

二、属性成员

1、currentFont : font

当前选定的字体。此属性会在用户在对话框中选择字体时更新。

2、selectedFont : font

最终接受的字体。

3、options : flags

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

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

• FontDialog.ScalableFonts：显示可缩放字体。
• FontDialog.NonScalableFonts：显示不可缩放的字体。
• FontDialog.MonospacedFonts：显示等宽字体。
• FontDialog.ProportionalFonts：显示比例字体。
• FontDialog.NoButtons：不显示打开和取消按钮。