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) |
成员类型文档
enum class QVirtualKeyboardSelectionListModel::DictionaryType
此枚举用于指定单词的词典类型。
| 常量 | 值 | 描述 |
|---|---|---|
QVirtualKeyboardSelectionListModel::DictionaryType::Default | 0 | 该词候选项来自默认词典。 |
QVirtualKeyboardSelectionListModel::DictionaryType::User | 1 | 该候选词来自用户词典。 |
enum class QVirtualKeyboardSelectionListModel::Role
此枚举指定了所请求数据的角色。
| 常量 | 值 | 描述 |
|---|---|---|
QVirtualKeyboardSelectionListModel::Role::Display | Qt::DisplayRole | 以文本形式呈现的数据。 |
QVirtualKeyboardSelectionListModel::Role::DisplayRole | Display | obsolete 使用 Role::Display。 |
QVirtualKeyboardSelectionListModel::Role::WordCompletionLength | Qt::UserRole + 1 | 一个整数，指定补全部分中单词的长度，以从字符串末尾开始计数的字符数表示。 |
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRole | WordCompletionLength | obsolete 使用 Role::WordCompletionLength。 |
QVirtualKeyboardSelectionListModel::Role::Dictionary | 258 | 一个整数，指定 l {QVirtualKeyboardSelectionListModel::DictionaryType}{词典类型}。 |
QVirtualKeyboardSelectionListModel::Role::CanRemoveSuggestion | 259 | 一个布尔值，用于指示是否可以从词典中删除该单词候选项。 |
enum class QVirtualKeyboardSelectionListModel::Type
此枚举指定了选择列表的类型。
| 常量 | 值 | 描述 |
|---|---|---|
QVirtualKeyboardSelectionListModel::Type::WordCandidateList | 0 | 显示单词候选项列表。 |
成员函数文档
[signal] void QVirtualKeyboardSelectionListModel::activeItemChanged(int index)
当列表中的当前选中项发生变化时，会发出此信号。用户界面应响应此信号，将列表中位于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.
