BaseKey QML Type
Gemeinsamer übergeordneter Typ 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()
Ausführliche Beschreibung
„BaseKey“ ist ein allgemeiner Typ für alle Tasten in einem Tastaturlayout.
Dieser Typ sollte nicht direkt in den Layouts verwendet werden. Stattdessen sollten die spezialisierten Tastentypen wie „Key“ oder „ EnterKey “ verwendet werden.
Dokumentation der Eigenschaften
active : bool
Diese Eigenschaft gibt den Aktivitätsstatus der Taste an.
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. Ist der Wert eine Zeichenkette, werden die alternativen Tasten als einzelne Zeichen dieser Zeichenkette dargestellt. Ist der Wert eine Liste von Zeichenketten, wird stattdessen die Liste verwendet.
Die alternativen Tasten werden dem Benutzer angezeigt, wenn eine Taste, für die diese Eigenschaft festgelegt ist, gedrückt und gehalten wird.
Hinweis: Wenn die Liste der alternativen Tasten die Taste „ text “ enthält, wird diese aus der Liste „ effectiveAlternativeKeys “ herausgefiltert und ihre Position stattdessen als Indikator für das markierte Element verwendet.
Die Standardeinstellung ist eine leere Liste.
displayAlternativeKeys : var [since 6.2]
Mit dieser Eigenschaft lässt sich die Liste der Schlüsselzeichenfolgen überschreiben, die dem Benutzer in der Ansicht „Alternative Tasten“ angezeigt wird.
Diese Eigenschaft wurde in Qt 6.2 eingeführt.
displayText : string
Legt den Anzeigetext fest.
Diese Zeichenfolge wird im Tastaturlayout angezeigt.
Der Standardwert ist der Tasten-Text.
effectiveAlternativeKeys : var [read-only, since QtQuick.VirtualKeyboard 2.0]
Diese Eigenschaft enthält die effektiven alternativen Schlüssel, die dem Benutzer angezeigt werden.
Die Liste enthält die Elemente der „ 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 markierten Elements in der „ effectiveAlternativeKeys “.
Der Index wird aus dem Index des Schlüssels „ text “ im „ alternativeKeys “ berechnet.
Wenn die alternativen Tasten beispielsweise „çcċčć“ enthalten und der Schlüssel „ text “ den Wert „c“ hat, beträgt dieser Index 1, und die dem Benutzer tatsächlich angezeigten alternativen Tasten lauten „ç[ċ]čć“.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.
functionKey : bool
Legt das Attribut der Funktionstaste fest.
Der Standardwert ist „false“.
highlighted : bool
Legt den Hervorhebungsstatus der Taste fest.
Der Standardwert ist „false“.
key : int
Legt den Tastencode für die Verarbeitung durch die Eingabemethode fest.
Der Standardwert ist Qt.Key_unknown.
keyPanelDelegate : alias
Legt den Schlüssel-Panel-Delegaten für den Schlüssel fest.
Diese Eigenschaft ist für die Gestaltung der Schaltfläche unerlässlich. Ohne einen Schlüsselbereichs-Delegaten ist die Schaltfläche unsichtbar. Diese Eigenschaft sollte im geerbten Schaltflächentyp zugewiesen werden.
keyType : int [since 6.1]
Key Typ für die spezielle Taste. Mögliche Werte sind durch die {QtVirtualKeyboard::KeyType}{Tastentyp-Aufzählung} definiert.
Beispielsweise 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 legt fest, ob die Taste Tastenereignisse für die Verarbeitung durch die Eingabemethode auslöst. Bei „true“ sind die Tastenereignisse deaktiviert.
Standardmäßig wird das Tastenereignis ausgelöst, 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.
Der Standardwert ist „false“.
Diese Eigenschaft wurde in QtQuick.VirtualKeyboard 1.3 eingeführt.
pressed : bool
Diese Eigenschaft speichert den Status „gedrückt“ der Taste.
Der Status „gedrückt“ kann nur dann „true“ sein, wenn die Taste sowohl aktiviert als auch aktiv ist. Wenn der Status der Taste auf „gedrückt“ wechselt, löst dies ein Key-Down-Ereignis für die Eingabe-Engine aus. Ein Key-Up-Ereignis wird ausgelöst, wenn die Taste losgelassen wird.
repeat : bool
Legt das Attribut „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 zur Zeichenvorschau weder für Funktionstasten angezeigt noch dann, wenn das fokussierte Eingabefeld den angezeigten Text verdeckt, beispielsweise bei einem Passwortfeld. Im letzteren Fall würde die Vorschau die Zeichen anzeigen, die das Eingabefeld verdeckt.
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 gültigen 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 übergeordneten Element übernommen.
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 werden soll.
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 Tastentext für die Verarbeitung durch die Eingabemethode fest.
In den meisten Fällen handelt es sich dabei um die Unicode-Darstellung des Tastencodes.
Der Standardwert ist eine leere Zeichenkette.
uppercased : bool
Diese Eigenschaft gibt den Großbuchstabenstatus der Taste an.
Standardmäßig spiegelt diese Eigenschaft den Großbuchstabenstatus der Tastatur wider.
weight : real
Legt den Wert für die Schlüsselgröße fest, der die relative Größe des Schlüssels bestimmt.
Verwenden Sie diese Eigenschaft, um die Größe des Schlüssels im Layout zu ändern.
Der Standardwert wird vom übergeordneten Element der Taste in der Layout-Hierarchie übernommen.
Signal-Dokumentation
clicked()
Dieses Signal wird beim Drücken der Taste ausgelöst und ermöglicht eine benutzerdefinierte Verarbeitung der Taste.
Hinweis: Der entsprechende Handler lautet „ 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.
