Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

QVirtualKeyboardDictionaryManager Class

Verwaltung von anwendungsdefinierten Wörterbüchern. Mehr...

Kopfzeile: #include <QVirtualKeyboardDictionaryManager>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
Erbt: 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()

Ausführliche Beschreibung

Mit dieser Klasse können Sie Wörterbücher für virtuelle Tastatureingabemethoden verwalten. Wörterbücher werden von der Anwendung definiert und können im gewünschten Kontext aktiviert werden.

Hinweis: Mit„Wörterbüchern“ sind nicht die integrierten Wörterbücher der Eingabemethode gemeint, sondern die anwendungsspezifischen Wörterbücher (z. B. einer Telefonbuch-Anwendung).

Der Wörterbuch-Manager unterstützt die folgenden Operationen:

  • Erstellen von Wörterbüchern mit der Funktion „ createDictionary() “.
  • Hinzufügen oder Ändern des Inhalts der Wörterbuchinstanz.
  • Wörterbücher aktivieren, indem man sie zur Liste von „ base dictionaries “ oder „ extra dictionaries “ hinzufügt.

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

Dokumentation zu den Eigenschaften

[read-only] activeDictionaries : 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 sich aus den eindeutigen Namen zusammensetzt, die in baseDictionaries und extraDictionaries aufgeführt sind.

Zugriffsfunktionen:

QStringList activeDictionaries() const

Benachrichtigungssignal:

void activeDictionariesChanged()

[read-only] availableDictionaries : 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 zusätzlichen Wörterbücher.

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

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void extraDictionariesChanged()

Dokumentation der Member-Funktionen

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

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

Die Wörterbuchinstanz gehört dem Wörterbuchmanager und darf nicht manuell zerstört werden. Um den für das Wörterbuch zugewiesenen Speicher freizugeben, kann die Anwendung das „ 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, sofern es existiert; andernfalls wird „ nullptr “ zurückgegeben.

Siehe auch createDictionary().

[static] QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager::instance()

Gibt die Singleton-Instanz von „ QVirtualKeyboardDictionaryManager “ zurück.

Alle Funktionen müssen vom Hauptthread aus aufgerufen werden.

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