Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

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.

Dokumentation der Eigenschaften

alternateKeysListBackground : Component

Vorlage für den Hintergrund der Liste der Alternativschlüssel.

alternateKeysListBottomMargin : real

Unterer Rand für die Liste der alternativen Tasten.

alternateKeysListDelegate : Component

Vorlage für das Element der Liste der alternativen Schlüssel.

Hinweis: Der Delegat wird in einer ListView verwendet.

alternateKeysListHighlight : Component

Vorlage für die Hervorhebung der Liste der Alternativschlüssel.

Hinweis: Der Delegierte wird als ListView.highlight verwendet.

alternateKeysListItemHeight : real

Höhe des Listenelements für die alternativen Tasten.

alternateKeysListItemWidth : real

Breite des Listeneintrags für die alternativen Tasten.

alternateKeysListLeftMargin : real

Linker Rand für die Liste der alternativen Tasten.

alternateKeysListRightMargin : real

Rechter Rand für die Liste der alternativen Tasten.

alternateKeysListTopMargin : real

Oberer Rand für die 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-Fenster der 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 Delegierte 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-Eingabe-Containers.

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 enthält die Auffüllung um den Vollbild-Eingabeinhalt.

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 Auswahlfarbe für das Vollbild-Eingabefeld.

Die Standardfarbe ist halbtransparentes Schwarz.

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

functionPopupListBackground : Component [since 6.2]

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

Diese Eigenschaft wurde in Qt 6.2 eingeführt.

functionPopupListDelegate : Component [since 6.2]

Vorlage für das Element der Funktionsliste.

Hinweis: Der Delegat wird in einer ListView verwendet.

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

  • keyboardFunction - Tastaturfunktion des aktuellen Elements.

Diese Eigenschaft wurde in Qt 6.2 eingeführt.

functionPopupListHighlight : Component [since 6.2]

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

Hinweis: Der Delegat wird als ListView.highlight verwendet.

Diese Eigenschaft wurde in Qt 6.2 eingeführt.

handwritingKeyPanel : Component

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

Hinweis: Der Delegierte muss auf dem Typ KeyPanel basieren.

hideKeyPanel : Component

Vorlage für den Schlüssel zum Ausblenden.

Hinweis: Der Delegat muss auf dem Typ KeyPanel basieren.

keyPanel : Component

Vorlage für die regulären Schlüssel.

Hinweis: Der Delegat 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 Konstruktionshöhe der Tastatur.

keyboardDesignMaximumHeight : real [since 6.11]

Die maximale Designhöhe der Tastatur.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

keyboardDesignWidth : real

Die Konstruktionsbreite 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 in Prozent (0.0 - 1.0) der Tastaturhöhe.

keyboardRelativeLeftMargin : real

Der Abstand zwischen den am weitesten links liegenden Tasten und dem linken Rand der Tastatur, ausgedrückt in Prozent (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 in Prozent (0.0 - 1.0) der Tastaturhöhe.

languageKeyPanel : Component

Vorlage für den Sprachenschlüssel.

Hinweis: Der Delegierte muss auf dem Typ KeyPanel basieren.

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

Diese Eigenschaft enthält den Übergang, der auf Elemente angewendet werden soll, die der 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 Sprachenliste.

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 Modus-Taste.

Diese Vorlage bietet eine Visualisierung der Taste, deren Zustand 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 normalerweise 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 vom 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 Hervorhebung der Popup-Liste.

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 für Elemente gelten 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 Tastaturskala. Dieser Wert wird durch Division von keyboardHeight durch keyboardDesignHeight ermittelt. Alle Pixelmaße müssen proportional zu diesem Wert sein.

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

Dieses Element wird verwendet, um anzuzeigen, wo sich die Grenzen der Textauswahl befinden, 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 Element der Auswahlliste.

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 vom 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 Delegierte wird als ListView.highlight verwendet.

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

Diese Eigenschaft enthält den Übergang, der für Elemente gelten soll, 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 Delegierte muss auf dem Typ KeyPanel basieren.

symbolKeyPanel : Component

Vorlage für den Symbolmodusschlüssel.

Hinweis: Der Delegat 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.

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