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

KeyboardStyle QML Type

Bietet eine Schnittstelle zur Gestaltung der virtuellen Tastatur. Mehr...

Import Statement: import QtQuick.VirtualKeyboard.Styles
Inherits:

QtObject

Eigenschaften

Ausführliche Beschreibung

Der Stiltyp enthält die Stildefinitionen, die von der „ InputPanel “ zur Gestaltung der virtuellen Tastatur verwendet werden.

Die Designgröße legt das Seitenverhältnis der virtuellen Tastatur fest. Stile sind gemäß scaleHint skalierbar, wobei sich diese Größe aus der tatsächlichen Höhe der Tastatur und der Designhöhe berechnet.

Die Tastatur wird in einer festen Designgröße angelegt, die durch ` keyboardDesignWidth ` und ` keyboardDesignHeight` definiert ist, und anschließend an die verfügbare Breite angepasst. Die gerenderte Höhe ergibt sich aus dem Design-Seitenverhältnis: ` keyboardDesignHeight * width / keyboardDesignWidth`. ` keyboardHeight ` gibt die tatsächliche, skalierte Höhe an, die zur Laufzeit verwendet wird.

keyboardDesignMaximumHeight Diese Höhe kann optional begrenzt werden. Solange die Begrenzung nicht aktiv ist, erstreckt sich der Tastenbereich über die gesamte verfügbare Breite. Wenn die skalierte Höhe das Maximum überschreiten würde, wird das Design-Seitenverhältnis beibehalten und stattdessen die gesamte Tastatur gemäß keyboardDesignMaximumHeight / keyboardDesignHeight skaliert, sodass die Tastatur niemals höher als das Maximum wird. In diesem Fall wird der Tastenbereich schmaler als die verfügbare Breite und zentriert, sodass auf beiden Seiten leere Ränder entstehen; nur der Tastaturhintergrund erstreckt sich weiterhin über die gesamte Breite. scaleHint ist das Verhältnis von keyboardHeight zu keyboardDesignHeight und sollte verwendet werden, um alle Pixelabmessungen proportional zu halten.

Beachten Sie, dass keyboardDesignWidth und keyboardDesignHeight Autoreneinheiten sind (die integrierten Stile verwenden 2560x800 und werden niemals in dieser Größe gerendert), während keyboardDesignMaximumHeight in logischen Pixeln angegeben wird, da es direkt mit der gerenderten Höhe verglichen wird (die ebenfalls in logischen Pixeln angegeben ist).

Eigenschaftsdokumentation

alternateKeysListBackground : Component

Vorlage für den Hintergrund der Liste der alternativen Tasten.

alternateKeysListBottomMargin : real

Unterer Rand für das Fenster mit der Liste der alternativen Tasten.

alternateKeysListDelegate : Component

Vorlage für den Eintrag „Alternative Tasten“ in der Liste.

Hinweis: Der Delegat wird in einem „ ListView “ verwendet.

Für das Element stehen folgende Eigenschaften zur Verfügung:

  • text Der Text des Schlüssels
  • data: Die Daten des Schlüssels

alternateKeysListHighlight : Component

Vorlage für die Hervorhebung der Liste alternativer Schlüssel.

Hinweis: Der Delegat wird als „ ListView.highlight “ verwendet.

alternateKeysListItemHeight : real

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

alternateKeysListItemWidth : real

Breite des Listenelements „Alternative Tasten“.

alternateKeysListLeftMargin : real

Linker Rand für den Bereich mit der Liste der alternativen Tasten.

alternateKeysListRightMargin : real

Rechter Rand für das Fenster mit der Liste der alternativen Tasten.

alternateKeysListTopMargin : real

Oberer Rand des Fensters „Liste der alternativen Tasten“.

backspaceKeyPanel : Component

Vorlage für die Rücktaste.

Hinweis: Der Delegat muss auf dem Typ „ KeyPanel “ basieren.

characterPreviewDelegate : Component

Vorlage für das Popup-Fenster zur Zeichenvorschau.

Wenn der Delegat die Eigenschaft „ text “ enthält, wird diese Eigenschaft mit dem Anzeigetext aktualisiert, sobald 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 der Oberkante jeder Taste und der Unterkante des 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 legt die Textfarbe für das Eingabefeld im Vollbildmodus fest.

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. 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 den „ font “ für das Eingabefeld im Vollbildmodus.

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

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

