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()

Ausführliche Beschreibung

Dieser Typ stellt eine Singleton-Instanz von `VirtualKeyboardSettings` bereit, mit der die Einstellungen der virtuellen Tastatur konfiguriert werden können.

Bitte beachten Sie, dass die Einstellungen nur für die Laufzeit der aktuellen Anwendung gelten, d. h., Konfigurationsänderungen sind nicht dauerhaft.

Beispiel für die Änderung des Tastaturstils in der Anwendung:

Component.onCompleted: VirtualKeyboardSettings.styleName = "retro"

Dokumentation zu den Eigenschaften

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 Laufzeit der Anwendung einzuschränken.

Die Liste der Sprachen wird in 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 Navigation mit den Pfeiltasten 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 der Sprachen, die von der virtuellen Tastatur unterstützt werden.

Diese Liste ist schreibgeschützt und hängt von der Konfiguration der virtuellen Tastatur zum Zeitpunkt der Erstellung 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, sobald die Tasten „ Qt::Key_Enter “ oder „ Qt::Key_Return “ losgelassen werden. Der Standardwert 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 besteht darin, anstelle des Standardwörterbuchs ausschließlich ein benutzerdefiniertes Wörterbuch verwenden zu können.

Diese Eigenschaft wurde in Qt 6.1 eingeführt.

defaultInputMethodDisabled : bool [since 6.1]

Diese Eigenschaft deaktiviert die Standard-Eingabemethode. Der Zweck dieser Einstellung besteht darin, die Standard-Eingabemethode durch die einfache Eingabemethode zu überschreiben und deren 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 überträgt die virtuelle Tastatur den Inhalt des fokussierten Eingabefelds in das Vollbild-Eingabefeld, das sich oben auf der Tastatur befindet.

Um beispielsweise den Vollbildmodus zu aktivieren, wenn das Seitenverhältnis des Bildschirms 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]

Mit dieser Eigenschaft lässt sich der Handschrifteingabemodus deaktivieren, sofern er im System ansonsten verfügbar ist.

Wenn diese Eigenschaft auf „ true “ gesetzt ist, wird die Handschrift-Schaltfläche 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 bei alphabetischen Sprachen fest.

Standardmäßig beträgt das Zeitlimit 500 Millisekunden.

Diese Eigenschaft wurde in Qt 6.1 eingeführt.

hwrTimeoutForCjk : bool [since 6.1]

Diese Eigenschaft legt das Zeitlimit für die Handschrifterkennung für die Sprachen Chinesisch, Japanisch und Koreanisch fest.

Standardmäßig beträgt das Zeitlimit 500 Millisekunden.

Diese Eigenschaft wurde in Qt 6.1 eingeführt.

inputMethodHints : int [since 6.1]

Mit dieser Eigenschaft können dauerhafte Eingabemethode-Hinweise festgelegt werden.

Der Wert dieser Eigenschaft wird mit den Eingabemethodenhinweisen aus dem Eingabesteuerelement kombiniert. Um beispielsweise die Texterkennung 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 legt die Standard-Ländereinstellung für die Tastatur fest.

Wenn keine Sprachumgebung angegeben ist, wird stattdessen die Standard-Systemsprache verwendet.

Wenn sich die Tastatur-Lokalisierung von der neuen Standard-Lokalisierung unterscheidet, wird die Tastatursprache sofort an die neue Lokalisierung angepasst. Ist die Lokalisierungseinstellung falsch oder nicht in der Liste der unterstützten Lokalisierungen enthalten, wird sie ignoriert und stattdessen die Standardeinstellung verwendet.

Eine Locale wird unterstützt, wenn sie in der Liste „ 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 Wert von „styleName“ auf einen anderen Wert setzt.

Der systemweite Tastaturstil kann durch die Einstellung der Umgebungsvariable `QT_VIRTUALKEYBOARD_STYLE` beeinflusst werden.

userDataPath : bool [since 6.1]

Diese Eigenschaft legt den Pfad für die Benutzerdaten der virtuellen Tastatur und ihrer 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 lässt sich die Sichtbarkeit bestimmter Funktionstasten im Tastaturlayout anpassen, sodass sie entweder angezeigt oder ausgeblendet werden können. Wenn eine Funktionstaste nicht sichtbar ist, bleibt ihre Funktionalität über das Zahnrad-Menü weiterhin zugänglich.

Der Wert kann eine Kombination der folgenden Flags sein:

• QtVirtualKeyboard.KeyboardFunctionKeys.None Alle Funktionstasten sind ausgeblendet
• QtVirtualKeyboard.KeyboardFunctionKeys.Hide Die Funktionstaste „Ausblenden“ ist sichtbar
• QtVirtualKeyboard.KeyboardFunctionKeys.Language Die Sprach-Funktionstaste ist sichtbar
• QtVirtualKeyboard.KeyboardFunctionKeys.All Alle Funktionstasten sind sichtbar

Die Standardeinstellung lautet „ 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 Benutzerdaten zurückgesetzt werden, um der virtuellen Tastatur mitzuteilen, dass alle Dateien im Benutzerdatenverzeichnis geschlossen werden müssen.