BaseKey QML Type

Parent commun à tous les types de clés. Plus d'informations...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

Item

Inherited By:

BackspaceKey, ChangeLanguageKey, EnterKey, FillerKey, HideKeyboardKey, Key, and ShiftKey

Propriétés

Signaux

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 touches 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 touches 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 QtQuick.VirtualKeyboard 6.2]

Cette propriété permet de modifier la liste des chaînes de caractères présentées à l'utilisateur dans la vue des clés alternatives.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard 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 touches 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 en surbrillance dans effectiveAlternativeKeys.

L'indice est calculé à partir de l'indice de la clé text dans alternativeKeys.

Par exemple, si les touches alternatives contiennent "çcċčć" et que la touche text est "c", cet indice deviendra 1 et les touches 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 touche 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 des touches. Sans délégué, la clé est invisible. Cette propriété doit être attribuée dans le type de clé hérité.


keyType : int [since QtQuick.VirtualKeyboard 6.1]

Key Cette propriété définit le type de clé héritée pour la clé spécialisée. Les valeurs possibles sont définies par l'énumération {QtVirtualKeyboard::KeyType}{type de clé}.

Par exemple, SpaceKey fixe cette valeur à QtVirtualKeyboard.KeyType.SpaceKey.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard 6.1.


noKeyEvent : bool [since QtQuick.VirtualKeyboard 1.3]

Cette propriété contrôle si la touche émet des événements de touche pour le traitement de la méthode d'entrée. Lorsqu'elle est égale à true (vrai), 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 pressé, cela déclenche un événement "key down" pour le moteur d'entrée. Un événement de remontée de la touche 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 alternativeKeys est également défini.

La valeur par défaut est false.


showPreview : bool

Définit l'attribut show preview.

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 affiché dans le coin de la touche.

La valeur par défaut est basée sur l'élément par défaut des 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 touche 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 touche.

La valeur par défaut est une chaîne vide.


uppercased : bool

Cette propriété indique l'état de la 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 touche qui détermine la taille relative de la touche.

Utilisez cette propriété pour modifier la taille des touches dans la disposition.

La valeur par défaut est héritée de l'élément parent de la touche dans la hiérarchie du modèle.


Signal Documentation

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.


© 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.