En esta página

Category QML Type

El tipo Category representa una categoría a la que puede asociarse un Place. Más...

Import Statement: import QtLocation 6.11
Since: QtLocation 5.5

Propiedades

Métodos

Descripción detallada

Las categorías se utilizan para buscar lugares basándose en las categorías a las que están asociadas. La lista de categorías disponibles puede obtenerse en CategoryModel. PlaceSearchModel tiene una propiedad categories que se utiliza para limitar los resultados de la búsqueda a los lugares con las categorías especificadas.

Si Plugin lo admite, se pueden crear o eliminar categorías. Para crear una nueva categoría construya un nuevo objeto Category y establezca sus propiedades, luego invoque el método save().

import QtPositioning
import QtLocation

Category {
    id: category

    plugin: myPlugin
    name: "New Category"
    visibility: Category.PrivateVisibility
}
...
category.save();

Para eliminar una categoría asegúrese de que las propiedades plugin y categoryId están establecidas y llame al método remove().

Véase también CategoryModel.

Documentación de propiedades

categoryId : string

Esta propiedad contiene el identificador de la categoría. El categoryId es una cadena que identifica de forma única esta categoría dentro de las categorías plugin.

icon : PlaceIcon

Esta propiedad contiene la fuente de la imagen asociada a la categoría. Para mostrar el icono puede utilizar el tipo Imagen.

name : string

Esta propiedad contiene una cadena basada en el nombre de la categoría.

plugin : Plugin

Esta propiedad contiene el servicio de localización al que pertenece la categoría.

status : enumeration [read-only]

Esta propiedad contiene el estado de la categoría. Puede ser uno de los siguientes

Category.ReadyNo se ha producido ningún error durante la última operación, se pueden realizar más operaciones en la categoría.
Categoría.GuardandoLa categoría se está guardando actualmente, no se pueden realizar otras operaciones hasta que finalice la operación actual.
Categoría.EliminandoLa categoría se está eliminando actualmente, no se pueden realizar otras operaciones hasta que finalice la operación actual.
Categoría.ErrorSe ha producido un error durante la última operación, aún se pueden realizar otras operaciones en la categoría.

visibility : enumeration

Esta propiedad contiene la visibilidad de la categoría. Puede ser una de las siguientes:

Category.UnspecifiedVisibilityLa visibilidad de la categoría no está especificada. Si se guarda una categoría, el plugin establecerá automáticamente una visibilidad por defecto para la categoría guardada en el backend. Este valor por defecto depende de la implementación del plugin.
Categoría.DeviceVisibilityLa categoría está limitada al dispositivo actual. La categoría no se transferirá fuera del dispositivo.
Categoría.VisibilidadPrivadaLa categoría es privada para el usuario actual. La categoría puede transferirse a un servicio en línea, pero sólo es visible para el usuario actual.
Categoría.VisibilidadPúblicaLa categoría es pública.

Tenga en cuenta que la visibilidad no afecta al modo en que se muestran los Placeasociados a la categoría en la interfaz de usuario de una aplicación en el dispositivo. En su lugar, define la semántica de compartición de la categoría.

Documentación del método

string errorString()

Devuelve una cadena descriptiva del error de la última operación. Si la última operación se completó correctamente, la cadena estará vacía.

void remove()

Este método elimina permanentemente la categoría del servicio backend.

void save()

Este método guarda la categoría en el servicio backend.

© 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.