Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QVirtualKeyboardDictionaryManager Class

Gestion des dictionnaires définis par l'application. Plus d'informations...

En-tête : #include <QVirtualKeyboardDictionaryManager>
CMake : find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake : QT += virtualkeyboard
Héritages : QObject

Propriétés

Fonctions publiques

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)

Signaux

void activeDictionariesChanged()
void availableDictionariesChanged()
void baseDictionariesChanged()
void extraDictionariesChanged()

Membres publics statiques

QVirtualKeyboardDictionaryManager *instance()

Description détaillée

Cette classe permet de gérer des dictionnaires pour les méthodes de saisie au clavier virtuel. Les dictionnaires sont définis par l'application et peuvent être activés dans le contexte souhaité.

Remarque : les dictionnaires ne font pas référence aux dictionnaires intégrés de la méthode de saisie, mais aux dictionnaires propres à l'application (par exemple, une application de répertoire téléphonique).

Les opérations suivantes sont prises en charge par le gestionnaire de dictionnaires :

  • Créer des dictionnaires à l'aide de la fonction createDictionary().
  • Ajouter ou modifier le contenu de l'instance de dictionnaire.
  • Activer des dictionnaires en les ajoutant à la liste de base dictionaries ou extra dictionaries.

Pour activer des dictionnaires à partir de QML, utilisez le type attaché VirtualKeyboard.

Documentation sur les propriétés

[read-only] activeDictionaries : QStringList

Cette propriété contient la liste des dictionnaires actuellement actifs.

Cette propriété contient la liste des dictionnaires actifs, qui est une combinaison des noms uniques inclus dans baseDictionaries et extraDictionaries.

Fonctions d'accès :

QStringList activeDictionaries() const

Signal de notification :

void activeDictionariesChanged()

[read-only] availableDictionaries : QStringList

Cette propriété contient la liste de tous les dictionnaires.

Cette propriété contient les noms de tous les dictionnaires existants.

Fonctions d'accès :

QStringList availableDictionaries() const

Signal de notification :

void availableDictionariesChanged()

baseDictionaries : QStringList

Cette propriété contient la liste des dictionnaires de base actuellement actifs.

Cette propriété contient les noms des dictionnaires de base. L'application gère cette propriété.

Fonctions d'accès :

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

Signal du notificateur :

void baseDictionariesChanged()

extraDictionaries : QStringList

Cette propriété contient la liste des dictionnaires supplémentaires actuellement actifs.

Cette propriété contient les noms des dictionnaires supplémentaires. L'application gère cette propriété.

Fonctions d'accès :

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

Signal du notificateur :

void extraDictionariesChanged()

Member Function Documentation

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

Crée un dictionnaire avec l'adresse name ou renvoie le dictionnaire s'il existe déjà.

L'instance de dictionnaire appartient au gestionnaire de dictionnaire et ne doit pas être détruite manuellement. Pour libérer la mémoire allouée au dictionnaire, l'application peut réinitialiser le site contents du dictionnaire.

Voir également dictionary().

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

Renvoie un dictionnaire existant avec le nom donné name s'il existe, sinon renvoie nullptr.

Voir aussi createDictionary().

[static] QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager::instance()

Renvoie l'instance singleton de QVirtualKeyboardDictionaryManager.

Toutes les fonctionnalités doivent être appelées à partir du thread principal.

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