FileDialogRequest QML Type

Eine Aufforderung, den Benutzer eine (neue oder vorhandene) Datei oder ein Verzeichnis auswählen zu lassen. Mehr...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.4

Eigenschaften

Methoden

Detaillierte Beschreibung

Ein FileDialogRequest wird als Argument des Signals WebEngineView::fileDialogRequested übergeben. Es wird erzeugt, wenn der Dateidialog durch das Eingabeelement angefordert wird. Siehe Status des Dateiuploads.

Die Eigenschaft accepted der Anforderung gibt an, ob die Anforderung durch den Benutzercode behandelt wird oder der Standarddialog angezeigt werden soll. Wenn Sie die Eigenschaft accepted auf true setzen, stellen Sie sicher, dass Sie anschließend entweder dialogAccept() oder dialogReject() aufrufen.

Der folgende Code verwendet ein benutzerdefiniertes Dialogfeld, um die Anfrage zu bearbeiten:

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;
    }
    // ...
}

Eigenschaft Dokumentation

accepted : bool

Zeigt an, ob die Anforderung des Dateiauswahldialogs durch den Signalhandler bearbeitet wurde.

Wenn die Eigenschaft false lautet, nachdem alle Signalhandler für WebEngineView::fileDialogRequested ausgeführt wurden, wird ein Standarddialogfeld für die Dateiauswahl angezeigt. Um dies zu verhindern, setzen Sie request.accepted auf true.

Die Standardeinstellung ist false.


acceptedMimeTypes : stringlist [read-only]

Eine Liste von MIME-Typen, die im Eingabeelement angegeben sind. Die Auswahl sollte nur auf diese Dateitypen beschränkt werden.


defaultFileName : string [read-only]

Der Standardname der Datei, die im Dialog ausgewählt werden soll.


mode : enumeration [read-only]

Der Modus des Dateidialogs.

KonstanteBeschreibung
FileDialogRequest.FileModeOpenErlaubt dem Benutzer, eine einzelne vorhandene Datei anzugeben.
FileDialogRequest.FileModeOpenMultipleErmöglicht es dem Benutzer, mehrere vorhandene Dateien anzugeben.
FileDialogRequest.FileModeUploadFolderErmöglicht Benutzern die Angabe eines einzelnen vorhandenen Ordners für den Upload.
FileDialogRequest.FileModeSaveErmöglicht es dem Benutzer, eine nicht vorhandene Datei anzugeben. Wenn eine vorhandene Datei ausgewählt wird, sollten die Benutzer darüber informiert werden, dass die Datei überschrieben wird.

Dokumentation der Methode

void dialogAccept(stringlist files)

Diese Funktion muss aufgerufen werden, wenn der Benutzer den Dialog mit files akzeptiert hat.


void dialogReject()

Diese Funktion muss aufgerufen werden, wenn der Benutzer den Dialog nicht akzeptiert hat.


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