用于从本地文件系统中选择文件的Dialog组件。
import QtQuick.Dialogs 1.3
属性
-
defaultSuffix
:(string)默认后缀 -
fileUrl
:(url):用户选择的文件路径。
注意:仅当选择了一个文件时才设置此属性。在所有其他情况下,它将是空的。 -
fileUrls
:(list<url>)用户选中的所有文件路径构成的列表 -
folder
:(url,默认为空)当前选中文件夹
在调用open()
之前设置此属性将导致文件浏览器最初位于指定的文件夹上。关闭对话框后,还会更新此属性的值。 -
modality
:Qt::WindowModality
是否应该相对于包含对话框的父项,相对于整个应用程序的模态或非模态的窗口模式显示对话框。
默认情况下,它是Qt.WindowModal
。模态并不意味着有任何阻塞调用等待接受或拒绝对话;只是防止用户同时与父窗口和/或应用程序窗口进行交互。您可能需要编写 onAccepted 处理程序来实际加载或保存所选文件。
-
nameFilters
:(list<string>)要用作文件名过滤器的字符串列表。
每个字符串可以是以空格分隔的过滤器列表;过滤器可能包括?和*通配符。过滤器列表也可以括在括号中,并且可以提供过滤器的文本描述。
Note: Directories are not excluded by filters.FileDialog { nameFilters: [ "Image files (*.jpg *.png)", "All files (*)" ] }
-
selectExisting
:(bool,默认为 true)是否只能选择现有文件或目录。
在打开对话框之前,必须将此属性设置为所需的值。
将此属性设置为 false 意味着该对话框用于命名要保存内容的文件,或命名要创建的文件夹;因此selectMultiple
必须为 false。 -
selectFolder
:(bool,默认为 false)所选项目是否应为文件夹。
在打开对话框之前,必须将此属性设置为所需的值。
将此属性设置为true意味着selectMultiple
必须为 false,并且selectExisting
必须为true。 -
selectMultiple
:(bool,默认为 false)是否可以选择多个文件名。
在打开对话框之前,必须将此属性设置为所需的值。
将此属性设置为true意味着selectExisting必须为true。 -
selectedNameFilter
:(string)目前选择了哪个nameFilters。
可以在对话框可见之前设置此属性,设置默认名称过滤器,也可以在对话框可见时设置此属性以设置当前名称过滤器。
当用户选择不同的过滤器时,它也会更新。 -
shortcuts
:(Object
)从 QStandardPaths 到其 URL 的一些有用路径的映射。在创建 FileDialog 时,每个路径都会在添加到此列表之前验证是否存在于用户的计算机上。desktop
QStandardPaths::DesktopLocation The user's desktop directory. documents
QStandardPaths::DocumentsLocation The directory containing user document files. home
QStandardPaths::HomeLocation The user's home directory. music
QStandardPaths::MusicLocation The directory containing the user's music or other audio files. movies
QStandardPaths::MoviesLocation The directory containing the user's movies and videos. pictures
QStandardPaths::PicturesLocation The directory containing the user's pictures or photos.
For example, shortcuts.home
will provide the URL of the user's home directory.
-
sidebarVisible
:(bool)
此属性保存包含快捷方式和书签的对话框中的侧边栏是否可见。
默认情况下,它取决于应用程序设置的QQControlsFileDialog部分中存储的设置。 -
title
:(string)对话框窗口的标题。 -
visible
:(bool,默认为 false)对话框是否可见
方法
-
void open()
:显示用户的对话框。它相当于将visible设置为true。 -
void close()
:关闭对话框。