En esta página

Category QML Type

El tipo «Categoría» representa una categoría a la que se puede asociar un « Place ». Más información...

Import Statement: import QtLocation 6.12
Since: QtLocation 5.5

Propiedades

Métodos

Descripción detallada

Las categorías se utilizan para buscar lugares en función de las categorías a las que están asociados. La lista de categorías disponibles se puede consultar en CategoryModel. El objeto ` PlaceSearchModel ` dispone de una propiedad ` categories ` que se utiliza para limitar los resultados de la búsqueda a los lugares con las categorías especificadas.

Si el objeto ` Plugin ` lo admite, se pueden crear o eliminar categorías. Para crear una nueva categoría, se debe crear un nuevo objeto `Category` y establecer sus propiedades; a continuación, se invoca 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úrate de que las propiedades plugin y categoryId estén definidas y llama 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 a 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, puedes utilizar el tipo «Imagen ».

name : string

Esta propiedad contiene el nombre de la categoría en forma de cadena de caracteres.

plugin : Plugin

Esta propiedad contiene el servicio basado en la ubicación al que pertenece la categoría.

status : enumeration [read-only]

Esta propiedad indica el estado de la categoría. Puede ser una de las siguientes:

Category.ReadyNo se ha producido ningún error durante la última operación; se pueden realizar más operaciones en la categoría.
Category.SavingLa categoría se está guardando en este momento; no se pueden realizar otras operaciones hasta que finalice la operación actual.
Category.RemovingLa categoría se está eliminando; 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; no obstante, aún se pueden realizar otras operaciones en la categoría.

visibility : enumeration

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

Category.UnspecifiedVisibilityLa visibilidad de la categoría no está especificada. Al guardar una categoría, el complemento 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 complemento.
Category.DeviceVisibilityLa categoría está limitada al dispositivo actual. La categoría no se transferirá fuera del dispositivo.
Category.PrivateVisibilityLa categoría es privada para el usuario actual. La categoría puede transferirse a un servicio en línea, pero solo será visible para el usuario actual.
Category.PublicVisibilityLa categoría es pública.

Ten en cuenta que la visibilidad no afecta a la forma en que se muestran los elementos « Place» asociados a la categoría en la interfaz de usuario de una aplicación del dispositivo. En cambio, define la semántica de uso compartido de la categoría.

Documentación del método

string errorString()

Devuelve una cadena que describe el error de la última operación. Si la última operación se ha completado correctamente, la cadena estará vacía.

void remove()

Este método elimina de forma permanente la categoría del servicio de administración.

void save()

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

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