En esta página

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

Señales

Métodos

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:

RolTipoDescripción
categoríaCategoryObjeto de categoría para el elemento actual.
parentCategoryCategoryObjeto 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.nuloNo se ha ejecutado ninguna consulta de búsqueda de categorías. El modelo está vacío.
CategoryModelListoNo se ha producido ningún error durante la última operación, se pueden realizar más operaciones en el modelo.
CategoryModelCargandoEl modelo se está actualizando, no se pueden realizar más operaciones hasta que finalice.
CategoryModelErrorSe 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.