Back to Qt.io
Contact Us Blog Download Qt

KeyboardStyle QML Type

Bietet eine Styling-Schnittstelle für die virtuelle Tastatur. Mehr...

Import Statement: import QtQuick.VirtualKeyboard.Styles
Inherits:

QtObject

Eigenschaften

Detaillierte Beschreibung

Der Style-Typ liefert die Style-Definitionen, die von InputPanel verwendet werden, um die virtuelle Tastatur zu dekorieren.

Die Designgröße gibt das Seitenverhältnis der virtuellen Tastatur an. Stile sind gemäß scaleHint skalierbar, das aus der tatsächlichen Höhe der Tastatur und der Entwurfshöhe berechnet wird.

Eigenschaft Dokumentation

alternateKeysListBackground : Component

Vorlage für den Hintergrund der Alternativtastenliste.


alternateKeysListBottomMargin : real

Unterer Rand für den Bereich der Liste der alternativen Tasten.


alternateKeysListDelegate : Component

Vorlage für das Element der Alternativtastenliste.

Hinweis: Der Delegat wird in einer ListView verwendet.


alternateKeysListHighlight : Component

Vorlage für die Hervorhebung der Liste alternativer Tasten.

Hinweis: Der Delegat wird als ListView.highlight verwendet.


alternateKeysListItemHeight : real

Höhe der Liste der alternativen Tasten.


alternateKeysListItemWidth : real

Breite der Liste der alternativen Tasten.


alternateKeysListLeftMargin : real

Linker Rand für die Liste der alternativen Tasten.


alternateKeysListRightMargin : real

Rechter Rand für die Liste der Alternativtasten.


alternateKeysListTopMargin : real

Oberer Rand für den Bereich der Liste der alternativen Tasten.


backspaceKeyPanel : Component

Vorlage für die Rückschritttaste.

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.


characterPreviewDelegate : Component

Vorlage für das Popup für die Zeichenvorschau.

Wenn der Delegat die Eigenschaft text enthält, wird die Eigenschaft mit dem Anzeigetext aktualisiert, wenn die Komponente aktiv wird.

property string text

Beispiel:

characterPreviewDelegate: Item {
    property string text
    id: characterPreview
    Rectangle {
        id: characterPreviewBackground
        anchors.fill: parent
        ...
        Text {
            text: characterPreview.text
            anchors.fill: parent
            ...
        }
    }
}

characterPreviewMargin : real

Anzahl der Pixel zwischen dem oberen Rand jeder Taste und dem unteren Rand der characterPreviewDelegate.


enterKeyPanel : Component

Vorlage für die Eingabetaste.

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.


fullScreenInputBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält den Delegaten für den Hintergrund der Vollbild-Eingabe.

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


fullScreenInputColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält die Textfarbe für das Vollbild-Eingabefeld.

Die Standardfarbe ist schwarz.

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


fullScreenInputContainerBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält den Delegaten für den Hintergrund des Vollbild-Eingabecontainers.

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


fullScreenInputCursor : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält den Delegaten für den Cursor im Vollbild-Eingabefeld.

Der Delegat sollte die Sichtbarkeit des Cursors entsprechend der für das Vollbild-Eingabefeld definierten Eigenschaft parent.blinkStatus umschalten. Zum Beispiel:

fullScreenInputCursor: Rectangle {
    width: 1
    color: "#000"
    visible: parent.blinkStatus
}

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