Diese Eigenschaft legt die Ränder um das Vollbild-Eingabefeld fest.

Der Standardwert lautet „ 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 Eingabeinhalt im Vollbildmodus 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 Passwortmaskenzeichen 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 legt die ausgewählte Textfarbe für das Vollbild-Eingabefeld fest.

Die Standardfarbe ist auf „ fullScreenInputColor “ festgelegt.

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

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

Diese Eigenschaft legt die Auswahlfarbe für das Vollbild-Eingabefeld fest.

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 den Eintrag in der Funktionsliste.

Hinweis: Der Delegat wird in einer „ ListView “ verwendet.

Dem Element stehen folgende Eigenschaften zur Verfügung:

  • keyboardFunction - Tastaturfunktion des aktuellen Elements.

Diese Eigenschaft wurde in Qt 6.2 eingeführt.

functionPopupListHighlight : Component [since 6.2]

Vorlage für die Funktion „Popup-Liste hervorheben“.

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 Delegat muss auf dem Typ „ KeyPanel “ basieren.

hideKeyPanel : Component

Vorlage für den „Hide“-Schlüssel.

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 Designhöhe der Tastatur in Autoreneinheiten.

Zusammen mit „ keyboardDesignWidth “ definiert sie das Entwurfsseitenverhältnis des Tastaturlayouts. Die gerenderte Höhe beträgt „ keyboardDesignHeight * width / keyboardDesignWidth “, es sei denn, dieser Wert überschreitet „ keyboardDesignMaximumHeight “; in diesem Fall bleibt das Entwurfsseitenverhältnis erhalten und die gesamte Tastatur wird stattdessen mit „ keyboardDesignMaximumHeight / keyboardDesignHeight “ skaliert. Sie ist außerdem die Referenzhöhe, die von „ scaleHint “ verwendet wird.

keyboardDesignMaximumHeight : real [since 6.11]

Die maximale Designhöhe der Tastatur in logischen Pixeln.

Wird ein Wert größer als „ 0 “ festgelegt, wird die gerenderte Höhe begrenzt, die sich andernfalls aus der Skalierung von „ keyboardDesignHeight “ auf die verfügbare Breite ergeben würde. Übersteigt die skalierte Höhe dieses Maximum, wird die Tastatur mit „keyboardDesignMaximumHeight“ gerendert; das Seitenverhältnis des Designs bleibt erhalten und stattdessen wird die gesamte Tastatur mit „ keyboardDesignMaximumHeight / keyboardDesignHeight “ skaliert, sodass die Tastatur niemals höher als das Maximum wird. Ein Wert von 0 oder weniger (Standard) bedeutet, dass es kein Maximum gibt, sodass die Höhe keyboardDesignHeight folgt, skaliert auf die Breite.

Im Gegensatz zu „ keyboardDesignWidth “ und „ keyboardDesignHeight “ wird dieser Wert in logischen Pixeln angegeben, da er direkt mit der gerenderten Höhe verglichen wird.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

keyboardDesignWidth : real

Die Designbreite der Tastatur in Autoreneinheiten.

Zusammen mit „ keyboardDesignHeight “ definiert sie das Entwurfsseitenverhältnis des Tastaturlayouts. Der Stil wird in dieser Größe erstellt und anschließend auf die tatsächliche Breite skaliert; die gerenderte Höhe wird aus „ keyboardDesignHeight * width / keyboardDesignWidth “ abgeleitet.

keyboardHeight : real

Die aktuelle Höhe der Tastatur in logischen Pixeln.

Dies ist die tatsächliche, skalierte Höhe, in der die Tastatur dargestellt wird. Sie wird von der Tastatur-Implementierung festgelegt (gebunden an die Höhe des Containers für den Tastenbereich) und spiegelt das Layout wider, das sich aus der Anwendung von „ keyboardDesignWidth “, „ keyboardDesignHeight “ und, falls gesetzt, „ keyboardDesignMaximumHeight “ auf die verfügbare Breite ergibt. Verwenden Sie diese Eigenschaft zusammen mit „ keyboardDesignHeight “, um „ scaleHint “ zu erhalten.

