このページでは

QVirtualKeyboardSelectionListModel Class

選択リスト用のリストモデル。詳細...

ヘッダー: #include <QVirtualKeyboardSelectionListModel>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
QML内: SelectionListModel
継承元: QAbstractListModel

パブリック型

enum class DictionaryType { Default, User }
enum class Role { Display, DisplayRole, WordCompletionLength, WordCompletionLengthRole, Dictionary, CanRemoveSuggestion }
enum class Type { WordCandidateList }

パブリック関数

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

シグナル

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

詳細な説明

このクラスは、UI と、選択リストのデータを提供する入力メソッドとの間の橋渡し役として機能します。

メンバ型のドキュメント

enum class QVirtualKeyboardSelectionListModel::DictionaryType

この列挙型は、単語の辞書型を指定します。

定数値説明
QVirtualKeyboardSelectionListModel::DictionaryType::Default0単語候補は、デフォルトの辞書から取得されます。
QVirtualKeyboardSelectionListModel::DictionaryType::User1単語候補はユーザー辞書からのものです。

enum class QVirtualKeyboardSelectionListModel::Role

この列挙型は、要求されたデータの役割を指定します。

定数値説明
QVirtualKeyboardSelectionListModel::Role::DisplayQt::DisplayRoleテキスト形式でレンダリングされるデータ。
QVirtualKeyboardSelectionListModel::Role::DisplayRoleDisplayobsolete Role::Display を使用してください。
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthQt::UserRole + 1文字列の末尾から数えた文字数として、補完部分の単語の長さを指定する整数。
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRoleWordCompletionLengthobsolete Role::WordCompletionLength を使用してください。
QVirtualKeyboardSelectionListModel::Role::Dictionary258l {QVirtualKeyboardSelectionListModel::DictionaryType}{辞書タイプ} を指定する整数。
QVirtualKeyboardSelectionListModel::Role::CanRemoveSuggestion259単語候補を辞書から削除できるかどうかを示すブール値。

enum class QVirtualKeyboardSelectionListModel::Type

この列挙型は、選択リストのタイプを指定します。

定数値説明
QVirtualKeyboardSelectionListModel::Type::WordCandidateList0候補語のリストを表示します。

メンバ関数のドキュメント

[signal] void QVirtualKeyboardSelectionListModel::activeItemChanged(int index)

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

[signal] void QVirtualKeyboardSelectionListModel::itemSelected(int index)

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

[invokable] void QVirtualKeyboardSelectionListModel::removeItem(int index)

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

注:この関数は 、メタオブジェクトシステムを介して、またはQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QVirtualKeyboardSelectionListModel::selectItem(int index)

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

注:この関数は 、メタオブジェクトシステムを介して、またはQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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