BaseKey QML Type
Gemeinsames Elternteil für alle Schlüsseltypen. Mehr...
| Import Statement: | import QtQuick.VirtualKeyboard.Components |
| Inherits: | |
| Inherited By: | 14 typesBackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, FlickKey, HandwritingModeKey, HideKeyboardKey, InputModeKey, Key, ModeKey, NumberKey, ShiftKey, SpaceKey, and SymbolModeKey |
Eigenschaften
- active : bool
- alternativeKeys : var
- displayAlternativeKeys : var
(since 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 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.
Dokumentation der Eigenschaft
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 Schlüssel fest.
Diese Eigenschaft kann auf eine Zeichenkette oder eine Liste von Zeichenketten festgelegt werden. Wenn der Wert eine Zeichenkette ist, werden die alternativen Schlüssel als einzelne Zeichen dieser Zeichenkette dargestellt. Ist der Wert eine Liste von Zeichenketten, 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 [since 6.2]
Diese Eigenschaft erlaubt es, die Liste der Tastenstrings zu überschreiben, die dem Benutzer in der alternativen Tastenansicht präsentiert werden.
Diese Eigenschaft wurde in Qt 6.2 eingeführt.
displayText : string
Legt den Anzeigetext fest.
Diese Zeichenfolge wird in der Tastaturbelegung wiedergegeben.
Der Standardwert ist der Tastentext.
effectiveAlternativeKeys : var [read-only, since QtQuick.VirtualKeyboard 2.0]
Diese Eigenschaft enthält die effektiven alternativen Schlüssel, die dem Benutzer präsentiert 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 [read-only, since QtQuick.VirtualKeyboard 2.0]
Diese Eigenschaft enthält den Index des hervorgehobenen Elements in der Datei effectiveAlternativeKeys.
Der Index wird aus dem Index des Schlüssels 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 Attribut Funktionstaste.
Der Standardwert ist false.
highlighted : bool
Legt den hervorgehobenen Status der Taste fest.
Der Standardwert ist false.
key : int
Legt den Schlüsselcode für die Verarbeitung von Eingabemethoden fest.
Der Standardwert ist Qt.Key_unknown.
keyPanelDelegate : alias
Legt den Delegierten des Tastenfelds für die Taste fest.
Diese Eigenschaft ist für die Tastendekoration unerlässlich. Ohne einen Tastenfelddelegierten ist die Taste unsichtbar. Diese Eigenschaft sollte im geerbten Schlüsseltyp zugewiesen werden.
keyType : int [since 6.1]
Key Typ für den spezialisierten Schlüssel. 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 Qt 6.1 eingeführt.
noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]
Diese Eigenschaft steuert, ob die Taste Tastenereignisse für die Verarbeitung der Eingabemethode ausgibt. Bei 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 [since QtQuick.VirtualKeyboard 1.3]
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 wahr sein, wenn die Taste sowohl aktiviert als auch aktiv ist. Wenn der Status der Taste gedrückt wird, löst dies ein "key down"-Ereignis für das Eingabegerät aus. Wenn die Taste losgelassen wird, wird ein Ereignis "Taste hoch" ausgelöst.
repeat : bool
Legt das Attribut der 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 eingestellt 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 [since QtQuick.VirtualKeyboard 2.0]
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 [since QtQuick.VirtualKeyboard 2.0]
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 [read-only, since QtQuick.VirtualKeyboard 1.1]
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
Legt den Schlüsseltext für die Verarbeitung der Eingabemethode fest.
In den meisten Fällen ist dies die Unicode-Darstellung des Schlüsselcodes.
Der Standardwert ist eine leere Zeichenkette.
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 die Tastengewichtung fest, der die relative Größe der Taste bestimmt.
Verwenden Sie diese Eigenschaft, um die Schlüsselgröße im Layout zu ändern.
Der Standardwert wird vom übergeordneten Element des Schlüssels in der Layouthierarchie geerbt.
Signal-Dokumentation
clicked()
Dieses Signal wird ausgelöst, wenn die Taste gedrückt wird, was eine benutzerdefinierte Verarbeitung der Taste ermöglicht.
Hinweis: Der entsprechende Handler ist onClicked.
© 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.
