BaseKey QML Type

Parent commun à tous les types de clés. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

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’une disposition de clavier.

Ce type ne doit pas être utilisé directement dans les dispositions. Il convient d'utiliser à la place les types de touches spécialisés, tels que « Key » ou « EnterKey ».

Documentation des propriétés

active : bool

Cette propriété indique si la touche est active.

Cette propriété est automatiquement définie sur « true » lorsque la touche est enfoncée.

alternativeKeys : var

Définit la liste des clés alternatives.

Cette propriété peut prendre la valeur d'une chaîne de caractères ou d'une liste de chaînes de caractères. Si la valeur est une chaîne de caractères, les touches alternatives sont présentées sous forme de caractères individuels de cette chaîne. Si la valeur est une liste de chaînes de caractères, c'est cette liste qui est utilisée à la place.

Les touches alternatives s'affichent à l'utilisateur lorsqu'il appuie sur une touche pour laquelle cette propriété est définie et la maintient enfoncée.

Par défaut, cette liste est vide.

displayAlternativeKeys : var [since 6.2]

Cette propriété permet de redéfinir la liste des chaînes de caractères correspondant aux touches affiché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 affiché.

Cette chaîne s'affiche dans la configuration 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 la propriété « 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 surbrillance dans le fichier « effectiveAlternativeKeys ».

Cet index est calculé à partir de l'index de la clé « text » dans la table « alternativeKeys ».

Par exemple, si les touches alternatives contiennent « çcċčć » et que la clé « text » est « c », cet index sera égal à 1 et les touches alternatives effectivement 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 mise en surbrillance de la touche.

La valeur par défaut est « false ».

key : int

Définit le code de touche pour le traitement de la méthode de saisie.

La valeur par défaut est Qt.Key_unknown.

keyPanelDelegate : alias

Définit le délégué du panneau de clés pour la clé.

Cette propriété est indispensable à la personnalisation de la touche. Sans délégué de panneau de touche, la touche est invisible. Cette propriété doit être définie dans le type de touche hérité.

keyType : int [since 6.1]

Key Type de la touche spécialisée. Les valeurs possibles sont définies par l'énumération {QtVirtualKeyboard::KeyType} {énumération des types de touches}.

Par exemple, ` SpaceKey ` définit cette valeur sur ` 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 génère des événements de touche pour le traitement par la méthode de saisie. Si elle est définie sur « true », les événements de touche sont désactivés.

Par défaut, l'événement de 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 touche 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é contient 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 la touche passe à l'état « enfoncé », cela déclenche un événement « key down » pour le moteur de saisie. 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 des touches.

Si la répétition est activée, la touche répète les événements de saisie tant qu'elle reste enfoncée. La répétition ne doit pas être utilisée si l'option « alternativeKeys » est également activée.

La valeur par défaut est « false ».

showPreview : bool

Définit l'attribut « show preview ».

Par défaut, la fenêtre contextuelle d'aperçu des caractères ne s'affiche pas pour les touches de fonction, ni lorsque le champ de saisie actif masque le texte qu'il affiche, par exemple un champ de mot de passe. Dans ce dernier cas, l'aperçu révélerait les caractères masqués par le champ de saisie.

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 texte en petits caractères.

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 à lire lorsqu'une touche est enfoncée.

Cette propriété est en lecture seule, car les effets sonores sont définis dans le style du clavier.

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

text : string

Définit le texte de la touche pour le traitement par la méthode de saisie.

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 si la touche est en mode majuscule.

Par défaut, cette propriété reflète l'état de la touche Maj du clavier.

weight : real

Définit la valeur de poids de la clé qui détermine la taille relative de celle-ci.

Utilisez cette propriété pour 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 touche dans la hiérarchie de la mise en page.

Documentation Signal

clicked()

Ce signal est déclenché lorsque la touche est enfoncée, ce qui permet un traitement personnalisé de la touche.