Back to Qt.io
Contact Us Blog Download Qt

FolderDialog QML Type

本地文件夹对话框。更多

Import Statement: import QtQuick.Dialogs
Since: Qt 6.3
Inherits:

Dialog

属性

详细说明

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
}

可用性

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

  • 安卓
  • iOS
  • Linux（使用 GTK+ 平台主题运行时）
  • MacOS
  • Windows

Qt Quick Dialogs 在没有本地实现的平台上，使用 实现作为备用。Qt Quick

另请参阅 FileDialog 和StandardPaths 。

属性文档

acceptLabel : string

该属性用于保存接受对话框的按钮上显示的标签文本。

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

默认值为空字符串。

另请参阅 rejectLabel 。


currentFolder : url

该属性用于保存当前显示在对话框中的文件夹。

另请参阅 selectedFolder 。


options : flags

该属性包含影响对话框外观的各种选项。

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

应在显示对话框之前设置选项。如果在对话框可见时设置这些选项，则不能保证立即对对话框产生影响（取决于选项和平台）。

可用选项

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

rejectLabel : string

该属性用于保存拒绝对话框按钮上显示的标签文本。

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

默认值为空字符串。

另请参阅 acceptLabel 。


selectedFolder : url

该属性保存对话框中最后选择的文件夹。

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

另请参阅 currentFolder 和accepted()。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.