En esta página

FileDialog QML Type

Un cuadro de diálogo de archivos nativo. Más...

Import Statement: import Qt.labs.platform
Inherits:

Dialog

Status: Deprecated since 6.9

Este tipo está obsoleto desde Qt Labs Platform 6.9. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Descripción detallada

Utiliza en su lugar QtQuick.Dialogs FileDialog.

El tipo `FileDialog` proporciona una API de QML para los cuadros de diálogo de archivos nativos de la plataforma.

Un cuadro de diálogo de archivos nativo

Para mostrar un cuadro de diálogo de archivos, cree una instancia de FileDialog, establezca las propiedades deseadas y llame a open(). Las propiedades currentFile o currentFiles se pueden utilizar para determinar los archivos seleccionados actualmente en el cuadro de diálogo. Las propiedades file y files solo se actualizan una vez que se ha realizado la selección final al aceptar el cuadro de diálogo.

MenuItem {
    text: "Open..."
    onTriggered: fileDialog.open()
}

FileDialog {
    id: fileDialog
    currentFile: document.source
    folder: StandardPaths.writableLocation(StandardPaths.DocumentsLocation)
}

MyDocument {
    id: document
    source: fileDialog.file
}

Disponibilidad

Actualmente, el cuadro de diálogo de archivos nativo de la plataforma está disponible en las siguientes plataformas:

  • Android
  • iOS
  • Linux (cuando se ejecuta con el tema de plataforma GTK+)
  • macOS
  • Windows

El módulo « Qt Labs Platform » utiliza « Qt Widgets » como alternativa en plataformas que no disponen de una implementación nativa. Por lo tanto, las aplicaciones que utilicen tipos del módulo « Qt Labs Platform » deben vincularse a « QtWidgets » y utilizar « QApplication » en lugar de « QGuiApplication ».

Para vincularse a la biblioteca QtWidgets, añade lo siguiente a tu archivo de proyecto qmake:

QT += widgets

Crea una instancia de ` QApplication ` en ` main()`:

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.

Véase también QtQuick.Dialogs::FileDialog, FolderDialog y StandardPaths.

Documentación de propiedades

acceptLabel : string

Esta propiedad contiene el texto de la etiqueta que se muestra en el botón que permite cerrar el cuadro de diálogo.

Cuando se establece en una cadena vacía, se utiliza la etiqueta predeterminada de la plataforma subyacente. La etiqueta predeterminada suele ser « Open » o « Save », dependiendo de en qué « fileMode » se utilice el cuadro de diálogo.

El valor por defecto es una cadena vacía.

Véase también rejectLabel.

currentFile : url

Esta propiedad contiene el archivo seleccionado actualmente en el cuadro de diálogo.

A diferencia de la propiedad « file », la propiedad « currentFile » se actualiza mientras el usuario selecciona archivos en el cuadro de diálogo, incluso antes de que se haya realizado la selección definitiva.

Véase también « file » y « currentFiles ».

currentFiles : list<url>

Esta propiedad contiene los archivos seleccionados actualmente en el cuadro de diálogo.

A diferencia de la propiedad « files », la propiedad « currentFiles » se actualiza mientras el usuario selecciona archivos en el cuadro de diálogo, incluso antes de que se haya realizado la selección definitiva.

Véase también « files » y « currentFile ».

defaultSuffix : string

Esta propiedad contiene una extensión que se añade a los archivos seleccionados que no tienen ninguna extensión especificada. La extensión se suele utilizar para indicar el tipo de archivo (por ejemplo, «txt» indica un archivo de texto).

Si el primer carácter es un punto ('.'), se elimina.

file : url

Esta propiedad contiene el archivo final aceptado.

A diferencia de la propiedad « currentFile », la propiedad « file » no se actualiza mientras el usuario selecciona archivos en el cuadro de diálogo, sino solo una vez realizada la selección definitiva. Es decir, cuando el usuario ha hecho clic en « OK » para aceptar un archivo. Como alternativa, se puede gestionar la señal « accepted()» para obtener la selección definitiva.

Véase también currentFile y accepted().

fileMode : enumeration

Esta propiedad contiene el modo del cuadro de diálogo.

