En esta página

CategoryModel QML Type

El tipo CategoryModel proporciona un modelo de las categorías compatibles con un Plugin. Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propiedades

Señales

Métodos

Descripción detallada

El tipo CategoryModel proporciona un modelo de las categorías disponibles en el Plugin actual. El modelo admite tanto una lista plana de categorías como un árbol jerárquico que representa agrupaciones de categorías. Esto se puede controlar mediante la propiedad hierarchical.

El modelo admite los siguientes roles:

RolTipoDescripción
categoríaCategoryObjeto de categoría para el elemento actual.
categoríaParentCategoryObjeto de categoría principal del elemento actual. Si no hay categoría principal, 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 elementos secundarios.

Documentación de propiedades

hierarchical : bool

Esta propiedad se mantiene independientemente de si el modelo proporciona un árbol jerárquico de categorías o una lista plana. El valor por defecto es «true».

plugin : Plugin

Esta propiedad contiene el proveedor Plugin que utiliza este modelo.

status : enumeration [read-only]

Esta propiedad contiene el estado del modelo. Puede ser una de las siguientes:

CategoryModel.NullNo se ha ejecutado ninguna consulta de obtención de categorías. El modelo está vacío.
CategoryModel.ReadyNo se ha producido ningún error durante la última operación; se pueden realizar más operaciones en el modelo.
CategoryModel.CargandoEl modelo se está actualizando; no se pueden realizar otras operaciones hasta que se complete.
CategoryModel.ErrorSe ha producido un error durante la última operación; no obstante, se pueden seguir realizando operaciones en el modelo.

Documentación de señales

dataChanged()

Esta señal se emite cuando se han producido cambios significativos en el almacén de datos subyacente.

Las aplicaciones deben actuar ante esta señal según su propio criterio. Los datos proporcionados por el modelo podrían estar desactualizados, por lo que el modelo debería volver a actualizarse en algún momento; sin embargo, una actualización inmediata podría resultar desconcertante para los usuarios si las categorías cambian sin que ellos hayan realizado ninguna acción.

El controlador correspondiente es onDataChanged.

Nota: El controlador correspondiente es onDataChanged.

Documentación del método

string errorString()

Esta propiedad de solo lectura contiene la representació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 una 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.