FileDialogRequest QML Type

A request for letting the user choose a (new or existing) file or directory. 更多...

import 语句: import QtWebEngine
Since: QtWebEngine 1.4

特性

方法

详细描述

A FileDialogRequest is passed as an argument of the WebEngineView::fileDialogRequested signal. It is generated when the file dialog is requested by the input element. See File Upload state .

The accepted property of the request indicates whether the request is handled by the user code or the default dialog should be displayed. If you set the accepted 特性到 true , make sure to call either dialogAccept () 或 dialogReject () afterwards.

The following code uses a custom dialog to handle the request:

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

Indicates whether the file picker dialog request has been handled by the signal handler.

If the property is false after any signal handlers for WebEngineView::fileDialogRequested have been executed, a default file picker dialog will be shown. To prevent this, set request.accepted to true .

默认为 false .

acceptedMimeTypes : stringlist [read-only]

A list of MIME types specified in the input element. The selection should be restricted to only these types of files.

defaultFileName : string [read-only]

The default name of the file to be selected in the dialog.

mode : enumeration [read-only]

The mode of the file dialog.

常量 描述
FileDialogRequest.FileModeOpen Allows users to specify a single existing file.
FileDialogRequest.FileModeOpenMultiple Allows users to specify multiple existing files.
FileDialogRequest.FileModeUploadFolder Allows users to specify a single existing folder for upload.
FileDialogRequest.FileModeSave Allows users to specify a non-existing file. If an existing file is selected, the users should be informed that the file is going to be overwritten.

方法文档编制

void dialogAccept ( stringlist 文件 )

This function needs to be called when the user accepted the dialog with 文件 .

void dialogReject ()

This function needs to be called when the user did not accepted the dialog.