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

QVirtualKeyboardDictionaryManager Class

Gestion des dictionnaires définis par l'application. En savoir plus...

En-tête : #include <QVirtualKeyboardDictionaryManager>
CMake : find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake : QT += virtualkeyboard
Hérite de : 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 vous 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).

Le gestionnaire de dictionnaires prend en charge les opérations suivantes :

  • 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 des « base dictionaries » ou « extra dictionaries ».

Pour activer des dictionnaires depuis QML, utilisez le type associé ` VirtualKeyboard `.

Documentation des 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 regroupe les noms uniques figurant 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 de notification :

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 de notification :

void extraDictionariesChanged()

Documentation des fonctions membres

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

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

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

Voir aussi dictionary().

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

Renvoie un dictionnaire existant contenant l'name, si celle-ci existe ; sinon, renvoie nullptr.

Voir aussi createDictionary().

[static] QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager::instance()

Renvoie l'instance singleton de l'QVirtualKeyboardDictionaryManager.

Toutes les fonctionnalités doivent être appelées depuis le 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.