FolderDialog QML Type

Un diálogo de carpetas nativo. Más...

Este tipo está obsoleto desde Qt.labs.platform 6.9. Desaconsejamos su uso en código nuevo.

• Lista de todos los miembros, incluyendo los heredados

Propiedades

• acceptLabel : string
• currentFolder : url
• folder : url
• options : flags
• rejectLabel : string

Descripción detallada

Utilice QtQuick.Dialogs FolderDialog en su lugar.

El tipo FolderDialog proporciona una API QML para diálogos de carpetas nativos de la plataforma.

Para mostrar un diálogo de carpeta, construya una instancia de FolderDialog, establezca las propiedades deseadas y llame a open(). La propiedad currentFolder puede utilizarse para determinar la carpeta seleccionada actualmente en el diálogo. La propiedad folder se actualiza sólo después de que se haya realizado la selección final aceptando el 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

Un diálogo de carpetas nativo de la plataforma está disponible actualmente 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 utilizan tipos del módulo Qt Labs Platform deben enlazar con QtWidgets y utilizar QApplication en lugar de QGuiApplication.

Para enlazar con la biblioteca QtWidgets, añada lo siguiente al archivo de proyecto qmake:

QT += widgets

Crear 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();
}

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

Documentación de propiedades

acceptLabel : string

Esta propiedad contiene el texto de la etiqueta mostrada en el botón que acepta el diálogo.

Cuando se establece a una cadena vacía, se utiliza la etiqueta por defecto de la plataforma subyacente. La etiqueta por defecto suele ser Open.

El valor por defecto es una cadena vacía.

Véase también rejectLabel.

currentFolder : url

Esta propiedad contiene la carpeta actualmente seleccionada en el diálogo.

A diferencia de la propiedad folder, la propiedad currentFolder se actualiza mientras el usuario está seleccionando carpetas en el diálogo, incluso antes de que se haya realizado la selección final.

Véase también folder.

folder : url

Esta propiedad contiene la carpeta final aceptada.

A diferencia de la propiedad currentFolder, la propiedad folder no se actualiza mientras el usuario está seleccionando carpetas en el diálogo, sino sólo después de haber realizado la selección final. Es decir, cuando el usuario ha pulsado OK para aceptar una carpeta. Alternativamente, se puede manejar la señal accepted() para obtener la selección final.

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

options : flags

Esta propiedad contiene las distintas opciones que afectan al aspecto del diálogo.

Por defecto, todas las opciones están desactivadas.

Las opciones deben establecerse antes de mostrar el diálogo. Establecerlas mientras el diálogo está visible no garantiza que tenga un efecto inmediato en el diálogo (dependiendo de la opción y de la plataforma).

Opciones disponibles:

rejectLabel : string

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

Cuando se establece a una cadena vacía, se utiliza la etiqueta por defecto de la plataforma subyacente. La etiqueta por defecto suele ser Cancel.

El valor por defecto es una cadena vacía.

Véase también acceptLabel.