FolderDialog QML Type
Un cuadro de diálogo de carpetas 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
- currentFolder : url
- folder : url
- options : flags
- rejectLabel : string
Descripción detallada
Utiliza en su lugar ` QtQuick.Dialogs FolderDialog `.
El tipo FolderDialog proporciona una API de QML para los cuadros de diálogo de carpetas de la plataforma nativa.

Para mostrar un cuadro de diálogo de carpetas, cree una instancia de FolderDialog, establezca las propiedades deseadas y llame a open(). La propiedad currentFolder se puede utilizar para determinar la carpeta seleccionada actualmente en el cuadro de diálogo. La propiedad folder solo se actualiza una vez que se ha realizado la selección definitiva al aceptar el cuadro de diálogo.
MenuItem {
text: "Open..."
onTriggered: folderDialog.open()
}
FolderDialog {
id: folderDialog
currentFolder: viewer.folder
folder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
}
MyViewer {
id: viewer
folder: folderDialog.folder
}Disponibilidad
Actualmente, el cuadro de diálogo de carpetas nativo de la plataforma está disponible en las siguientes plataformas:
- Android
- iOS
- Linux (cuando se ejecuta con el tema de la plataforma GTK+)
- macOS
- Windows
El módulo Qt Labs Platform utiliza Qt Widgets como alternativa en aquellas plataformas que no dispongan de una implementación nativa. Por lo tanto, las aplicaciones que utilicen tipos del módulo Qt Labs Platform deben enlazarse con QtWidgets y utilizar QApplication en lugar de QGuiApplication.
Para vincular 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::FolderDialog, FileDialog 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.
Si se establece en una cadena vacía, se utiliza la etiqueta predeterminada de la plataforma subyacente. La etiqueta predeterminada suele ser « Open ».
El valor por defecto es una cadena vacía.
Véase también « rejectLabel ».
currentFolder : url
Esta propiedad contiene la carpeta seleccionada actualmente en el cuadro de diálogo.
A diferencia de la propiedad « folder », la propiedad « currentFolder » se actualiza mientras el usuario selecciona carpetas en el cuadro de diálogo, incluso antes de que se haya realizado la selección definitiva.
Véase también folder.
folder : url
Esta propiedad contiene la carpeta aceptada finalmente.
A diferencia de la propiedad « currentFolder », la propiedad « folder » no se actualiza mientras el usuario selecciona carpetas 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 una carpeta. Como alternativa, se puede gestionar la señal « accepted()» para obtener la selección definitiva.
Véase también currentFolder y accepted().
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 |
|---|---|
FolderDialog.ShowDirsOnly | Mostrar solo directorios en el cuadro de diálogo de carpetas. Por defecto, se muestran tanto carpetas como directorios. |
FolderDialog.DontResolveSymlinks | No resolver enlaces simbólicos en el cuadro de diálogo de carpetas. Por defecto, los enlaces simbólicos se resuelven. |
FolderDialog.ReadOnly | Indica que el cuadro de diálogo no permite crear directorios. |
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 ».
© 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.