FileDialogRequest QML Type

让用户选择(新的或现有的)文件或目录的请求。更多

Import Statement: import QtWebEngine
Since: QtWebEngine 1.4

属性

方法

详细说明

FileDialogRequest 作为WebEngineView::fileDialogRequested 信号的参数传递。它在输入元素请求文件对话框时生成。请参阅文件上传状态

请求的accepted 属性表示该请求是由用户代码处理还是显示默认对话框。如果将accepted 属性设置为true ,请确保随后调用dialogAccept() 或dialogReject()。

以下代码使用自定义对话框处理请求:

WebEngineView {
    // ...
    onFileDialogRequested: function(request) {
        request.accepted = true;
        myDialog.request = request // keep the reference to the request
        myDialog.accept.connect(request.dialogAccept);
        myDialog.reject.connect(request.dialogReject);
        myDialog.visible = true;
    }
    // ...
}

属性文档

accepted : bool

表示文件选取器对话框请求是否已由信号处理程序处理。

如果在执行WebEngineView::fileDialogRequested 的任何信号处理程序后,属性为false ,则将显示默认的文件选取器对话框。为防止出现这种情况,请将request.accepted 设置为true

默认值为false


acceptedMimeTypes : stringlist [read-only]

输入元素中指定的 MIME 类型列表。选择范围应仅限于这些类型的文件。


defaultFileName : string [read-only]

要在对话框中选择的文件的默认名称。


mode : enumeration [read-only]

文件对话框的模式。

常量说明
FileDialogRequest.FileModeOpen允许用户指定一个现有文件。
FileDialogRequest.FileModeOpenMultiple允许用户指定多个现有文件。
FileDialogRequest.FileModeUploadFolder允许用户指定用于上传的单个现有文件夹。
FileDialogRequest.FileModeSave允许用户指定一个不存在的文件。如果选择的是现有文件,则应告知用户该文件将被覆盖。

方法文档

void dialogAccept(stringlist files)

当用户接受files 对话框时,需要调用此函数。


void dialogReject()

当用户未接受对话框时,需要调用此函数。


© 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.