Category QML Type

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

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• 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 は、plugin 内のカテゴリの中で、このカテゴリを一意に識別する文字列です。

icon : PlaceIcon

このプロパティには、カテゴリに関連付けられた画像ソースが格納されています。アイコンを表示するには、「Image」タイプを使用できます。

name : string

このプロパティには、カテゴリの文字列形式の名称が格納されます。

plugin : Plugin

このプロパティには、そのカテゴリが属する位置情報サービスが格納されています。

status : enumeration [read-only]

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

visibility : enumeration

このプロパティは、カテゴリの公開範囲を保持します。以下のいずれかになります：

なお、可視性は、そのカテゴリに関連付けられたPlaceが、デバイス上のアプリケーションのユーザーインターフェースにどのように表示されるかには影響しません。その代わりに、カテゴリの共有の挙動を定義します。

メソッドのドキュメント

string errorString()

直近の操作のエラーに関する説明を文字列として返します。直近の操作が正常に完了した場合は、その文字列は空になります。

void remove()

この方法では、バックエンドサービスからそのカテゴリを完全に削除します。

void save()

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