FileDialog QML Type

文件对话框。更多...

• 所有成员的列表，包括继承的成员
• 已弃用的成员

属性

• acceptLabel : string
• currentFolder : url
• defaultSuffix : string
• fileMode : enumeration
• nameFilters : list<string>
• options : flags
• rejectLabel : string
• selectedFile : url
• selectedFiles : list<url>
• selectedNameFilter
  • selectedNameFilter.extensions : list<string>
  • selectedNameFilter.globs : list<string>
  • selectedNameFilter.index : int
  • selectedNameFilter.name : string

详细说明

FileDialog 类型为文件对话框提供了一个 QML API。

要显示文件对话框，请创建 FileDialog 实例，设置所需属性，并调用open()。可通过currentFolder 属性确定对话框打开的文件夹。selectedFile 和selectedFiles 属性可用于确定对话框打开时选中的文件，并在用户在对话框中选择文件以及对话框被接受时进行更新。

import QtCore
import QtQuick
import QtQuick.Controls
import QtQuick.Dialogs

ApplicationWindow {
    width: 640
    height: 480
    visible: true

    header: ToolBar {
        Button {
            text: qsTr("Choose Image...")
            onClicked: fileDialog.open()
        }
    }

    Image {
        id: image
        anchors.fill: parent
        fillMode: Image.PreserveAspectFit
    }

    FileDialog {
        id: fileDialog
        currentFolder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
        onAccepted: image.source = selectedFile
    }
}

可用性

目前，以下平台支持原生平台文件对话框：

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

Qt Quick Dialogs 在没有原生实现的平台上，会使用Qt Quick 的实现作为备用方案。

另请参阅 FolderDialog 和StandardPaths 。

属性文档

acceptLabel : string

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

当设置为空字符串时，将使用底层平台的默认标签。默认标签通常为“Open ”或“Save ”，具体取决于对话框所处的“fileMode ”环境。

默认值为空字符串。

另请参阅 rejectLabel 。

currentFolder : url

该属性存储用于选择文件的文件夹。可以设置该属性来控制对话框打开时显示的初始目录。

若要选择文件夹，请改用FolderDialog 。

defaultSuffix : string

此属性保存一个后缀，该后缀将附加到未指定后缀的选定文件上。该后缀通常用于标识文件类型（例如，“txt”表示文本文件）。

如果文件名的第一个字符是点（'.'），则将其删除。

fileMode : enumeration

该属性保存对话框的模式。

可用值：

nameFilters : list<string>

此属性包含用于限制可选文件类型的筛选条件。

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

不同平台可能以不同方式限制可选文件。例如，macOS 会禁用不符合筛选条件的文件条目，而 Windows 则会将其隐藏。

另请参阅 selectedNameFilter 。

options : flags

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

默认情况下，所有选项均处于禁用状态。

应在显示对话框之前设置这些选项。若在对话框可见时进行设置，则无法保证能立即对对话框产生影响（具体取决于选项和平台）。

可用选项：

rejectLabel : string

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

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

默认值为空字符串。

另请参阅 acceptLabel 。

selectedFile : url

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

可以通过设置该属性来控制对话框打开时选中的文件。

如果有多个选定的文件，则该属性指代第一个文件。

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

另请参阅 selectedFiles 、accepted() 和currentFolder 。

selectedFiles : list<url>

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

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

另请参阅 accepted() 和currentFolder 。

selectedNameFilter group

这些属性保存了当前选中的名称过滤条件。

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

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

另请参阅 nameFilters 。