Category QML Type
Der Typ „Kategorie“ steht für eine Kategorie, der ein „ Place “ zugeordnet werden kann. Mehr...
| Import Statement: | import QtLocation 6.12 |
| Since: | QtLocation 5.5 |
Eigenschaften
- categoryId : string
- icon : PlaceIcon
- name : string
- plugin : Plugin
- status : enumeration
- visibility : enumeration
Methoden
- string errorString()
- void remove()
- void save()
Ausführliche Beschreibung
Kategorien dienen dazu, Orte anhand der Kategorien zu suchen, denen sie zugeordnet sind. Die Liste der verfügbaren Kategorien kann über die Schnittstelle „ CategoryModel “ abgerufen werden. Das „ PlaceSearchModel “-Objekt verfügt über die Eigenschaft „ categories “, mit der die Suchergebnisse auf Orte mit den angegebenen Kategorien beschränkt werden können.
Sofern das ` Plugin ` dies unterstützt, können Kategorien angelegt oder entfernt werden. Um eine neue Kategorie anzulegen, erstellen Sie ein neues `Category`-Objekt, legen Sie dessen Eigenschaften fest und rufen Sie anschließend 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 zu den Eigenschaften
categoryId : string
Diese Eigenschaft enthält die Kennung der Kategorie. Die „categoryId“ ist eine Zeichenkette, die diese Kategorie innerhalb des Kategorie plugin s eindeutig identifiziert.
icon : PlaceIcon
Diese Eigenschaft enthält die Bildquelle, die der Kategorie zugeordnet ist. Um das Symbol anzuzeigen, können Sie den Bildtyp verwenden.
name : string
Diese Eigenschaft enthält den Zeichenfolgen-Namen der Kategorie.
plugin : Plugin
Diese Eigenschaft enthält den standortbasierten Dienst, zu dem die Kategorie gehört.
status : enumeration [read-only]
Diese Eigenschaft enthält den Status der Kategorie. Mögliche Werte sind:
| Category.Ready | Bei der letzten Operation ist kein Fehler aufgetreten; weitere Operationen können an der Kategorie durchgeführt werden. |
| Category.Saving | Die Kategorie wird gerade gespeichert; es dürfen keine weiteren Vorgänge durchgeführt werden, bis der aktuelle Vorgang abgeschlossen ist. |
| Category.Removing | Die Kategorie wird gerade entfernt; es können keine weiteren Vorgänge durchgeführt werden, bis der aktuelle Vorgang abgeschlossen ist. |
| Kategorie.Fehler | Bei der letzten Aktion ist ein Fehler aufgetreten; weitere Aktionen können dennoch für die Kategorie durchgeführt werden. |
visibility : enumeration
Diese Eigenschaft gibt die Sichtbarkeit der Kategorie an. Mögliche Werte sind:
| Category.UnspecifiedVisibility | Die Sichtbarkeit der Kategorie ist nicht festgelegt. Beim Speichern einer Kategorie legt das Plugin automatisch eine Standardsichtbarkeit für die im Backend gespeicherte Kategorie fest. Diese Standardeinstellung hängt von der Implementierung des Plugins ab. |
| Category.DeviceVisibility | Die Kategorie ist auf das aktuelle Gerät beschränkt. Die Kategorie wird nicht außerhalb des Geräts übertragen. |
| Category.PrivateVisibility | Die Kategorie ist für den aktuellen Benutzer privat. Die Kategorie kann an einen Online-Dienst übertragen werden, ist jedoch ausschließlich für den aktuellen Benutzer sichtbar. |
| Category.PublicVisibility | Die Kategorie ist öffentlich. |
Beachten Sie, dass die Sichtbarkeit keinen Einfluss darauf hat, wie die mit der Kategorie verknüpften „ Place“ in der Benutzeroberfläche einer Anwendung auf dem Gerät angezeigt werden. Stattdessen definiert sie die Freigabesemantik der Kategorie.
Methodendokumentation
string errorString()
Gibt eine Zeichenfolge zurück, die den Fehler der letzten Operation beschreibt. Wenn die letzte Operation erfolgreich abgeschlossen wurde, ist die Zeichenfolge leer.
void remove()
Mit dieser Methode wird die Kategorie dauerhaft aus dem Backend-Dienst entfernt.
void save()
Mit dieser Methode wird die Kategorie im Backend-Dienst gespeichert.
© 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.