Back to Qt.io
Contact Us Blog Download Qt

QVirtualKeyboardDictionaryManager Class

Wörterbuchverwaltung für anwendungsdefinierte Wörterbücher. Mehr...

Kopfzeile: #include <QVirtualKeyboardDictionaryManager>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
Vererbungen: QObject

Eigenschaften

Öffentliche Funktionen

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)

Signale

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

Statische öffentliche Mitglieder

QVirtualKeyboardDictionaryManager *instance()

Detaillierte Beschreibung

Mit dieser Klasse können Sie Wörterbücher für virtuelle Tastatureingabemethoden verwalten. Dictionaries sind anwendungsdefiniert und können im gewünschten Kontext aktiviert werden.

Hinweis: Wörterbücher beziehen sich nicht auf die eingebauten Wörterbücher der Eingabemethode, sondern auf die eigenen Wörterbücher der Anwendung (z.B. einer Telefonbuchanwendung).

Die folgenden Operationen werden vom Wörterbuchmanager unterstützt:

  • Erstellen von Wörterbüchern mit der Funktion createDictionary().
  • Hinzufügen oder Ändern des Inhalts der Wörterbuchinstanz.
  • Aktivieren von Wörterbüchern durch Hinzufügen zur Liste von base dictionaries oder extra dictionaries.

Um Wörterbücher aus QML zu aktivieren, verwenden Sie den angehängten Typ VirtualKeyboard.

Dokumentation der Eigenschaft

[read-only] activeDictionaries : const QStringList

Diese Eigenschaft enthält die Liste der derzeit aktiven Wörterbücher.

Diese Eigenschaft enthält die Liste der aktiven Wörterbücher, die eine Kombination aus eindeutigen Namen ist, die in baseDictionaries und extraDictionaries enthalten sind.

Zugriffsfunktionen:

QStringList activeDictionaries() const

Benachrichtigungssignal:

void activeDictionariesChanged()

[read-only] availableDictionaries : const QStringList

Diese Eigenschaft enthält die Liste aller Wörterbücher.

Diese Eigenschaft enthält die Namen aller vorhandenen Wörterbücher.

Zugriffsfunktionen:

QStringList availableDictionaries() const

Benachrichtigungssignal:

void availableDictionariesChanged()

baseDictionaries : QStringList

Diese Eigenschaft enthält die Liste der derzeit aktiven Basiswörterbücher.

Diese Eigenschaft enthält die Namen der Basiswörterbücher. Die Anwendung verwaltet diese Eigenschaft.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void baseDictionariesChanged()

extraDictionaries : QStringList

Diese Eigenschaft enthält die Liste der derzeit aktiven Extra-Wörterbücher.

Diese Eigenschaft enthält die Namen der zusätzlichen Wörterbücher. Die Anwendung verwaltet diese Eigenschaft.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void extraDictionariesChanged()

Member Function Dokumentation

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

Erstellt ein Wörterbuch mit dem angegebenen name oder gibt das Wörterbuch zurück, wenn es bereits existiert.

Die Wörterbuchinstanz ist Eigentum des Wörterbuchmanagers und darf nicht manuell zerstört werden. Um den für das Wörterbuch reservierten Speicher freizugeben, kann die Anwendung die contents des Wörterbuchs zurücksetzen.

Siehe auch dictionary().

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

Gibt ein vorhandenes Wörterbuch mit dem angegebenen name zurück, falls es existiert, andernfalls nullptr.

Siehe auch createDictionary().

[static] QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager::instance()

Gibt die Singleton-Instanz von QVirtualKeyboardDictionaryManager zurück.

Alle Funktionalitäten müssen vom Haupt-Thread aus aufgerufen werden.

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