FileDialog QML Type
Un cuadro de diálogo de archivos nativo. Más...
| Import Statement: | import Qt.labs.platform |
| Inherits: | |
| Status: | Deprecated since 6.9 |
Este tipo está obsoleto desde Qt Labs Platform 6.9. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- acceptLabel : string
- currentFile : url
- currentFiles : list<url>
- defaultSuffix : string
- file : url
- fileMode : enumeration
- files : list<url>
- folder : url
- nameFilters : list<string>
- options : flags
- rejectLabel : string
- selectedNameFilter
- selectedNameFilter.extensions : list<string>
- selectedNameFilter.index : int
- selectedNameFilter.name : string
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.

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 += widgetsCrea 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:
| Constante | Descripción |
|---|---|
FileDialog.OpenFile | El cuadro de diálogo se utiliza para seleccionar un archivo existente (por defecto). |
FileDialog.OpenFiles | El cuadro de diálogo se utiliza para seleccionar varios archivos existentes. |
FileDialog.SaveFile | El 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:
| Constante | Descripción |
|---|---|
FileDialog.DontResolveSymlinks | No resolver enlaces simbólicos en el cuadro de diálogo de archivos. Por defecto, los enlaces simbólicos se resuelven. |
FileDialog.DontConfirmOverwrite | No pedir confirmación si se selecciona un archivo ya existente. Por defecto, se solicita confirmación. |
FileDialog.ReadOnly | Indica que el cuadro de diálogo no permite crear directorios. |
FileDialog.HideNameFilterDetails | Indica 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.
| Nombre | Descripción |
|---|---|
| índice: int | Esta 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: cadena | Esta 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.