VirtualKeyboardSettings QML Type
Bietet Einstellungen für die virtuelle Tastatur. Mehr...
Import Statement: | import QtQuick.VirtualKeyboard.Settings |
Since: | QtQuick.VirtualKeyboard 1.2 |
Eigenschaften
- activeLocales : list<string>
(since QtQuick.VirtualKeyboard.Settings 2.0)
- availableLocales : list<string>
(since QtQuick.VirtualKeyboard.Settings 2.0)
- closeOnReturn : bool
(since QtQuick.VirtualKeyboard.Settings 6.8)
- defaultDictionaryDisabled : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- defaultInputMethodDisabled : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- fullScreenMode : bool
(since QtQuick.VirtualKeyboard.Settings 2.2)
- handwritingModeDisabled : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- hwrTimeoutForAlphabetic : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- hwrTimeoutForCjk : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- inputMethodHints : int
(since QtQuick.VirtualKeyboard.Settings 6.1)
- locale : string
(since QtQuick.VirtualKeyboard.Settings 2.0)
- styleName : string
- userDataPath : bool
(since QtQuick.VirtualKeyboard.Settings 6.1)
- visibleFunctionKeys : enumeration
(since QtQuick.VirtualKeyboard.Settings 6.6)
- wordCandidateList
(since QtQuick.VirtualKeyboard.Settings 2.2)
- wordCandidateList.alwaysVisible : bool
(since QtQuick.VirtualKeyboard.Settings 2.2)
- wordCandidateList.autoHideDelay : int
(since QtQuick.VirtualKeyboard.Settings 2.2)
- wordCandidateList.alwaysVisible : bool
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
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.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 ausgeblendetQtVirtualKeyboard.KeyboardFunctionKeys.Hide
Funktionstaste ausblenden ist sichtbarQtVirtualKeyboard.KeyboardFunctionKeys.Language
Sprachfunktionstaste ist sichtbarQtVirtualKeyboard.KeyboardFunctionKeys.All
Alle Funktionstasten sind sichtbar
Der Standardwert ist QtVirtualKeyboard.KeyboardFunctionKeys.All
.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Settings 6.6 eingeführt.
Name | Beschreibung |
---|---|
autoHideDelay | Diese Eigenschaft definiert die Verzögerung in Millisekunden, nach der die Wortkandidatenliste ausgeblendet wird, wenn sie leer ist. Wenn der Wert Wenn der Wert Der Standardwert ist |
alwaysVisible | Diese Eigenschaft legt fest, ob die Wortkandidatenliste immer sichtbar bleiben soll. Der Standardwert ist |
autoCommitWord | Diese 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 |
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.