Category QML Type
Category型は、Place が関連付けられるカテゴリを表す。詳細...
| Import Statement: | import QtLocation 6.11 |
| Since: | QtLocation 5.5 |
プロパティ
- categoryId : string
- icon : PlaceIcon
- name : string
- plugin : Plugin
- status : enumeration
- visibility : enumeration
方法
- string errorString()
- void remove()
- void save()
詳細説明
カテゴリーは、それらが関連付けられているカテゴリーに基づいて場所を検索するために使用される。利用可能なカテゴリのリストは、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も参照 。
プロパティのドキュメント
categoryId : string
このプロパティは、カテゴリの識別子を保持する。categoryId は、categoriesplugin 内でこのカテゴリを一意に識別する文字列です。
icon : PlaceIcon
このプロパティは、カテゴリに関連付けられた画像ソースを保持します。アイコンを表示するには、Imageタイプを使用します。
name : string
このプロパティは、文字列ベースのカテゴリー名を保持する。
plugin : Plugin
このプロパティは、カテゴリが属するロケーションベースのサービスを保持する。
status : enumeration [read-only]
このプロパティは、カテゴリの状態を保持する。以下のいずれかになります:
| Category.Ready | 最後の操作中にエラーは発生していません。 |
| Category.Saving(保存中 | カテゴリは現在保存中であり、現在の操作が完了するまで他の操作は実行できない。 |
| カテゴリー.削除 | 現在の操作が完了するまで、他の操作は実行できません。 |
| カテゴリー.エラー | 最後の操作中にエラーが発生しました。 |
visibility : enumeration
このプロパティは、カテゴリの可視性を保持します。以下のいずれかになります:
| Category.UnspecifiedVisibility | カテゴリの可視性は未指定です。カテゴリを保存する場合、プラグインは自動的にバックエンドに保存されたカテゴリにデフォルトの可視性を設定します。このデフォルトはプラグインの実装に依存します。 |
| カテゴリ.デバイスの可視性 | カテゴリは現在のデバイスに限定されます。カテゴリはデバイスから転送されません。 |
| Category.PrivateVisibility | カテゴリは現在のユーザーに非公開です。カテゴリはオンラインサービスに転送される可能性がありますが、現在のユーザーにのみ表示されます。 |
| カテゴリー.PublicVisibility | カテゴリは公開されています。 |
可視性は、カテゴリに関連付けられたPlaceが、デバイス上のアプリケーションのユーザーインターフェースにどのように表示されるかに影響しないことに注意してください。その代わりに、カテゴリの共有セマンティクスを定義します。
メソッドのドキュメント
string errorString()
最後の操作のエラー内容を文字列で返します。最後の操作が正常に完了した場合は、文字列は空です。
void remove()
このメソッドは、バックエンド・サービスからカテゴリーを永久に削除します。
void save()
このメソッドはカテゴリをバックエンド・サービスに保存します。
© 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.