QVirtualKeyboardSelectionListModel Class
用于选择列表的列表模型。更多
| Header： | #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 。
© 2025 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.
