VirtualKeyboardSettings QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• activeLocales : list<string> (since QtQuick.VirtualKeyboard.Settings 2.0)
• arrowKeyNavigationEnabled : bool (since 6.11)
• availableLocales : list<string> (since QtQuick.VirtualKeyboard.Settings 2.0)
• closeOnReturn : bool (since 6.8)
• defaultDictionaryDisabled : bool (since 6.1)
• defaultInputMethodDisabled : bool (since 6.1)
• fullScreenMode : bool (since QtQuick.VirtualKeyboard.Settings 2.2)
• handwritingModeDisabled : bool (since 6.1)
• hwrTimeoutForAlphabetic : bool (since 6.1)
• hwrTimeoutForCjk : bool (since 6.1)
• inputMethodHints : int (since 6.1)
• keySoundVolume : real (since 6.9)
• locale : string (since QtQuick.VirtualKeyboard.Settings 2.0)
• styleName : string
• userDataPath : bool (since 6.1)
• visibleFunctionKeys : enumeration (since 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)

Signale

• userDataReset()

Detaillierte Beschreibung

Dieser Typ stellt eine VirtualKeyboardSettings-Singleton-Instanz bereit, 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.

arrowKeyNavigationEnabled : bool [since 6.11]

Verwenden Sie diese Eigenschaft, um die Pfeiltastennavigation zu aktivieren oder zu deaktivieren.

Diese Eigenschaft wurde in Qt 6.11 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 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 Voreinstellung ist false.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

defaultDictionaryDisabled : bool [since 6.1]

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

Diese Eigenschaft wurde in Qt 6.1 eingeführt.

defaultInputMethodDisabled : bool [since 6.1]

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

Diese Eigenschaft wurde in Qt 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 am oberen Rand der Tastatur.

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 6.1]

Diese Eigenschaft ermöglicht es, den Handschrifteingabemodus zu deaktivieren, wenn er ansonsten im System verfügbar ist.

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

Diese Eigenschaft wurde in Qt 6.1 eingeführt.

hwrTimeoutForAlphabetic : bool [since 6.1]

Diese Eigenschaft legt das Zeitlimit für die Handschrifterkennung für alphabetische Sprachen fest.

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

Diese Eigenschaft wurde in Qt 6.1 eingeführt.

hwrTimeoutForCjk : bool [since 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 Qt 6.1 eingeführt.

inputMethodHints : int [since 6.1]

Diese Eigenschaft ermöglicht es, persistente Eingabemethoden-Hinweise zu setzen.

Der Wert dieser Eigenschaft wird mit den Eingabemethodenhinweisen der Eingabesteuerung kombiniert. Um zum Beispiel die Textvorhersage zu deaktivieren, kann diese Eigenschaft auf Qt::ImhNoPredictiveText gesetzt werden.

Diese Eigenschaft wurde in Qt 6.1 eingeführt.

keySoundVolume : real [since 6.9]

Diese Eigenschaft enthält den Lautstärkepegel des Keysounds. Der Pegel liegt im Bereich [0,1].

Diese Eigenschaft wurde in Qt 6.9 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 Standardgebietsschema des Systems verwendet.

Unterscheidet sich das Tastaturgebietsschema vom neuen Standardgebietsschema, 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 sie den styleName auf einen anderen Wert setzt.

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

userDataPath : bool [since 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 Qt 6.1 eingeführt.

visibleFunctionKeys : enumeration [since 6.6]

Mit dieser Einstellung wird die Sichtbarkeit bestimmter Funktionstasten in der Tastaturbelegung angepasst, sodass 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 Qt 6.6 eingeführt.

wordCandidateList group

Diese Eigenschaften wurden in QtQuick.VirtualKeyboard.Settings 2.2 eingeführt.

Signal-Dokumentation

userDataReset()

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