CategoryModel QML Type
El tipo CategoryModel proporciona un modelo de las categorías soportadas por un Plugin. Más...
| Import Statement: | import QtLocation 6.11 |
| Since: | QtLocation 5.5 |
Propiedades
- hierarchical : bool
- plugin : Plugin
- status : enumeration
Señales
Métodos
- string errorString()
Descripción detallada
El tipo CategoryModel proporciona un modelo de las categorías disponibles en la página Plugin actual. El modelo admite tanto una lista plana de categorías como un árbol jerárquico que representa agrupaciones de categorías. Esto puede controlarse mediante la propiedad hierarchical.
El modelo admite los siguientes roles:
| Rol | Tipo | Descripción |
|---|---|---|
| categoría | Category | Objeto de categoría para el elemento actual. |
| parentCategory | Category | Objeto de categoría padre para el elemento actual. Si no hay categoría padre, se devuelve null. |
El siguiente ejemplo muestra una lista plana de todas las categorías disponibles:
import QtQuick import QtPositioning import QtLocation ListView { model: CategoryModel { plugin: myPlugin hierarchical: false } delegate: Text { text: category.name } }
Para acceder al modelo jerárquico de categorías es necesario utilizar un DelegateModel para acceder a los ítems hijos.
Documentación de propiedades
hierarchical : bool
Esta propiedad indica si el modelo proporciona un árbol jerárquico de categorías o una lista plana. Por defecto es true.
plugin : Plugin
Esta propiedad contiene el proveedor Plugin utilizado por este modelo.
status : enumeration [read-only]
Esta propiedad contiene el estado del modelo. Puede ser
| CategoryModel.nulo | No se ha ejecutado ninguna consulta de búsqueda de categorías. El modelo está vacío. |
| CategoryModelListo | No se ha producido ningún error durante la última operación, se pueden realizar más operaciones en el modelo. |
| CategoryModelCargando | El modelo se está actualizando, no se pueden realizar más operaciones hasta que finalice. |
| CategoryModelError | Se ha producido un error durante la última operación, todavía se pueden realizar más operaciones en el modelo. |
Documentación de señales
dataChanged()
Esta señal se emite cuando se han realizado cambios significativos en el almacén de datos subyacente.
Las aplicaciones deben actuar sobre esta señal a su propia discreción. Los datos proporcionados por el modelo podrían no estar actualizados, por lo que el modelo debería volver a actualizarse en algún momento; sin embargo, una nueva actualización inmediata podría desconcertar a los usuarios si las categorías cambian sin que ellos realicen ninguna acción.
El manejador correspondiente es onDataChanged.
Nota: El manejador correspondiente es onDataChanged.
Documentación del método
string errorString()
Esta propiedad de sólo lectura contiene la presentación textual del último error del modelo de categoría. Si no se ha producido ningún error, se devuelve una cadena vacía.
También puede devolverse una cadena vacía si se ha producido un error que no tiene representación textual asociada.
© 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.