keyboardRelativeBottomMargin : real

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

keyboardRelativeLeftMargin : real

Der Abstand zwischen den Tasten ganz links und dem linken Rand der Tastatur, ausgedrückt als Prozentsatz (0.0 – 1.0) der Tastaturbreite.

keyboardRelativeRightMargin : real

Der Abstand zwischen den Tasten ganz rechts und dem rechten Rand der Tastatur, ausgedrückt als Prozentsatz (0.0 – 1.0) der Tastaturbreite.

Dieser Wert ist proportional zur Breite der Tastatur.

keyboardRelativeTopMargin : real

Der Abstand zwischen den obersten Tasten und der Oberkante der Tastatur, ausgedrückt als Prozentsatz (0.0 – 1.0) der Höhe der Tastatur.

languageKeyPanel : Component

Vorlage für den Sprachschlüssel.

Hinweis: Der Delegat muss auf dem Typ „ KeyPanel “ basieren.

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

Diese Eigenschaft legt fest, welcher Übergang auf Elemente angewendet werden soll, 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 den Eintrag in der Sprachliste.

Hinweis: Der Delegat wird in einem ` ListView` verwendet.

Hinweis: Der Delegat muss auf dem Typ „ SelectionListItem “ basieren.

Für das Element stehen folgende Eigenschaften zur Verfügung:

  • 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 legt fest, welcher Übergang auf Elemente angewendet werden 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 beim Klicken auf die Sprachschaltfläche eine Popup-Liste angezeigt wird. Wenn diese Eigenschaft auf „ false “ gesetzt ist, werden durch Klicken auf die Sprachschaltfläche die verfügbaren Sprachen nacheinander durchlaufen.

Der Standardwert ist „ false “.

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

modeKeyPanel : Component

Vorlage für die Taste im generischen Modus.

Diese Vorlage bietet eine Darstellung der Taste, bei der der Status entweder „Ein“ oder „Aus“ sein kann. Diese Vorlage wird in Situationen verwendet, in denen die Beschriftung der Taste unabhängig vom Status gleich bleibt.

Der aktuelle Status ist über die Eigenschaft „ control.mode “ abrufbar.

Hinweis: Der Delegat muss auf dem Typ „ KeyPanel “ basieren.

Vorlage für das hervorgehobene Navigationselement.

Dieses Element wird im Pfeiltasten-Navigationsmodus verwendet, um den Navigationsfokus auf der Tastatur hervorzuheben.

Das Element ist in der Regel ein transparentes Rechteck mit einem kontrastreichen Rahmen.

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

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

Diese Eigenschaft legt fest, welcher Übergang auf Elemente angewendet werden soll, 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 den Eintrag in der Popup-Liste.

Hinweis: Der Delegat wird in einem ` ListView` verwendet.

Hinweis: Der Delegat muss auf dem Typ „ SelectionListItem “ basieren.

Dem Element stehen folgende Eigenschaften zur Verfügung:

  • 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 Hervorhebung in 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 legt fest, welcher Übergang 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 Skalierungshinweis im Tastaturstil. Dieser Wert ergibt sich aus der Division von „ keyboardHeight “ durch „ keyboardDesignHeight “. Alle Pixelabmessungen müssen proportional zu diesem Wert sein.

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

Dieses Element dient dazu, die Grenzen der Textauswahl anzuzeigen und den Anfang oder das Ende der Auswahl interaktiv zu verschieben. Das gleiche Element wird sowohl für den Anfang als auch für das Ende der Auswahl verwendet.

Auswahlgriffe 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 legt fest, welcher Übergang auf Elemente angewendet werden soll, die zur Auswahlliste 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 den Eintrag in der Auswahlliste.

Hinweis: Der Delegat wird in einem ` ListView` verwendet.

Hinweis: Der Delegat muss auf dem Typ ` SelectionListItem ` basieren.

Dem Element stehen folgende Eigenschaften zur Verfügung:

  • 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 legt fest, welcher Übergang auf Elemente angewendet werden soll, die aus der Auswahlliste 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 Taste im Symbolmodus.

Hinweis: Der Delegat muss auf dem Typ „ KeyPanel “ basieren.

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

Vorlage zum 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 den Trace-Eingabeschlüssel.

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.