En esta página

FolderDialog QML Type

Un cuadro de diálogo de carpetas 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 FolderDialog `.

El tipo FolderDialog proporciona una API de QML para los cuadros de diálogo de carpetas de la plataforma nativa.

Un cuadro de diálogo de carpetas nativo

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 += 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::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:

ConstanteDescripción
FolderDialog.ShowDirsOnlyMostrar solo directorios en el cuadro de diálogo de carpetas. Por defecto, se muestran tanto carpetas como directorios.
FolderDialog.DontResolveSymlinksNo resolver enlaces simbólicos en el cuadro de diálogo de carpetas. Por defecto, los enlaces simbólicos se resuelven.
FolderDialog.ReadOnlyIndica 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.