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
- categoryId : string
- icon : PlaceIcon
- name : string
- plugin : Plugin
- status : enumeration
- visibility : enumeration
Métodos
- string errorString()
- void remove()
- void save()
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.Ready | No se ha producido ningún error durante la última operación; se pueden realizar más operaciones en la categoría. |
| Category.Saving | La categoría se está guardando en este momento; no se pueden realizar otras operaciones hasta que finalice la operación actual. |
| Category.Removing | La categoría se está eliminando; no se pueden realizar otras operaciones hasta que finalice la operación actual. |
| Categoría.Error | Se 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.UnspecifiedVisibility | La 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.DeviceVisibility | La categoría está limitada al dispositivo actual. La categoría no se transferirá fuera del dispositivo. |
| Category.PrivateVisibility | La 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.PublicVisibility | La 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.