VirtualKeyboardSettings QML Type

Bietet Einstellungen für die virtuelle Tastatur. Mehr...

Import Statement: import QtQuick.VirtualKeyboard.Settings
Since: QtQuick.VirtualKeyboard 1.2

Eigenschaften

Signale

Detaillierte Beschreibung

Dieser Typ stellt eine VirtualKeyboardSettings-Singleton-Instanz zur Verfügung, die zur Konfiguration der virtuellen Tastatur verwendet werden kann.

Bitte beachten Sie, dass die Einstellungen nur während der Lebensdauer der aktuellen Anwendung wirksam sind, d.h. Konfigurationsänderungen sind nicht dauerhaft.

Zum Beispiel, um den Tastaturstil in der Anwendung zu ändern:

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

Eigenschaft Dokumentation

activeLocales : list<string> [since QtQuick.VirtualKeyboard.Settings 2.0]

Diese Eigenschaft enthält eine Liste der aktivierten Sprachen der virtuellen Tastatur.

Die Liste der aktiven Sprachen ist eine Teilmenge der verfügbaren Sprachen und kann verwendet werden, um die Liste der verfügbaren Sprachen während der Lebensdauer der Anwendung einzuschränken.

Die Liste der Sprachen wird basierend auf der angegebenen Reihenfolge angezeigt.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 2.0 eingeführt.


availableLocales : list<string> [read-only, since QtQuick.VirtualKeyboard.Settings 2.0]

Diese Eigenschaft enthält eine Liste von Sprachen, die von der virtuellen Tastatur unterstützt werden.

Diese Liste ist schreibgeschützt und hängt von der Konfiguration der virtuellen Tastatur zur Build-Zeit ab.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 2.0 eingeführt.


closeOnReturn : bool [since QtQuick.VirtualKeyboard.Settings 6.8]

Diese Eigenschaft ermöglicht das Ausblenden der virtuellen Tastatur.

Wenn diese Eigenschaft auf true gesetzt ist, wird die virtuelle Tastatur ausgeblendet, wenn die Tasten Qt::Key_Enter oder Qt::Key_Return losgelassen werden. Die Standardeinstellung ist false.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.8 eingeführt.


defaultDictionaryDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

Diese Eigenschaft deaktiviert das Standard-Wörterbuch. Der Zweck dieser Einstellung ist es, nur ein benutzerdefiniertes Wörterbuch anstelle des Standardwörterbuchs zu verwenden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.1 eingeführt.


defaultInputMethodDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

Diese Eigenschaft deaktiviert die Standard-Eingabemethode. Der Zweck dieser Einstellung ist es, die Standard-Eingabemethode mit der einfachen Eingabemethode zu überschreiben und deren Funktionalität zu deaktivieren.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.1 eingeführt.


fullScreenMode : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

Diese Eigenschaft aktiviert den Vollbildmodus für die virtuelle Tastatur.

Im Vollbildmodus repliziert die virtuelle Tastatur den Inhalt des fokussierten Eingabefeldes in das Vollbild-Eingabefeld, das sich am oberen Rand der Tastatur befindet.

Zum Beispiel, um den Vollbildmodus zu aktivieren, wenn das Bildseitenverhältnis größer als 16:9 ist:

Binding {
    target: VirtualKeyboardSettings
    property: "fullScreenMode"
    value: (Screen.width / Screen.height) > (16.0 / 9.0)
}

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 2.2 eingeführt.


handwritingModeDisabled : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

Diese Eigenschaft erlaubt es, den Handschrifteingabemodus zu deaktivieren, wenn er sonst im System verfügbar ist.

Wenn diese Eigenschaft auf true gesetzt ist, wird die Schaltfläche für die Handschrifteingabe aus dem Tastaturlayout ausgeblendet und der Benutzer kann nicht in den Handschrifteingabemodus wechseln.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.1 eingeführt.


hwrTimeoutForAlphabetic : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

Diese Eigenschaft legt den Timeout für die Handschrifterkennung für alphabetische Sprachen fest.

Standardmäßig beträgt die Zeitüberschreitung 500 Millisekunden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.1 eingeführt.


hwrTimeoutForCjk : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

Diese Eigenschaft legt die Zeitüberschreitung für die Handschrifterkennung für die Sprachen Chinesisch/Japanisch/Koreanisch fest.

Standardmäßig beträgt die Zeitüberschreitung 500 Millisekunden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.1 eingeführt.


inputMethodHints : int [since QtQuick.VirtualKeyboard.Settings 6.1]

Diese Eigenschaft erlaubt es, persistente Eingabemethoden-Hinweise zu setzen.

