BaseKey QML Type
Parent commun à tous les types de clés. Plus d'informations...
| 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 |
Propriétés
- 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
Signaux
- clicked()
Description détaillée
BaseKey est un type commun à toutes les touches d'un clavier.
Ce type ne doit pas être utilisé directement dans les dispositions. Les types de touches spécialisés, tels que Key ou EnterKey, doivent être utilisés à la place.
Propriété Documentation
active : bool
Cette propriété indique l'état actif de la touche.
Cette propriété prend automatiquement la valeur true lorsque la touche est enfoncée.
alternativeKeys : var
Définit la liste des clés alternatives.
Cette propriété peut prendre la forme d'une chaîne de caractères ou d'une liste de chaînes de caractères. Si la valeur est une chaîne, les clés alternatives sont présentées comme des caractères individuels de cette chaîne. Si la valeur est une liste de chaînes, la liste est utilisée à la place.
Les touches alternatives sont présentées à l'utilisateur lorsqu'il appuie sur une touche avec cette propriété et la maintient enfoncée.
Remarque : si les touches alternatives contiennent la touche text, celle-ci sera filtrée à partir de effectiveAlternativeKeys et sa position sera utilisée comme indicateur de l'élément mis en surbrillance.
Par défaut, la liste est vide.
displayAlternativeKeys : var [since 6.2]
Cette propriété permet de modifier la liste des chaînes de touches présentées à l'utilisateur dans la vue des touches alternatives.
Cette propriété a été introduite dans Qt 6.2.
displayText : string
Définit le texte d'affichage.
Cette chaîne est affichée dans la disposition du clavier.
La valeur par défaut est le texte de la touche.
effectiveAlternativeKeys : var [read-only, since QtQuick.VirtualKeyboard 2.0]
Cette propriété contient les clés alternatives effectives présentées à l'utilisateur.
La liste contient les éléments de alternativeKeys à l'exception de l'élément text.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.0.
effectiveAlternativeKeysHighlightIndex : int [read-only, since QtQuick.VirtualKeyboard 2.0]
Cette propriété contient l'index de l'élément mis en évidence dans le site effectiveAlternativeKeys.
L'indice est calculé à partir de l'indice de la clé text dans le alternativeKeys.
Par exemple, si les clés alternatives contiennent "çcċčć" et que la clé text est "c", cet indice deviendra 1 et les clés alternatives effectives présentées à l'utilisateur seront "ç[ċ]čć".
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.0.
functionKey : bool
Définit l'attribut de la touche de fonction.
La valeur par défaut est false.
highlighted : bool
Définit l'état de surbrillance de la touche.
La valeur par défaut est false.
key : int
Définit le code de la clé pour le traitement de la méthode d'entrée.
La valeur par défaut est Qt.Key_unknown.
keyPanelDelegate : alias
Définit le délégué du panneau de touches pour la touche.
Cette propriété est essentielle pour la décoration de la clé. Sans délégué au panneau des clés, la clé est invisible. Cette propriété doit être attribuée au type de clé hérité.
keyType : int [since 6.1]
Key pour la clé spécialisée. Les valeurs possibles sont définies par l'énumération {QtVirtualKeyboard::KeyType}{key type enumeration}.
Par exemple, SpaceKey fixe cette valeur à QtVirtualKeyboard.KeyType.SpaceKey.
Cette propriété a été introduite dans Qt 6.1.
noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]
Cette propriété détermine si la touche émet des événements de touche pour le traitement de la méthode d'entrée. Si elle est égale à true, les événements de touche sont désactivés.
Par défaut, l'événement touche est émis si la touche n'est pas inconnue ou si le texte n'est pas vide.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 1.3.
noModifier : bool [since QtQuick.VirtualKeyboard 1.3]
Désactive les modificateurs de touches sur la touche émise.
La valeur par défaut est false.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 1.3.
pressed : bool
Cette propriété indique l'état enfoncé de la touche.
L'état enfoncé ne peut être vrai que si la touche est à la fois activée et active. Lorsque l'état de la touche devient enfoncé, cela déclenche un événement de descente de touche pour le moteur d'entrée. Un événement "key up" est déclenché lorsque la touche est relâchée.
repeat : bool
Définit l'attribut de répétition de la touche.
Si la répétition est activée, la touche répète les événements d'entrée lorsqu'elle est maintenue enfoncée. La répétition ne doit pas être utilisée si l'attribut alternativeKeys est également activé.
La valeur par défaut est false.
showPreview : bool
Définit l'attribut d'affichage de l'aperçu.
Par défaut, la fenêtre de prévisualisation des caractères n'est pas affichée pour les touches de fonction.
smallText : string [since QtQuick.VirtualKeyboard 2.0]
Définit le petit texte rendu dans le coin de la clé.
La valeur par défaut est basée sur l'élément par défaut dans les touches alternatives effectives.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.0.
smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]
Définit la visibilité du petit texte.
La valeur par défaut est héritée du parent.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 2.0.
soundEffect : url [read-only, since QtQuick.VirtualKeyboard 1.1]
Cette propriété contient l'effet sonore à jouer lors de l'appui sur une touche.
Cette propriété est en lecture seule car les effets sonores sont définis dans le style de clavier.
Cette propriété a été introduite dans QtQuick.VirtualKeyboard 1.1.
text : string
Définit le texte de la clé pour le traitement de la méthode d'entrée.
Dans la plupart des cas, il s'agit de la représentation Unicode du code de la clé.
La valeur par défaut est une chaîne vide.
uppercased : bool
Cette propriété indique le statut majuscule de la touche.
Par défaut, cette propriété reflète l'état majuscule du clavier.
weight : real
Définit la valeur du poids de la clé qui détermine la taille relative de la clé.
Cette propriété permet de modifier la taille de la clé dans la mise en page.
La valeur par défaut est héritée de l'élément parent de la clé dans la hiérarchie de la mise en page.
Documentation sur les signaux
clicked()
Ce signal est déclenché lorsque la touche est enfoncée, ce qui permet un traitement personnalisé de la touche.
Remarque : le gestionnaire correspondant est 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.
