En esta página

FileDialogRequest QML Type

Una petición para que el usuario elija un archivo o directorio (nuevo o existente). Más...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.4

Propiedades

Métodos

Descripción detallada

Un FileDialogRequest se pasa como argumento de la señal WebEngineView::fileDialogRequested. Se genera cuando el diálogo de archivo es solicitado por el elemento de entrada. Véase el estado de carga de archivos.

La propiedad accepted de la petición indica si la petición es manejada por el código de usuario o se debe mostrar el diálogo por defecto. Si establece la propiedad accepted a true, asegúrese de llamar después a dialogAccept() o dialogReject().

El siguiente código utiliza un diálogo personalizado para gestionar la petición:

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

Documentación de la propiedad

accepted : bool

Indica si la petición de diálogo del selector de archivos ha sido gestionada por el manejador de señales.

Si la propiedad es false después de que se haya ejecutado cualquier manejador de señales para WebEngineView::fileDialogRequested, se mostrará un diálogo selector de archivos por defecto. Para evitar esto, establezca request.accepted a true.

El valor por defecto es false.

acceptedMimeTypes : stringlist [read-only]

Una lista de tipos MIME especificados en el elemento de entrada. La selección debe restringirse únicamente a estos tipos de archivos.

defaultFileName : string [read-only]

El nombre por defecto del archivo que se seleccionará en el diálogo.

mode : enumeration [read-only]

El modo del diálogo de archivo.

ConstanteDescripción
FileDialogRequest.FileModeOpenPermite a los usuarios especificar un único archivo existente.
FileDialogRequest.FileModeOpenMultiplePermite especificar varios archivos existentes.
FileDialogRequest.FileModeUploadFolderPermite a los usuarios especificar una única carpeta existente para cargar.
FileDialogRequest.FileModeSavePermite a los usuarios especificar un archivo no existente. Si se selecciona un archivo existente, se debe informar a los usuarios de que el archivo se va a sobrescribir.

Documentación del método

void dialogAccept(stringlist files)

Esta función debe ser llamada cuando el usuario acepta el diálogo con files.

void dialogReject()

Esta función debe ser llamada cuando el usuario no ha aceptado el diálogo.

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