Category QML Type

Category型は、Place が関連付けられるカテゴリを表す。詳細...

Import Statement: import QtLocation 6.8
Since: QtLocation 5.5

プロパティ

方法

詳細説明

カテゴリーは、それらが関連付けられているカテゴリーに基づいて場所を検索するために使用される。利用可能なカテゴリのリストは、CategoryModel から得ることができる。PlaceSearchModel は、指定されたカテゴリを持つ場所に検索結果を制限するために使用されるcategories プロパティを持つ。

Plugin がサポートしていれば、カテゴリーを作成したり削除したりすることができる。新しいカテゴリーを作成するには、新しいCategoryオブジェクトを構築してそのプロパティを設定し、save ()メソッドを呼び出します。

import QtPositioning
import QtLocation

Category {
    id: category

    plugin: myPlugin
    name: "New Category"
    visibility: Category.PrivateVisibility
}
...
category.save();

カテゴリーを削除するには、plugin およびcategoryId プロパティが設定されていることを確認し、remove() メソッドを呼び出します。

CategoryModelも参照

プロパティ Documentation

categoryId : string

このプロパティは、カテゴリの識別子を保持します。categoryId は、plugin カテゴリ内でこのカテゴリを一意に識別する文字列である。


icon : PlaceIcon

このプロパティは、カテゴリに関連付けられた画像ソースを保持します。アイコンを表示するには、Imageタイプを使用します。


name : string

このプロパティは、文字列ベースのカテゴリ名を保持します。


plugin : Plugin

このプロパティは、カテゴリが属するロケーションベースのサービスを保持します。


status : enumeration [read-only]

このプロパティは、カテゴリのステータスを保持します。次のいずれかになります:

Category.Ready最後の操作中にエラーは発生しませんでした。
カテゴリ.保存中カテゴリは現在保存中であり、現在の操作が完了するまで他の操作は実行できない。
カテゴリー.削除現在の操作が完了するまで、他の操作は実行できません。
カテゴリー.エラー最後の操作中にエラーが発生しました。

visibility : enumeration

このプロパティは、カテゴリの可視性を保持します。以下のいずれかになります:

Category.UnspecifiedVisibilityカテゴリの可視性は未指定です。カテゴリを保存する場合、プラグインは自動的にバックエンドに保存されたカテゴリにデフォルトの可視性を設定します。このデフォルトはプラグインの実装に依存します。
カテゴリ.デバイスの可視性カテゴリは現在のデバイスに限定されます。カテゴリはデバイスから転送されません。
Category.PrivateVisibilityカテゴリは現在のユーザーに非公開です。カテゴリはオンラインサービスに転送される可能性がありますが、現在のユーザーにのみ表示されます。
カテゴリー.PublicVisibilityカテゴリは公開されています。

可視性は、カテゴリに関連付けられたPlaceが、デバイス上のアプリケーションのユーザーインターフェースにどのように表示されるかに影響しないことに注意してください。その代わりに、カテゴリの共有セマンティクスを定義します。


メソッド・ドキュメント

string errorString()

最後の操作のエラーの説明を文字列で返します。最後の操作が正常に完了した場合、文字列は空です。


void remove()

このメソッドは、バックエンド・サービスからカテゴリを永続的に削除します。


void save()

このメソッドは、カテゴリをバックエンド・サービスに保存します。


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