内容

• 特性
• 公共函数
• 信号
• 静态公共成员
• 详细描述

QVirtualKeyboardDictionaryManager Class

Dictionary management for application-defined dictionaries. 更多...

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

• 所有成员列表，包括继承成员

特性

• activeDictionaries : const QStringList
• availableDictionaries : const 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 ()

详细描述

This class allows you to manage dictionaries for virtual keyboard input methods. Dictionaries are application-defined and can be activated in the desired context.

注意： Dictionaries do not refer to the built-in dictionaries of the input method, but to the application's own dictionaries (for example, a phonebook application).

The following operations are supported by the dictionary manager:

• Create dictionaries using the createDictionary() 函数。
• Add or modify content of the dictionary instance.
• Activate dictionaries by adding them to the list of base dictionaries or extra dictionaries .

To activate dictionaries from QML, use the VirtualKeyboard attached type.

特性文档编制

[read-only] activeDictionaries : const QStringList

This property holds the list of currently active dictionaries.

This property holds the list of active dictionaries, which is a combination of unique names included in baseDictionaries and extraDictionaries .

访问函数：

QStringList

activeDictionaries () const

通知程序信号：

void	activeDictionariesChanged ()

[read-only] availableDictionaries : const QStringList

This property holds the list of all dictionaries.

This property holds the names of all existing dictionaries.

访问函数：

QStringList

availableDictionaries () const

通知程序信号：

void	availableDictionariesChanged ()

baseDictionaries : QStringList

This property holds the list of currently active base dictionaries.

This property holds the names of base dictionaries. The application manages this property.

访问函数：

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

通知程序信号：

void	baseDictionariesChanged ()

extraDictionaries : QStringList

This property holds the list of currently active extra dictionaries.

This property holds the names of extra dictionaries. The application manages this property.

访问函数：

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

通知程序信号：

void	extraDictionariesChanged ()

成员函数文档编制

QVirtualKeyboardDictionary *QVirtualKeyboardDictionaryManager:: createDictionary (const QString & name )

Create a dictionary with the given name or return the dictionary if it already exists.

The dictionary instance is owned by the dictionary manager and must not be destroyed manually. To free memory allocated for the dictionary, the application may reset the contents of the dictionary to an empty QStringList .

另请参阅 dictionary ().

QVirtualKeyboardDictionary *QVirtualKeyboardDictionaryManager:: dictionary (const QString & name ) const

Returns an existing dictionary with the given name if it exists, otherwise returns nullptr .

另请参阅 createDictionary ().

[static] QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager:: instance ()

Returns the singleton instance of the QVirtualKeyboardDictionaryManager .

All the functionalities must be called from the main thread.