FolderDialog QML 类型

本地文件夹对话框。更多...

导入语句	import Qt.labs.platform
继承	Dialog

所有成员列表，包括继承的成员

属性

acceptLabel : string
currentFolder : url
folder : url
options : flags
rejectLabel : string

详细描述

FolderDialog 类型提供了一种 QML API，用于原生平台文件夹对话框。

要显示文件夹对话框，构造 FolderDialog 实例，设置所需的属性，并调用 open() 方法。可以使用 currentFolder 属性确定对话框中当前选定的文件夹。folder 属性只在接受对话框并做出最后选择之后更新。

MenuItem {
    text: "Open..."
    onTriggered: folderDialog.open()
}

FolderDialog {
    id: folderDialog
    currentFolder: viewer.folder
    folder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
}

MyViewer {
    id: viewer
    folder: folderDialog.folder
}

可用性

本地平台文件夹对话框目前在以下平台上可用

Android
iOS
Linux（当运行带有 GTK+ 平台主题时）
macOS
Windows

Qt 实验室平台模块在不可用本地实现的平台上使用 Qt Widgets 作为后备。因此，使用 Qt 实验室平台模块的类型的应用程序应链接到 QtWidgets 并使用 QApplication 而不是 QGuiApplication。

要将 QtWidgets 库链接到您的 qmake 项目文件，请添加以下内容

QT += widgets

在 main() 中创建 QApplication 实例

#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();
}

注意： Qt.labs 模块中的类型在未来的版本中不保证保持兼容性。

另请参阅 FileDialog 和 StandardPaths。

属性文档

acceptLabel : string

此属性包含显示在接受对话框按钮上的标签文本。

设置为空字符串时，使用底层平台默认标签。默认标签通常为 Open。

默认值为空字符串。

另请参阅 rejectLabel。

currentFolder : url

此属性包含对话框中当前选定的文件夹。

与folder属性不同，currentFolder属性在用户在对话框中选择文件夹时更新，甚至在最终选择完成之前。

另请参阅folder。

folder : url

此属性持有最终接受文件夹。

与currentFolder属性不同，当用户在对话框中选择文件夹时，folder属性将不会更新，只有在最终选择完成后才会更新。也就是说，当用户点击确定按钮接受文件夹时。或者，可以通过处理accepted()信号来获取最终选择。

另请参阅currentFolder和accepted。

options : flags

此属性持有影响对话框外观和感觉的各选项。

默认情况下，所有选项均未启用。

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

可用的选项

常数	描述
`FolderDialog.ShowDirsOnly`	仅在文件夹对话框中显示目录。默认情况下，文件夹和目录都会显示。
`FolderDialog.DontResolveSymlinks`	不在文件夹对话框中解析符号链接。默认情况下会解析符号链接。
`FolderDialog.ReadOnly`	表示对话框不允许创建目录。

rejectLabel : string

此属性持有显示在拒绝对话框按钮上的标签文本。

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

默认值为空字符串。

另请参阅acceptLabel。