FolderDialog QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Descripción detallada

El tipo FolderDialog proporciona una API QML para los diálogos de carpeta de la plataforma nativa.

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 que se está mostrando actualmente en el diálogo. La propiedad selectedFolder puede utilizarse para determinar la última carpeta que se seleccionó en el diálogo.

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

FolderDialog {
    id: folderDialog
    currentFolder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
    selectedFolder: viewer.folder
}

MyViewer {
    id: viewer
    folder: folderDialog.selectedFolder
}

Disponibilidad

Un diálogo de carpetas nativo de la plataforma está actualmente disponible en las siguientes plataformas:

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

Qt Quick Dialogs utiliza una implementación de Qt Quick como alternativa en plataformas que no disponen de una implementación nativa.

Véase también 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 que se está mostrando actualmente en el diálogo.

Véase también selectedFolder.

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.

selectedFolder : url

Esta propiedad contiene la última carpeta que se seleccionó en el diálogo.

El valor de esta propiedad se actualiza cada vez que el usuario selecciona una carpeta en el diálogo, y cuando el diálogo es aceptado. Alternativamente, se puede manejar la señal accepted() para obtener la selección final.

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