Valores disponibles:

ConstanteDescripción
FileDialog.OpenFileEl cuadro de diálogo se utiliza para seleccionar un archivo existente (por defecto).
FileDialog.OpenFilesEl cuadro de diálogo se utiliza para seleccionar varios archivos existentes.
FileDialog.SaveFileEl cuadro de diálogo se utiliza para seleccionar cualquier archivo. No es necesario que el archivo exista.

files : list<url>

Esta propiedad contiene los archivos aceptados definitivamente.

A diferencia de la propiedad « currentFiles », la propiedad « files » no se actualiza mientras el usuario selecciona archivos en el cuadro de diálogo, sino solo una vez realizada la selección definitiva. Es decir, cuando el usuario ha hecho clic en « OK » para aceptar los archivos. Como alternativa, se puede gestionar la señal « accepted()» para obtener la selección definitiva.

Véase también currentFiles y accepted().

folder : url

Esta propiedad contiene la carpeta en la que se seleccionan los archivos. Para seleccionar una carpeta, utiliza en su lugar FolderDialog.

Véase también FolderDialog.

nameFilters : list<string>

Esta propiedad contiene los filtros que restringen los tipos de archivos que se pueden seleccionar.

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

Nota: *.* no es un filtro portátil, ya que la suposición histórica de que la extensión del archivo determina su tipo no es válida en todos los sistemas operativos. Es posible que haya un archivo cuyo nombre no contenga ningún punto (por ejemplo, Makefile). En un cuadro de diálogo de archivos nativo de Windows, *.* coincidirá con dichos archivos, mientras que en otros tipos de cuadros de diálogo de archivos puede que no sea así. Por lo tanto, es mejor utilizar * si lo que se pretende es seleccionar cualquier archivo.

Véase también selectedNameFilter.

options : flags

Esta propiedad contiene las distintas opciones que influyen en el aspecto y el comportamiento del cuadro de diálogo.

Por defecto, todas las opciones están desactivadas.

Las opciones deben configurarse antes de mostrar el cuadro de diálogo. No se garantiza que su configuración mientras el cuadro de diálogo está visible tenga un efecto inmediato en el mismo (dependiendo de la opción y de la plataforma).

Opciones disponibles:

ConstanteDescripción
FileDialog.DontResolveSymlinksNo resolver enlaces simbólicos en el cuadro de diálogo de archivos. Por defecto, los enlaces simbólicos se resuelven.
FileDialog.DontConfirmOverwriteNo pedir confirmación si se selecciona un archivo ya existente. Por defecto, se solicita confirmación.
FileDialog.ReadOnlyIndica que el cuadro de diálogo no permite crear directorios.
FileDialog.HideNameFilterDetailsIndica si los detalles del filtro de nombres de archivo están ocultos o no.

rejectLabel : string

Esta propiedad contiene el texto de la etiqueta que se muestra en el botón que cierra el cuadro de diálogo.

Si se establece en una cadena vacía, se utiliza la etiqueta predeterminada de la plataforma subyacente. La etiqueta predeterminada suele ser « Cancel ».

El valor por defecto es una cadena vacía.

Véase también « acceptLabel ».

selectedNameFilter group

selectedNameFilter.extensions : list<string>

selectedNameFilter.index : int

selectedNameFilter.name : string

Estas propiedades contienen el filtro de nombres seleccionado actualmente.

NombreDescripción
índice: intEsta propiedad determina qué filtro de nombres ( name filter ) está seleccionado. El filtro especificado se selecciona al abrir el cuadro de diálogo. El valor se actualiza cuando el usuario selecciona otro filtro.
[solo lectura] nombre: cadenaEsta propiedad contiene el nombre del filtro seleccionado. En el ejemplo siguiente, el nombre del primer filtro es « "Text files" » y el del segundo es « "HTML files" ».
[solo lectura] extensiones: lista<cadena>Esta propiedad contiene la lista de extensiones del filtro seleccionado. En el ejemplo siguiente, la lista de extensiones del primer filtro es ["txt"] y la del segundo es ["html", "htm"].
FileDialog {
    id: fileDialog
    selectedNameFilter.index: 1
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

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

Véase también nameFilters.

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