Category QML Type
Der Typ Kategorie stellt eine Kategorie dar, der ein Place zugeordnet werden kann. Mehr...
| Import Statement: | import QtLocation 6.11 |
| Since: | QtLocation 5.5 |
Eigenschaften
- categoryId : string
- icon : PlaceIcon
- name : string
- plugin : Plugin
- status : enumeration
- visibility : enumeration
Methoden
- string errorString()
- void remove()
- void save()
Detaillierte Beschreibung
Kategorien werden für die Suche nach Orten auf der Grundlage der Kategorien verwendet, denen sie zugeordnet sind. Die Liste der verfügbaren Kategorien kann über CategoryModel abgerufen werden. PlaceSearchModel verfügt über die Eigenschaft categories, die dazu dient, die Suchergebnisse auf Orte mit den angegebenen Kategorien zu beschränken.
Wenn die Plugin dies unterstützt, können Kategorien erstellt oder entfernt werden. Um eine neue Kategorie zu erstellen, konstruieren Sie ein neues Category-Objekt, legen seine Eigenschaften fest und rufen dann die Methode save() auf.
import QtPositioning import QtLocation Category { id: category plugin: myPlugin name: "New Category" visibility: Category.PrivateVisibility } ... category.save();
Um eine Kategorie zu entfernen, stellen Sie sicher, dass die Eigenschaften plugin und categoryId gesetzt sind und rufen Sie die Methode remove() auf.
Siehe auch CategoryModel.
Dokumentation der Eigenschaften
categoryId : string
Diese Eigenschaft enthält den Bezeichner der Kategorie. Die categoryId ist eine Zeichenfolge, die diese Kategorie innerhalb der Kategorien plugin eindeutig identifiziert.
icon : PlaceIcon
Diese Eigenschaft enthält die mit der Kategorie verbundene Bildquelle. Um das Symbol anzuzeigen, können Sie den Typ Bild verwenden.
name : string
Diese Eigenschaft enthält einen stringbasierten Namen für die Kategorie.
plugin : Plugin
Diese Eigenschaft enthält den standortbezogenen Dienst, zu dem die Kategorie gehört.
status : enumeration [read-only]
Diese Eigenschaft enthält den Status der Kategorie. Sie kann eine der folgenden sein:
| Kategorie.Bereit | Bei der letzten Operation ist kein Fehler aufgetreten, weitere Operationen können mit der Kategorie durchgeführt werden. |
| Kategorie.Speichern | Die Kategorie wird gerade gespeichert, es können keine weiteren Operationen durchgeführt werden, bis der aktuelle Vorgang abgeschlossen ist. |
| Kategorie.Entfernen | Die Kategorie wird gerade entfernt, es können keine weiteren Operationen durchgeführt werden, bis der aktuelle Vorgang abgeschlossen ist. |
| Kategorie.Fehler | Bei der letzten Operation ist ein Fehler aufgetreten, weitere Operationen können noch an der Kategorie durchgeführt werden. |
visibility : enumeration
Diese Eigenschaft bestimmt die Sichtbarkeit der Kategorie. Sie kann eine der folgenden sein:
| Category.UnspecifiedVisibility | Die Sichtbarkeit der Kategorie ist nicht spezifiziert. Wenn eine Kategorie gespeichert wird, setzt das Plugin automatisch eine Standardsichtbarkeit für die im Backend gespeicherte Kategorie. Diese Vorgabe ist abhängig von der Plugin-Implementierung. |
| Kategorie.GeräteSichtbarkeit | Die Kategorie ist auf das aktuelle Gerät beschränkt. Die Kategorie wird nicht aus dem Gerät übertragen. |
| Kategorie.PrivatSichtbarkeit | Die Kategorie ist für den aktuellen Benutzer privat. Die Kategorie kann an einen Online-Dienst übertragen werden, ist aber immer nur für den aktuellen Benutzer sichtbar. |
| Kategorie.PublicVisibility | Die Kategorie ist öffentlich. |
Beachten Sie, dass sich die Sichtbarkeit nicht darauf auswirkt, wie die mit der Kategorie verbundenen Placein der Benutzeroberfläche einer Anwendung auf dem Gerät angezeigt werden. Stattdessen definiert sie die Semantik der gemeinsamen Nutzung der Kategorie.
Dokumentation der Methode
string errorString()
Gibt eine Zeichenfolge zurück, die den Fehler des letzten Vorgangs beschreibt. Wurde der letzte Vorgang erfolgreich abgeschlossen, ist die Zeichenkette leer.
void remove()
Mit dieser Methode wird die Kategorie dauerhaft aus dem Backend-Service entfernt.
void save()
Diese Methode speichert die Kategorie im Backend-Service.
© 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.