QVirtualKeyboardDictionaryManager Class
应用程序定义词典的词典管理。更多...
| 标题： | #include <QVirtualKeyboardDictionaryManager> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake： | QT += virtualkeyboard |
| 继承自： | QObject |
属性
- activeDictionaries : QStringList
- availableDictionaries : QStringList
- baseDictionaries : QStringList
- extraDictionaries : QStringList
公共函数
| QStringList | activeDictionaries() const |
| QStringList | availableDictionaries() const |
| QStringList | baseDictionaries() const |
| QVirtualKeyboardDictionary * | createDictionary(const QString &name) |
| QVirtualKeyboardDictionary * | dictionary(const QString &name) const |
| QStringList | extraDictionaries() const |
| void | setBaseDictionaries(const QStringList &baseDictionaries) |
| void | setExtraDictionaries(const QStringList &extraDictionaries) |
信号
| void | activeDictionariesChanged() |
| void | availableDictionariesChanged() |
| void | baseDictionariesChanged() |
| void | extraDictionariesChanged() |
静态公共成员
| QVirtualKeyboardDictionaryManager * | instance() |
详细说明
此类允许您管理虚拟键盘输入法的词典。词典由应用程序定义，并可在所需的情境中激活。
注意：词典 并非指输入法自带的内置词典，而是指应用程序自身的词典（例如，通讯录应用程序）。
词典管理器支持以下操作：
- 使用
createDictionary()函数创建词典。 - 添加或修改词典实例的内容。
- 通过将词典添加到base dictionaries 或extra dictionaries 的列表中来激活词典。
若要在 QML 中激活词典，请使用VirtualKeyboard 关联类型。
属性文档
[read-only] activeDictionaries : QStringList
该属性保存了当前处于活动状态的词典列表。
该属性保存了活动词典的列表，该列表由baseDictionaries 和extraDictionaries 中包含的唯一名称组合而成。
访问函数：
| QStringList | activeDictionaries() const |
通知信号：
| void | activeDictionariesChanged() |
[read-only] availableDictionaries : QStringList
该属性包含所有字典的列表。
该属性包含所有现有字典的名称。
访问函数：
| QStringList | availableDictionaries() const |
通知信号：
| void | availableDictionariesChanged() |
baseDictionaries : QStringList
该属性保存了当前处于活动状态的基词典列表。
该属性存储基础词典的名称。该属性由应用程序进行管理。
访问函数：
| QStringList | baseDictionaries() const |
| void | setBaseDictionaries(const QStringList &baseDictionaries) |
通知信号：
| void | baseDictionariesChanged() |
extraDictionaries : QStringList
该属性保存了当前处于活动状态的额外词典列表。
该属性存储额外词典的名称。该属性由应用程序进行管理。
访问函数：
| QStringList | extraDictionaries() const |
| void | setExtraDictionaries(const QStringList &extraDictionaries) |
通知信号：
| void | extraDictionariesChanged() |
成员函数文档
QVirtualKeyboardDictionary *QVirtualKeyboardDictionaryManager::createDictionary(const QString &name)
使用给定的name 创建一个词典，如果该词典已存在，则返回该词典。
该字典实例由字典管理器拥有，不得手动销毁。若要释放为字典分配的内存，应用程序可重置该字典的contents 。
另请参阅 dictionary()。
QVirtualKeyboardDictionary *QVirtualKeyboardDictionaryManager::dictionary(const QString &name) const
如果存在指定name ，则返回该现有字典；否则返回nullptr 。
另请参阅 createDictionary()。
[static] QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager::instance()
返回QVirtualKeyboardDictionaryManager 的单例实例。
所有功能都必须在主线程中调用。
© 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.
