FileDialog QML Type

Un diálogo de archivo 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
• currentFile : url
• currentFiles : list<url>
• defaultSuffix : string
• file : url
• fileMode : enumeration
• files : list<url>
• folder : url
• nameFilters : list<string>
• options : flags
• rejectLabel : string
• selectedNameFilter
  • selectedNameFilter.extensions : list<string>
  • selectedNameFilter.index : int
  • selectedNameFilter.name : string

Descripción detallada

Utilice QtQuick.Dialogs FileDialog en su lugar.

El tipo FileDialog proporciona una API QML para diálogos de archivo de plataforma nativa.

Para mostrar un diálogo de archivo, construya una instancia de FileDialog, establezca las propiedades deseadas y llame a open(). Las propiedades currentFile o currentFiles pueden utilizarse para determinar el archivo o archivos seleccionados actualmente en el cuadro de diálogo. Las propiedades file y files se actualizan sólo después de que se haya realizado la selección final aceptando el diálogo.

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

FileDialog {
    id: fileDialog
    currentFile: document.source
    folder: StandardPaths.writableLocation(StandardPaths.DocumentsLocation)
}

MyDocument {
    id: document
    source: fileDialog.file
}

Disponibilidad

Actualmente hay disponible un diálogo de archivos de plataforma nativa 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::FileDialog, FolderDialog, 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 o Save dependiendo de en qué fileMode se utilice el diálogo.

El valor por defecto es una cadena vacía.

Véase también rejectLabel.

currentFile : url

Esta propiedad contiene el fichero actualmente seleccionado en el diálogo.

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

Véase también file y currentFiles.

currentFiles : list<url>

Esta propiedad contiene los archivos actualmente seleccionados en el diálogo.

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

Véase también files y currentFile.

defaultSuffix : string

Esta propiedad contiene un sufijo que se añade a los archivos seleccionados que no tienen un sufijo especificado. El sufijo se utiliza normalmente para indicar el tipo de archivo (por ejemplo, "txt" indica un archivo de texto).

Si el primer carácter es un punto ('.'), se elimina.

file : url

Esta propiedad contiene el archivo final aceptado.

A diferencia de la propiedad currentFile, la propiedad file no se actualiza mientras el usuario está seleccionando archivos 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 un archivo. Alternativamente, se puede manejar la señal accepted() para obtener la selección final.

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

fileMode : enumeration

Esta propiedad contiene el modo del diálogo.

Valores disponibles:

files : list<url>

Esta propiedad contiene los archivos finales aceptados.

A diferencia de la propiedad currentFiles, la propiedad files no se actualiza mientras el usuario está seleccionando archivos 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 los archivos. Alternativamente, se puede manejar la señal accepted() para obtener la selección final.

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

folder : url

Esta propiedad contiene la carpeta donde se seleccionan los archivos. Para seleccionar una carpeta, utilice FolderDialog en su lugar.

Véase también FolderDialog.

nameFilters : list<string>

Esta propiedad contiene los filtros que restringen los tipos de archivos que se pueden seleccionar.

FileDialog {
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

Véase también selectedNameFilter.

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.

selectedNameFilter group

Estas propiedades contienen el filtro de nombre seleccionado actualmente.

FileDialog {
    id: fileDialog
    selectedNameFilter.index: 1
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

MyDocument {
    id: document
    fileType: fileDialog.selectedNameFilter.extensions[0]
}

Véase también nameFilters.