Category QML Type

Der Typ Kategorie stellt eine Kategorie dar, der ein Place zugeordnet werden kann. Mehr...

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.5

Liste aller Mitglieder, einschließlich geerbter Mitglieder

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.

Eigenschaft Dokumentation

categoryId : string

Diese Eigenschaft enthält den Bezeichner der Kategorie. Die categoryId ist eine Zeichenkette, die diese Kategorie innerhalb der Kategorien plugin eindeutig identifiziert.

icon : PlaceIcon

Diese Eigenschaft enthält die Bildquelle, die mit der Kategorie verbunden ist. Um das Symbol anzuzeigen, können Sie den Typ Image verwenden.

name : string

Diese Eigenschaft enthält den stringbasierten Namen der Kategorie.

plugin : Plugin

Diese Eigenschaft enthält den ortsbezogenen Dienst, zu dem die Kategorie gehört.

status : enumeration [read-only]

Diese Eigenschaft enthält den Status der Kategorie. Er kann einer der folgenden sein:

Kategorie.Bereit	Während 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 enthält 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.

Methode Dokumentation

string errorString()

Gibt eine Zeichenfolge zurück, die den Fehler der letzten Operation beschreibt. Wenn die letzte Operation erfolgreich abgeschlossen wurde, ist die Zeichenkette leer.

void remove()

Diese Methode entfernt die Kategorie dauerhaft aus dem Backend-Service.

void save()

Diese Methode speichert die Kategorie im Backend-Service.

© 2025 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.