FolderListModel QML Type
FolderListModel proporciona un modelo del contenido de una carpeta del sistema de archivos. Más información...
| Import Statement: | import Qt.labs.folderlistmodel |
Propiedades
- caseSensitive : bool
- count : int
- folder : url
- nameFilters : list<string>
- parentFolder : url
- rootFolder : url
- showDirs : bool
- showDirsFirst : bool
- showDot : bool
(since 6.12) - showDotAndDotDot : bool
- showDotDot : bool
(since 6.12) - showFiles : bool
- showHidden : bool
- showOnlyReadable : bool
- sortCaseSensitive : bool
- sortField : enumeration
- sortReversed : bool
- status : enumeration
Métodos
Descripción detallada
FolderListModel permite acceder a la información sobre el contenido de una carpeta del sistema de archivos local, mostrando una lista de archivos a las vistas y otros componentes de datos.
Nota: Este tipo está disponible al importar el módulo Qt.labs.folderlistmodel. No se garantiza que los elementos del módulo Qt.labs sigan siendo compatibles en futuras versiones.
Nota: Algunas características de FolderListModel dependen de QFileSystemWatcher. Si se desactiva QFileSystemWatcher, no se supervisan los cambios en la carpeta establecida mediante setFolder, lo que hace que las señales que normalmente se emiten al producirse cambios en el directorio (como directoryUpdated o directoryChanged) no se emitan a menos que se vuelva a llamar manualmente a setFolder. Para obtener más información, consulta Opciones de configuración de Qt.
import Qt.labs.folderlistmodelLa propiedad folder especifica la carpeta a la que se va a acceder. La información sobre los archivos y directorios de la carpeta se proporciona a través de la interfaz del modelo. Los componentes acceden a los nombres y rutas mediante los siguientes roles:
fileName(string)filePath(string)fileUrl(url) (desde Qt 5.15)fileBaseName(string)fileSuffix(string)fileSize(qlonglong)fileModified(date)fileAccessed(date)fileIsDir(bool)
Además, se puede distinguir una entrada de archivo de una entrada de carpeta mediante el método isFolder().
Filtrado
Se pueden configurar diversas propiedades para filtrar el número de archivos y directorios mostrados por el modelo.
La propiedad nameFilters puede configurarse para contener una lista de filtros con comodines que se aplican a los nombres de los archivos y directorios, de modo que solo se muestren aquellos que coincidan con los filtros.
Los directorios se pueden incluir o excluir mediante la propiedad ` showDirs `; los directorios de navegación también se pueden excluir configurando la propiedad ` showDotAndDotDot ` en `false`, y los archivos ocultos se pueden incluir o excluir mediante la propiedad ` showHidden `.
A veces resulta útil limitar los archivos y directorios mostrados a aquellos a los que el usuario tiene acceso. La propiedad ` showOnlyReadable ` puede configurarse para habilitar esta función.
Ejemplo de uso
El siguiente ejemplo muestra cómo se utiliza un `FolderListModel` para proporcionar una lista de archivos QML en un ` ListView`:
import QtQuick
import Qt.labs.folderlistmodel
ListView {
width: 200; height: 400
FolderListModel {
id: folderModel
nameFilters: ["*.qml"]
}
Component {
id: fileDelegate
required property string fileName
Text { text: fileName }
}
model: folderModel
delegate: fileDelegate
}Separadores de ruta
Qt utiliza «/» como separador universal de directorios, del mismo modo que «/» se utiliza como separador de rutas en las URL. Si siempre utilizas «/» como separador de directorios, Qt traducirá tus rutas para que se ajusten al sistema operativo subyacente.
Véase también Modelos de datos QML.
Documentación de propiedades
caseSensitive : bool
Utilizar la coincidencia de patrones con distinción entre mayúsculas y minúsculas.
Por defecto, esta propiedad tiene el valor «true».
count : int [read-only]
Devuelve el número de elementos de la carpeta actual que cumplen los criterios de filtrado.
folder : url
La propiedad ` folder ` contiene una URL de la carpeta que el modelo proporciona actualmente.
El valor debe ser una URL del tipo file: o qrc:, o bien una URL relativa.
El valor por defecto es el directorio de trabajo de la aplicación en el momento en que se inicializa por primera vez la propiedad FolderListModel.
nameFilters : list<string>
La propiedad « nameFilters » contiene una lista de filtros de nombres de archivo. Los filtros pueden incluir los comodines «?» y «*».
El ejemplo siguiente filtra los archivos PNG y JPEG:
FolderListModel {
nameFilters: [ "*.png", "*.jpg" ]
}Nota: Los filtros no excluyenlos directorios .
parentFolder : url [read-only]
Devuelve la URL del elemento padre del folder actual.
rootFolder : url
Cuando se active esta propiedad, la carpeta indicada se considerará la raíz del sistema de archivos, de modo que solo se podrá navegar por las subcarpetas que contenga.
showDirs : bool
Si el valor es «true», se incluyen los directorios en el modelo; en caso contrario, solo se incluyen los archivos.
Por defecto, esta propiedad tiene el valor «true».
Ten en cuenta que las reglas de configuración de la zona de trabajo ( nameFilters ) no se aplican a los directorios.
Véase también « showDotAndDotDot ».
showDirsFirst : bool
Si el valor es «true», si se incluyen directorios en el modelo, estos siempre se mostrarán primero, seguidos de los archivos.
Por defecto, esta propiedad está establecida en «false».
showDot : bool [since 6.12]
Si el valor es «true», el directorio actual «.» se incluirá en el modelo.
Por defecto, esta propiedad tiene el valor «false».
Esta propiedad se introdujo en Qt 6.12.
Véase también showDotAndDotDot y showDotDot.
showDotAndDotDot : bool
Si el valor es «true», los directorios «.» y «..» se incluyen en el modelo; en caso contrario, se excluyen.
Por defecto, esta propiedad tiene el valor «false».
Véase también showDirs, showDot y showDotDot.
showDotDot : bool [since 6.12]
Si es «true», se incluirá en el modelo el directorio «..» (superior).
Por defecto, esta propiedad es «false».
Esta propiedad se introdujo en Qt 6.12.
Véase también showDotAndDotDot y showDot.
showFiles : bool
Si el valor es «true», se incluyen los archivos en el modelo; en caso contrario, solo se incluyen los directorios.
Por defecto, esta propiedad tiene el valor «true».
Véase también showDirs.
showHidden : bool
Si el valor es «true», los archivos y directorios ocultos se incluyen en el modelo; en caso contrario, se excluyen.
Por defecto, esta propiedad tiene el valor «false».
showOnlyReadable : bool
Si el valor es «true», solo se muestran los archivos y directorios de los que se tiene permiso de lectura; en caso contrario, se muestran todos los archivos y directorios.
Por defecto, esta propiedad es «false».
Véase también showDirs.
sortCaseSensitive : bool
Si se establece en « true », la ordenación distingue entre mayúsculas y minúsculas. Esta propiedad tiene el valor « true » por defecto.
sortField : enumeration
La propiedad « sortField » contiene el campo que se utilizará para ordenar. « sortField » puede ser uno de los siguientes:
| Constante | Descripción |
|---|---|
FolderListModel.Unsorted | no se aplica ninguna ordenación |
FolderListModel.Name | ordenar por nombre de archivo (por defecto) |
FolderListModel.Time | ordenar por fecha de modificación |
FolderListModel.Size | ordenar por tamaño de archivo |
FolderListModel.Type | ordenar por tipo de archivo/extensión |
Véase también sortReversed.
sortReversed : bool
Si se establece en «true», invierte el orden de clasificación. El valor por defecto es «false».
Véase también sortField.
status : enumeration [read-only]
Esta propiedad indica el estado de lectura de la carpeta. Puede tener uno de los siguientes valores:
| Constante | Descripción |
|---|---|
FolderListModel.Null | No se ha establecido ninguna « folder » |
FolderListModel.Ready | la carpeta se ha cargado |
FolderListModel.Loading | la carpeta se está cargando actualmente |
Utiliza este estado para proporcionar una actualización o responder al cambio de estado de alguna manera. Por ejemplo, podrías:
- Provocar un cambio de estado:
State { name: 'loaded'; when: folderModel.status == FolderListModel.Ready } - Implementar un gestor de señales «
onStatusChanged»:FolderListModel { id: folderModel onStatusChanged: if (folderModel.status == FolderListModel.Ready) console.log('Loaded') } - Vincular al valor del estado:
Text { text: folderModel.status == FolderListModel.Ready ? 'Loaded' : 'Not loaded' }
Documentación del método
var get(int index, string property)
Devuelve la carpeta « property » correspondiente a la dirección « index » indicada. Están disponibles las siguientes propiedades:
fileName(string)filePath(string)fileUrl(url) (desde Qt 5.15)fileBaseName(string)fileSuffix(string)fileSize(qlonglong)fileModified(date)fileAccessed(date)fileIsDir(bool)
int indexOf(url file)
Devuelve el índice de la URL file indicada si el modelo la contiene; en caso contrario, devuelve -1.
bool isFolder(int index)
Devuelve «true» si la entrada index es una carpeta; en caso contrario, devuelve «false».
© 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.