Der Wert dieser Eigenschaft wird mit den Eingabemethoden-Hinweisen des Eingabe-Controls kombiniert. Um zum Beispiel die Textvorhersage zu deaktivieren, kann diese Eigenschaft auf Qt::ImhNoPredictiveText gesetzt werden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.1 eingeführt.


locale : string [since QtQuick.VirtualKeyboard.Settings 2.0]

Diese Eigenschaft gibt das Standardgebietsschema für die Tastatur an.

Wenn das Gebietsschema nicht angegeben wird, wird stattdessen das Standard-Systemgebietsschema verwendet.

Wenn sich das Tastaturgebietsschema von dem neuen Standardgebietsschema unterscheidet, wird die Tastatursprache sofort geändert, um das neue Gebietsschema wiederzugeben. Ist die Locale-Einstellung nicht korrekt oder steht sie nicht in der Liste der unterstützten Locales, wird sie ignoriert und stattdessen die Standardeinstellung verwendet.

Ein Gebietsschema wird unterstützt, wenn es in der Liste von availableLocales enthalten ist.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 2.0 eingeführt.


styleName : string

Diese Eigenschaft gibt den aktuellen Stil an. Die Anwendung kann den Tastaturstil ändern, indem der styleName auf einen anderen Wert gesetzt wird.

Der systemweite Tastaturstil kann durch Setzen der Umgebungsvariablen QT_VIRTUALKEYBOARD_STYLE beeinflusst werden.


userDataPath : bool [since QtQuick.VirtualKeyboard.Settings 6.1]

Diese Eigenschaft legt den Benutzerdatenpfad für die virtuelle Tastatur und ihre Plugins fest.

Standardmäßig ist der Benutzerdatenpfad auf GenericConfigLocation + "/qtvirtualkeyboard" gesetzt.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.1 eingeführt.


visibleFunctionKeys : enumeration [since QtQuick.VirtualKeyboard.Settings 6.6]

Mit dieser Einstellung wird die Sichtbarkeit bestimmter Funktionstasten im Tastaturlayout angepasst, so dass sie entweder angezeigt oder ausgeblendet werden können. Wenn eine Funktionstaste nicht sichtbar ist, bleibt ihre Funktionalität über das Zahnradmenü zugänglich.

Der Wert kann eine Kombination der folgenden Flags sein:

  • QtVirtualKeyboard.KeyboardFunctionKeys.None Alle Funktionstasten sind ausgeblendet
  • QtVirtualKeyboard.KeyboardFunctionKeys.Hide Funktionstaste ausblenden ist sichtbar
  • QtVirtualKeyboard.KeyboardFunctionKeys.Language Sprachfunktionstaste ist sichtbar
  • QtVirtualKeyboard.KeyboardFunctionKeys.All Alle Funktionstasten sind sichtbar

Der Standardwert ist QtVirtualKeyboard.KeyboardFunctionKeys.All.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.6 eingeführt.


wordCandidateList group

wordCandidateList.alwaysVisible : bool [since QtQuick.VirtualKeyboard.Settings 2.2]

wordCandidateList.autoHideDelay : int [since QtQuick.VirtualKeyboard.Settings 2.2]

NameBeschreibung
autoHideDelayDiese Eigenschaft definiert die Verzögerung in Millisekunden, nach der die Wortkandidatenliste ausgeblendet wird, wenn sie leer ist.

Wenn der Wert 0 ist, wird die Liste sofort ausgeblendet, wenn sie geleert wird.

Wenn der Wert -1 ist, ist die Liste sichtbar, bis der Eingabefokus geändert oder das Eingabefeld ausgeblendet wird.

Der Standardwert ist 5000 milliseconds.

alwaysVisibleDiese Eigenschaft legt fest, ob die Wortkandidatenliste immer sichtbar bleiben soll.

Der Standardwert ist false.

autoCommitWordDiese Eigenschaft aktiviert die automatische Festschreibefunktion, die aktiviert wird, wenn die Wortkandidatenliste auf einen einzigen Kandidaten eingeschränkt wird.

Die automatische Festschreibungsfunktion tritt in Kraft, wenn die Wortkandidatenliste zunächst mehrere Wörter enthält und nach weiteren Eingaben auf ein einziges Wort reduziert wird. Dieses Wort wird automatisch ausgewählt und bestätigt, ohne dass der Benutzer eingreifen muss.

Diese Eigenschaft ist standardmäßig auf false eingestellt.

Diese QML-Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 2.2 eingeführt.


Signal-Dokumentation

userDataReset()

Die Anwendung löst dieses Signal aus, bevor die Benutzerdaten zurückgesetzt werden, um der virtuellen Tastatur mitzuteilen, dass alle Dateien im Benutzerdatenverzeichnis geschlossen werden müssen.

Hinweis: Der entsprechende Handler ist onUserDataReset.


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