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
- 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 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.Ready | No se ha producido ningún error durante la última operación, se pueden realizar más operaciones en la categoría. |
| Categoría.Guardando | La categoría se está guardando actualmente, no se pueden realizar otras operaciones hasta que finalice la operación actual. |
| Categoría.Eliminando | La categoría se está eliminando actualmente, 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, 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.UnspecifiedVisibility | La 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.DeviceVisibility | La categoría está limitada al dispositivo actual. La categoría no se transferirá fuera del dispositivo. |
| Categoría.VisibilidadPrivada | La 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ública | La 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.