SelectionListModel QML Type (Uncreatable)

選択リスト用のデータモデルを提供します。詳細...

注：これは作成不可能な型です。QMLではインスタンス化できません。

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

シグナル

• void activeItemChanged(int index)
• void itemSelected(int index)

方法

• void removeItem(int index)
• void selectItem(int index)

詳細な説明

SelectionListModel は、入力方式によって提供される単語候補のためのデータモデルです。

SelectionListModelのインスタンスを直接作成することはできません。代わりに、InputEngine がインスタンスを管理し、InputEngine::wordCandidateListModel プロパティを通じてモデルへのアクセスを提供します。

このモデルは、リストデリゲートに対して以下のデータロールを公開しています：

• display 項目の表示テキスト。
• wordCompletionLength 項目の単語補完の長さ。
• dictionaryType 単語の辞書型（QVirtualKeyboardSelectionListModel::DictionaryType を参照）。
• canRemoveSuggestion その単語を辞書から削除できるかどうかを示すブール値。

activeItemChanged シグナルは、入力メソッドによって現在どの項目がハイライトされているかを示します。ビューは、このシグナルに応答して、リスト内の対応する項目をハイライトする必要があります。

ユーザーの選択は、selectItem() メソッドによって処理されます。ユーザーがリストから項目を選択した際、ビューはこのメソッドを呼び出す必要があります。

シグナルのドキュメント

void activeItemChanged(int index)

このシグナルは、リスト内のアクティブな項目が変更されたときに発せられます。UIはこのシグナルに応答し、リスト内のindex にある項目をハイライト表示する必要があります。

void itemSelected(int index)

このシグナルは、index にあるアイテムがユーザーによって選択されたときに発火します。

メソッドのドキュメント

void removeItem(int index)

このメソッドは、ユーザーがリストのindex の位置にある項目を削除した際に呼び出される必要があります。削除処理は、さらなる処理のために入力メソッドに引き継がれます。

void selectItem(int index)

このメソッドは、ユーザーがリストのindex の位置にある項目を選択した際に呼び出されるべきです。選択された項目は、さらなる処理のため入力メソッドに渡されます。