文件夹对话框 QML 类型

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

导入声明	import QtQuick.Dialogs
自	Qt 6.3
继承	对话框

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

属性

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

详细描述

FolderDialog 类型提供了对本地平台文件夹对话框的 QML API 访问。

要显示文件夹对话框，构建一个 FolderDialog 实例，设置所需的属性，然后调用 open() 方法。可以通过 currentFolder 属性确定对话框中当前显示的文件夹。通过 selectedFolder 属性可以确定在对话框中最后选择的文件夹。

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

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

MyViewer {
    id: viewer
    folder: folderDialog.selectedFolder
}

可用性

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

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

在没有本地实现可用的平台上，Qt Quick 对话框使用 Qt Quick 实现作为后备。

另见FileDialog 和 StandardPaths。

属性文档

acceptLabel : string

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

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

默认值为空字符串。

另见rejectLabel。

currentFolder : url

此属性包含当前在对话框中显示的文件夹。

另见selectedFolder。

options : flags

此属性包含影响对话框外观和感觉的各种选项。

默认情况下，所有选项都被禁用。

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

可用选项

常数	描述
`FolderDialog.DontResolveSymlinks`	不要在文件夹对话框中解析符号链接。默认情况下解析符号链接。
`FolderDialog.ReadOnly`	表示对话框不允许创建目录。
`FolderDialog.DontUseNativeDialog`	强制对话框使用非本地快速实现。

rejectLabel : 字符串

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

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

默认值为空字符串。

另请参阅acceptLabel。

selectedFolder : URL

此属性存储在对话框中最后选择的文件夹。

每次用户在对话框中选择文件夹时，都会更新此属性的值，当对话框被接受时也会更新。或者，可以处理accepted() 信号来获取最终选择。

另请参阅currentFolder 和 accepted。