En esta página

FolderDialog QML Type

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

Import Statement: import QtQuick.Dialogs
Since: Qt 6.3
Inherits:

Dialog

Propiedades

Descripción detallada

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

El tipo de cuadro de diálogo «carpeta» permite que los cuadros de diálogo reproduzcan el aspecto y el comportamiento nativos de la plataforma.

Para mostrar un cuadro de diálogo de carpetas, se debe crear una instancia de FolderDialog, establecer las propiedades deseadas y llamar a ` open()`. La propiedad ` currentFolder ` se puede utilizar para determinar la carpeta que se está mostrando actualmente en el cuadro de diálogo. La propiedad ` selectedFolder ` se puede utilizar para determinar la última carpeta que se seleccionó en el cuadro de 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

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

Qt Quick Dialogs utiliza una implementación de « Qt Quick » como alternativa en aquellas plataformas que no dispongan 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 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 que se muestra actualmente en el cuadro de diálogo.

Véase también selectedFolder.

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.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.
FolderDialog.DontUseNativeDialogObliga al cuadro de diálogo a utilizar una implementación rápida no nativa.

rejectLabel : string

Esta propiedad contiene el texto de la etiqueta que se muestra en el botón que cierra 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 « Cancel ».

El valor por defecto es una cadena vacía.

Véase también « acceptLabel ».

selectedFolder : url

Esta propiedad contiene la última carpeta seleccionada en el cuadro de diálogo.

El valor de esta propiedad se actualiza cada vez que el usuario selecciona una carpeta en el cuadro de diálogo y cuando se acepta el cuadro de diálogo. Como alternativa, se puede gestionar la señal « accepted()» para obtener la selección final.

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

© 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.