QVirtualKeyboardDictionaryManager Class

用于管理应用程序定义的字典。更多

头文件: #include <QVirtualKeyboardDictionaryManager>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
继承: QObject

属性

公共功能

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)

信号

静态公共成员

QVirtualKeyboardDictionaryManager *instance()

详细说明

该类允许您管理虚拟键盘输入法的字典。字典由应用程序定义,可在所需上下文中激活。

注意: 字典不是指输入法的内置字典,而是指应用程序自己的字典(例如,电话簿应用程序)。

字典管理器支持以下操作:

  • 使用createDictionary() 函数创建字典。
  • 添加或修改字典实例的内容。
  • 通过将字典添加到base dictionariesextra dictionaries 列表来激活字典。

要从 QML 激活字典,请使用VirtualKeyboard 附加类型。

属性文档

[read-only] activeDictionaries : const QStringList

该属性包含当前活动词典的列表。

该属性保存活动字典列表,它是baseDictionariesextraDictionaries 中包含的唯一名称的组合。

访问功能:

QStringList activeDictionaries() const

Notifier 信号:

void activeDictionariesChanged()

[read-only] availableDictionaries : const QStringList

该属性包含所有字典的列表。

该属性包含所有现有字典的名称。

访问功能:

QStringList availableDictionaries() const

Notifier 信号:

void availableDictionariesChanged()

baseDictionaries : QStringList

该属性包含当前激活的基础字典列表。

该属性包含基础字典的名称。该属性由应用程序管理。

访问功能:

QStringList baseDictionaries() const
void setBaseDictionaries(const QStringList &baseDictionaries)

通知信号:

void baseDictionariesChanged()

extraDictionaries : QStringList

该属性包含当前活动的额外字典列表。

该属性包含额外字典的名称。该属性由应用程序管理。

访问功能:

QStringList extraDictionaries() const
void setExtraDictionaries(const QStringList &extraDictionaries)

Notifier 信号:

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 的单例。

所有功能都必须在主线程中调用。

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