FileDialog QML Type

Un diálogo de archivo. Más...

• Lista de todos los miembros, incluidos los heredados
• Miembros obsoletos

Propiedades

• acceptLabel : string
• currentFolder : url
• defaultSuffix : string
• fileMode : enumeration
• nameFilters : list<string>
• options : flags
• rejectLabel : string
• selectedFile : url
• selectedFiles : list<url>
• selectedNameFilter
  • selectedNameFilter.extensions : list<string>
  • selectedNameFilter.globs : list<string>
  • selectedNameFilter.index : int
  • selectedNameFilter.name : string

Descripción detallada

El tipo FileDialog proporciona una API QML para diálogos de archivos.

Para mostrar un diálogo de archivo, construya una instancia de FileDialog, establezca las propiedades deseadas y llame a open(). La propiedad currentFolder puede utilizarse para determinar la carpeta en la que se abre el diálogo. Las propiedades selectedFile y selectedFiles pueden utilizarse para determinar qué archivo(s) se seleccionan cuando se abre el diálogo, y también se actualizan cuando el usuario selecciona un archivo en el diálogo y cuando se acepta el diálogo.

import QtCore
import QtQuick
import QtQuick.Controls
import QtQuick.Dialogs

ApplicationWindow {
    width: 640
    height: 480
    visible: true

    header: ToolBar {
        Button {
            text: qsTr("Choose Image...")
            onClicked: fileDialog.open()
        }
    }

    Image {
        id: image
        anchors.fill: parent
        fillMode: Image.PreserveAspectFit
    }

    FileDialog {
        id: fileDialog
        currentFolder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
        onAccepted: image.source = selectedFile
    }
}

Disponibilidad

Actualmente está disponible un diálogo de archivos nativo de la plataforma 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 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.

currentFolder : url

Esta propiedad contiene la carpeta donde se seleccionan los archivos. Puede establecerse para controlar el directorio inicial que se muestra cuando se abre el diálogo.

Para seleccionar una carpeta, utilice FolderDialog en su lugar.

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.

fileMode : enumeration

Esta propiedad contiene el modo del diálogo.

Valores disponibles:

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)"]
}

Diferentes plataformas pueden restringir los archivos que pueden ser seleccionados de diferentes maneras. Por ejemplo, macOS desactivará las entradas de archivos que no coincidan con los filtros, mientras que Windows las ocultará.

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.

selectedFile : url

Esta propiedad contiene el último archivo que se seleccionó en el diálogo.

Puede establecerse para controlar el fichero que se selecciona cuando se abre el diálogo.

Si hay varios archivos seleccionados, esta propiedad se refiere al primer archivo.

El valor de esta propiedad se actualiza cada vez que el usuario selecciona un archivo en el diálogo, y cuando se acepta el diálogo. Maneje la señal accepted() para obtener la selección final.

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

selectedFiles : list<url>

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

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

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

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.