fullScreenInputFont : font [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält die font für das Vollbild-Eingabefeld.

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


fullScreenInputMargins : real [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält die Ränder um das Vollbild-Eingabefeld.

Der Standardwert ist 0.

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


fullScreenInputPadding : real [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft legt den Abstand um den Inhalt des Vollbild-Eingabefeldes fest.

Der Standardwert ist 0.

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


fullScreenInputPasswordCharacter : string [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält das Passwort-Maskenzeichen für das Vollbild-Eingabefeld.

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


fullScreenInputSelectedTextColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält die ausgewählte Textfarbe für das Vollbild-Eingabefeld.

Die Standardfarbe ist auf fullScreenInputColor eingestellt.

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


fullScreenInputSelectionColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

Diese Eigenschaft enthält die Farbe der Auswahl für das Vollbild-Eingabefeld.

Die Standardfarbe ist halbtransparentes Schwarz.

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


functionPopupListBackground : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

Vorlage für den Hintergrund der Funktions-Popup-Liste.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 6.2 eingeführt.


functionPopupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

Vorlage für das Element der Funktionsliste.

Hinweis: Der Delegat wird in einem ListView verwendet.

Die folgenden Eigenschaften sind für das Element verfügbar:

  • keyboardFunction - Tastaturfunktion des aktuellen Elements.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 6.2 eingeführt.


functionPopupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

Vorlage für die Hervorhebung der Funktion in der Popup-Liste.

Hinweis: Der Delegat wird als ListView.highlight verwendet.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 6.2 eingeführt.


handwritingKeyPanel : Component

Vorlage für die Taste für den Handschriftmodus.

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.


hideKeyPanel : Component

Vorlage für die Taste "Ausblenden".

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.


keyPanel : Component

Vorlage für die regulären Tasten.

Hinweis: Der Delegierte muss auf dem Typ KeyPanel basieren.

Beispiel:

keyPanel: KeyPanel {
    Rectangle {
        anchors.fill: parent
        ...
        Text {
            anchors.fill: parent
            text: control.displayText
            ...
        }
    }
}

keyboardBackground : Component

Vorlage für den Tastaturhintergrund.

Beispiel:

keyboardBackground: Rectangle {
    color: "black"
}

keyboardDesignHeight : real

Die Designhöhe der Tastatur.


keyboardDesignWidth : real

Die Entwurfsbreite der Tastatur.


keyboardHeight : real

Die aktuelle Höhe der Tastatur.


keyboardRelativeBottomMargin : real

Der Abstand zwischen den untersten Tasten und dem unteren Rand des Tastatur-Containers, ausgedrückt als Prozentsatz (0.0 - 1.0) der Höhe der Tastatur.


keyboardRelativeLeftMargin : real

Der Abstand zwischen den äußersten linken Tasten und dem linken Rand der Tastatur, ausgedrückt als Prozentsatz (0.0 - 1.0) der Breite der Tastatur.


keyboardRelativeRightMargin : real

Der Abstand zwischen den äußersten rechten Tasten und dem rechten Rand der Tastatur, ausgedrückt als Prozentsatz (0.0 - 1.0) der Breite der Tastatur.

Dieser Wert ist proportional zur Breite der Tastatur.


keyboardRelativeTopMargin : real

Der Abstand zwischen den obersten Tasten und dem oberen Rand der Tastatur, ausgedrückt als Prozentsatz (0.0 - 1.0) der Höhe der Tastatur.


languageKeyPanel : Component

Vorlage für die Sprachtaste.

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.


languageListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet wird, die zur Sprachlistenansicht hinzugefügt werden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


languageListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Vorlage für den Hintergrund der Sprachliste.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


languageListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Vorlage für das Element der Sprachliste.

Hinweis: Der Delegat wird in einem ListView verwendet.

Hinweis: Der Delegat muss auf dem Typ SelectionListItem basieren.

Die folgenden Eigenschaften sind für das Element verfügbar:

  • displayName Anzeigename der Sprache.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


languageListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Vorlage für die Hervorhebung der Sprachliste.

Hinweis: Der Delegat wird als ListView.highlight verwendet.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


languageListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

Diese Eigenschaft enthält den Übergang, der für Elemente gelten soll, die aus der Sprachlistenansicht entfernt werden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


languagePopupListEnabled: bool [since QtQuick.VirtualKeyboard.Styles 2.1]

Diese Eigenschaft legt fest, ob eine Popup-Liste angezeigt werden soll, wenn auf die Sprachtaste geklickt wird. Wenn diese Eigenschaft false lautet, werden beim Anklicken der Sprachtaste die verfügbaren Sprachen nacheinander angezeigt.

Der Standardwert ist false.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


modeKeyPanel : Component

Vorlage für die generische Modustaste.

Diese Vorlage stellt eine Visualisierung der Taste bereit, bei der der Status ein- oder ausgeschaltet sein kann. Diese Vorlage wird in Situationen verwendet, in denen die Tastenbeschriftung unabhängig vom Status gleich bleibt.

Der aktuelle Zustand ist in der Eigenschaft control.mode verfügbar.

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.


Vorlage für das Element zur Hervorhebung der Navigation.

Dieses Element wird im Pfeiltastennavigationsmodus verwendet, um den Navigationsfokus auf der Tastatur hervorzuheben.

Das Element ist typischerweise ein transparentes Rechteck mit einem kontrastreichen Rand.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 1.1 eingeführt.


popupListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet wird, die der Popup-Listenansicht hinzugefügt werden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


popupListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Vorlage für den Hintergrund der Popup-Liste.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


popupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Vorlage für das Popup-Listenelement.

Hinweis: Der Delegat wird in einem ListView verwendet.

Hinweis: Der Delegat muss auf dem Typ SelectionListItem basieren.

Die folgenden Eigenschaften sind für das Element verfügbar:

  • display Anzeigetext für das aktuelle Element.
  • wordCompletionLength Länge der Wortvervollständigung, gemessen ab dem Ende des Anzeigetextes.
  • dictionary Wörterbuchtyp des Wortes, siehe QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Ein Boolescher Wert, der angibt, ob das Wort aus dem Wörterbuch entfernt werden kann.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


popupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Vorlage für die Popup-Listenhervorhebung.

Hinweis: Der Delegat wird als ListView.highlight verwendet.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


popupListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet werden soll, die aus der Popup-Listenansicht entfernt werden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


scaleHint : real [read-only]

Der Hinweis auf die Skalierung des Tastaturstils. Dieser Wert wird durch Teilung von keyboardHeight durch keyboardDesignHeight ermittelt. Alle Pixelabmessungen müssen proportional zu diesem Wert sein.


selectionHandle : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Dieses Element wird verwendet, um anzuzeigen, wo die Grenzen der Textauswahl liegen, und um den Anfang oder das Ende der Auswahl interaktiv verschieben zu können. Das gleiche Element wird sowohl für die Start- als auch für die Endauswahl verwendet.

Selektionshandles werden derzeit nur für die anwendungsbasierte Integrationsmethode unterstützt.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


selectionListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet werden soll, die der Auswahllistenansicht hinzugefügt werden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 1.3 eingeführt.


selectionListBackground : Component

Vorlage für den Hintergrund der Auswahlliste.


selectionListDelegate : Component

Vorlage für das Auswahllistenelement.

Hinweis: Der Delegat wird in einem ListView verwendet.

Hinweis: Der Delegat muss auf dem Typ SelectionListItem basieren.

Die folgenden Eigenschaften sind für das Element verfügbar:

  • display Anzeigetext für das aktuelle Element.
  • wordCompletionLength Länge der Wortvervollständigung, gemessen ab dem Ende des Anzeigetextes.
  • dictionary Wörterbuchtyp des Wortes, siehe QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Ein Boolescher Wert, der angibt, ob das Wort aus dem Wörterbuch entfernt werden kann.

selectionListHeight : real

Höhe der Auswahlliste.


selectionListHighlight : Component

Vorlage für die Hervorhebung der Auswahlliste.

Hinweis: Der Delegat wird als ListView.highlight verwendet.


selectionListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet wird, die aus der Auswahllistenansicht entfernt werden.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 1.3 eingeführt.


shiftKeyPanel : Component

Vorlage für die Umschalttaste.

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.


spaceKeyPanel : Component

Vorlage für die Leertaste.

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.


symbolKeyPanel : Component

Vorlage für die Symbolmodus-Taste.

Hinweis: Der Delegierte muss auf dem Typ KeyPanel basieren.


traceCanvasDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Vorlage für das Rendern eines Trace-Objekts.

Hinweis: Der Delegat muss auf dem Typ TraceCanvas basieren.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


traceInputKeyPanelDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Vorlage für die Trace-Eingabetaste.

Hinweis: Der Delegat muss auf dem Typ TraceInputKeyPanel basieren.

Diese Eigenschaft wurde in QtQuick.VirtualKeyboard.Styles 2.1 eingeführt.


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