Auf dieser Seite

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

Methoden

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.ReadyBei der letzten Operation ist kein Fehler aufgetreten; weitere Operationen können an der Kategorie durchgeführt werden.
Category.SavingDie Kategorie wird gerade gespeichert; es dürfen keine weiteren Vorgänge durchgeführt werden, bis der aktuelle Vorgang abgeschlossen ist.
Category.RemovingDie Kategorie wird gerade entfernt; es können keine weiteren Vorgänge durchgeführt werden, bis der aktuelle Vorgang abgeschlossen ist.
Kategorie.FehlerBei 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.UnspecifiedVisibilityDie 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.DeviceVisibilityDie Kategorie ist auf das aktuelle Gerät beschränkt. Die Kategorie wird nicht außerhalb des Geräts übertragen.
Category.PrivateVisibilityDie 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.PublicVisibilityDie 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.