PlaceSearchSuggestionModel QML Type

このプロパティは、返されるアイテムの数の上限を保持します。

offsetも参照 。

このプロパティは、モデル内の最初の項目のインデックスを保持します。

limit も参照して ください。

このプロパティは、検索に使用されるプロバイダPlugin を保持します。

このプロパティは、検索領域を保持します。モデルによって返される検索候補の結果は、指定された検索領域に関連したものになります。

このプロパティがgeocircle に設定されている場合、そのradius プロパティは未設定のままでもよく、その場合Plugin が検索に適切な半径を選択する。

このプロパティは、クエリで使用される部分検索語を保持する。

このプロパティはモデルの状態を保持する。以下のいずれかになります：

このプロパティは、モデルが現在保持している予測検索語のリストを保持します。

実行中の検索候補の操作を直ちにキャンセルし、モデルのステータスをPlaceSearchSuggestionModel.Ready に設定します。モデルは操作が開始される前に持っていた検索候補を保持します。

操作が進行中でない場合、cancel() を呼び出しても何の効果もありません。

update() およびstatusも参照してください 。

この読み取り専用プロパティは、最新の検索候補モデル・エラーのテキスト表示を保持します。エラーが発生していない場合、またはモデルがクリアされた場合は、空の文字列が返されます。

関連するテキスト表現がないエラーが発生した場合は、空の文字列が返されることもあります。

モデルをリセットします。すべての検索候補はクリアされ、未解決のリクエストはすべて中止され、起こりうるエラーはクリアされます。モデルのステータスはPlaceSearchSuggestionModel.Null に設定されます。

指定されたクエリパラメータに基づいてモデルを更新します。モデルには、部分的なsearchTerm とsearchArea の検索候補のリストが入力されます。plugin がサポートしている場合、limit やoffset などの他のパラメータを指定することができます。update() は、パラメータセットをplugin に送信して処理させます。

モデルの更新中、モデルのstatus はPlaceSearchSuggestionModel.Loading にセットされる。モデルの更新が成功した場合、status はPlaceSearchSuggestionModel.Ready にセットされ、更新が失敗した場合、status はPlaceSearchSuggestionModel.Error にセットされ、モデルはクリアされる。

この例は、モデルの使用方法を示している。

PlaceSeachSuggestionModel {
    id: model
    plugin: backendPlugin
    searchArea: QtPositioning.circle(QtPositioning.coordinate(10, 10))
    ...
}

MouseArea {
    ...
    onClicked: {
        model.searchTerm = "piz"
        model.searchArea.center.latitude = -27.5;
        model.searchArea.cetner.longitude = 153;
        model.update();
    }
}

より詳細な例はinPlaces (QML)の例にあります。

cancel() とstatusも参照してください 。