BaseKey QML Type
Gemeinsames Elternteil für alle Schlüsseltypen. Mehr...
| Import Statement: | import QtQuick.VirtualKeyboard.Components |
| Inherits: | |
| Inherited By: | BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, HideKeyboardKey, Key, and ShiftKey |
Eigenschaften
- active : bool
- alternativeKeys : var
- displayAlternativeKeys : var
(since QtQuick.VirtualKeyboard 6.2) - displayText : string
- effectiveAlternativeKeys : var
(since QtQuick.VirtualKeyboard 2.0) - effectiveAlternativeKeysHighlightIndex : int
(since QtQuick.VirtualKeyboard 2.0) - functionKey : bool
- highlighted : bool
- key : int
- keyPanelDelegate : alias
- keyType : int
(since QtQuick.VirtualKeyboard 6.1) - noKeyEvent : bool
(since QtQuick.VirtualKeyboard 1.3) - noModifier : bool
(since QtQuick.VirtualKeyboard 1.3) - pressed : bool
- repeat : bool
- showPreview : bool
- smallText : string
(since QtQuick.VirtualKeyboard 2.0) - smallTextVisible : bool
(since QtQuick.VirtualKeyboard 2.0) - soundEffect : url
(since QtQuick.VirtualKeyboard 1.1) - text : string
- uppercased : bool
- weight : real
Signale
- clicked()
Detaillierte Beschreibung
BaseKey ist ein gemeinsamer Typ für alle Tasten im Tastaturlayout.
Dieser Typ sollte nicht direkt in den Layouts verwendet werden. Stattdessen sollten die spezialisierten Tastentypen, wie Key oder EnterKey verwendet werden.
Eigenschaft Dokumentation
active : bool |
Diese Eigenschaft enthält den aktiven Status der Taste.
Diese Eigenschaft wird automatisch auf true gesetzt, wenn die Taste gedrückt wird.
alternativeKeys : var |
Legt die Liste der alternativen Tasten fest.
Diese Eigenschaft kann auf eine Zeichenkette oder eine Liste von Zeichenketten festgelegt werden. Wenn der Wert eine Zeichenkette ist, werden die alternativen Tasten als einzelne Zeichen dieser Zeichenkette dargestellt. Handelt es sich bei dem Wert um eine Liste von Zeichenfolgen, wird stattdessen die Liste verwendet.
Die alternativen Tasten werden dem Benutzer durch Drücken und Halten einer Taste mit dieser Eigenschaft angezeigt.
Hinweis: Wenn die alternativen Tasten den Schlüssel text enthalten, wird dieser aus effectiveAlternativeKeys herausgefiltert und seine Position wird stattdessen als Indikator für das hervorgehobene Element verwendet.
Die Standardeinstellung ist eine leere Liste.
displayAlternativeKeys : var |
Mit dieser Eigenschaft kann die Liste der Schlüsselstrings, die dem Benutzer in der alternativen Schlüsselansicht präsentiert wird, überschrieben werden.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 6.2 eingeführt.
displayText : string |
Legt den Anzeigetext fest.
Diese Zeichenfolge wird im Tastaturlayout angezeigt.
Der Standardwert ist der Tastentext.
effectiveAlternativeKeys : var |
Diese Eigenschaft enthält die effektiven alternativen Tasten, die dem Benutzer angezeigt werden.
Die Liste enthält die Elemente in alternativeKeys mit Ausnahme des Elements text.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.
effectiveAlternativeKeysHighlightIndex : int |
Diese Eigenschaft enthält den Index des hervorgehobenen Elements in effectiveAlternativeKeys.
Der Index wird aus dem Index der Taste text in alternativeKeys berechnet.
Wenn zum Beispiel die alternativen Tasten "çcċčć" enthalten und die Taste text "c" ist, wird dieser Index zu 1 und die effektiven alternativen Tasten, die dem Benutzer präsentiert werden, sind "ç[ċ]čć".
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.
functionKey : bool |
Setzt das Funktionstasten-Attribut.
Der Standardwert ist false.
highlighted : bool |
Legt den Hervorhebungsstatus der Taste fest.
Die Voreinstellung ist false.
key : int |
Legt den Tastencode für die Verarbeitung der Eingabemethode fest.
Die Vorgabe ist Qt.Key_unknown.
keyPanelDelegate : alias |
Legt den Tastenfelddelegierten für die Taste fest.
Diese Eigenschaft ist wichtig für die Tastendekoration. Ohne einen Tastenfelddelegierten ist die Taste unsichtbar. Diese Eigenschaft sollte im geerbten Schlüsseltyp zugewiesen werden.
keyType : int |
Key Typ für den spezialisierten Schlüssel zugewiesen werden. Die möglichen Werte werden durch die Aufzählung {QtVirtualKeyboard::KeyType}{key type enumeration} definiert.
Zum Beispiel setzt SpaceKey diesen Wert auf QtVirtualKeyboard.KeyType.SpaceKey.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 6.1 eingeführt.
noKeyEvent : bool |
Diese Eigenschaft steuert, ob die Taste Tastenereignisse für die Verarbeitung von Eingabemethoden ausgibt. Wenn true, sind die Tastenereignisse deaktiviert.
Standardmäßig wird das Tastenereignis ausgegeben, wenn die Taste nicht unbekannt ist oder der Text nicht leer ist.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 1.3 eingeführt.
noModifier : bool |
Deaktiviert Tastenmodifikatoren für die ausgegebene Taste.
Die Voreinstellung ist false.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 1.3 eingeführt.
pressed : bool |
Diese Eigenschaft enthält den Status "gedrückt" der Taste.
Der Status "gedrückt" kann nur true sein, wenn die Taste sowohl aktiviert als auch aktiv ist. Wenn der Status der Taste gedrückt wird, wird ein "key down"-Ereignis für die Eingabe-Engine ausgelöst. Wenn die Taste losgelassen wird, wird ein Ereignis "Taste hoch" ausgelöst.
repeat : bool |
Legt das Attribut für die Tastenwiederholung fest.
Wenn die Wiederholung aktiviert ist, wiederholt die Taste die Eingabeereignisse, solange sie gedrückt gehalten wird. Die Wiederholung sollte nicht verwendet werden, wenn alternativeKeys ebenfalls gesetzt ist.
Der Standardwert ist false.
showPreview : bool |
Legt das Attribut "Vorschau anzeigen" fest.
Standardmäßig wird das Popup-Fenster für die Zeichenvorschau bei Funktionstasten nicht angezeigt.
smallText : string |
Legt den kleinen Text fest, der in der Ecke der Taste angezeigt wird.
Der Standardwert basiert auf dem Standardelement in den effektiven alternativen Tasten.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.
smallTextVisible : bool |
Legt die Sichtbarkeit von kleinem Text fest.
Der Standardwert wird vom Elternteil geerbt.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.
soundEffect : url |
Diese Eigenschaft enthält den Soundeffekt, der beim Drücken einer Taste abgespielt wird.
Diese Eigenschaft ist schreibgeschützt, da die Soundeffekte im Tastaturstil definiert sind.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 1.1 eingeführt.
text : string |
Setzt den Tastentext für die Verarbeitung der Eingabemethode.
In den meisten Fällen ist dies die Unicode-Darstellung des Tastencodes.
Der Standardwert ist ein leerer String.
uppercased : bool |
Diese Eigenschaft enthält den Großbuchstabenstatus der Taste.
Standardmäßig spiegelt diese Eigenschaft den Großbuchstabenstatus der Tastatur wider.
weight : real |
Legt den Wert für das Tastengewicht fest, der die relative Größe der Taste bestimmt.
Verwenden Sie diese Eigenschaft, um die Tastengröße im Layout zu ändern.
Der Standardwert wird vom übergeordneten Element der Taste in der Layouthierarchie geerbt.
Signal Dokumentation
clicked() |
Dieses Signal wird ausgelöst, wenn die Taste gedrückt wird, und ermöglicht eine benutzerdefinierte Verarbeitung der Taste.
Hinweis: Der entsprechende Handler ist onClicked.
© 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.
