Dictionary management for application-defined dictionaries. More...
Header: | #include <QVirtualKeyboardDictionaryManager> |
CMake: | find_package(Qt6 COMPONENTS VirtualKeyboard REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
qmake: | QT += virtualkeyboard |
Inherits: | 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) |
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.
Note: 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:
createDictionary()
function.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.
Access functions:
QStringList | activeDictionaries() const |
Notifier signal:
void | activeDictionariesChanged() |
[read-only]
availableDictionaries : const QStringList
This property holds the list of all dictionaries.
This property holds the names of all existing dictionaries.
Access functions:
QStringList | availableDictionaries() const |
Notifier signal:
void | availableDictionariesChanged() |
This property holds the list of currently active base dictionaries.
This property holds the names of base dictionaries. The application manages this property.
Access functions:
QStringList | baseDictionaries() const |
void | setBaseDictionaries(const QStringList &baseDictionaries) |
Notifier signal:
void | baseDictionariesChanged() |
This property holds the list of currently active extra dictionaries.
This property holds the names of extra dictionaries. The application manages this property.
Access functions:
QStringList | extraDictionaries() const |
void | setExtraDictionaries(const QStringList &extraDictionaries) |
Notifier signal:
void | extraDictionariesChanged() |
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.
See also dictionary().
Returns an existing dictionary with the given name if it exists, otherwise returns nullptr
.
See also createDictionary().
[static]
QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager::instance()
Returns the singleton instance of the QVirtualKeyboardDictionaryManager.
All the functionalities must be called from the main thread.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qvirtualkeyboarddictionarymanager.html