Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

KeyboardStyle QML Type

Fournit une interface de personnalisation pour le clavier virtuel. En savoir plus…

Import Statement: import QtQuick.VirtualKeyboard.Styles
Inherits:

QtObject

Propriétés

Description détaillée

Le type de style fournit les définitions de style utilisées par l'InputPanel pour personnaliser le clavier virtuel.

La taille de conception spécifie le rapport d'aspect du clavier virtuel. Les styles sont redimensionnables en fonction de l'scaleHint, qui est calculée à partir de la hauteur réelle du clavier et de sa hauteur de conception.

Le clavier est agencé selon une taille de conception fixe, définie par ` keyboardDesignWidth ` et ` keyboardDesignHeight`, puis mis à l’échelle pour s’adapter à la largeur disponible. La hauteur affichée découle du format de conception : ` keyboardDesignHeight * width / keyboardDesignWidth`. ` keyboardHeight ` reflète la hauteur réelle, mise à l’échelle, utilisée lors de l’exécution.

keyboardDesignMaximumHeight Il est possible, en option, de limiter cette hauteur. Tant que cette limitation n’est pas activée, la zone des touches s’étend sur toute la largeur disponible. Lorsque la hauteur mise à l’échelle dépasserait la valeur maximale, le rapport d’aspect de conception est préservé et c’est l’ensemble du clavier qui est mis à l’échelle selon keyboardDesignMaximumHeight / keyboardDesignHeight; ainsi, le clavier ne dépasse jamais la hauteur maximale. Dans ce cas de limitation, la zone des touches devient plus étroite que la largeur disponible et est centrée, laissant des marges vides de chaque côté ; seul l’arrière-plan du clavier s’étend encore sur toute la largeur. scaleHint correspond au rapport entre keyboardHeight et keyboardDesignHeight et doit être utilisé pour conserver la proportionnalité de toutes les dimensions en pixels.

Notez que keyboardDesignWidth et keyboardDesignHeight sont des unités de création (les styles intégrés utilisent 2560x800 et ne sont jamais affichés à cette taille), tandis que keyboardDesignMaximumHeight est exprimé en pixels logiques, car il est comparé directement à la hauteur affichée (qui est également en pixels logiques).

Documentation sur les propriétés

alternateKeysListBackground : Component

Modèle pour l'arrière-plan de la liste des touches alternatives.

alternateKeysListBottomMargin : real

Marge inférieure du panneau contenant la liste des touches alternatives.

alternateKeysListDelegate : Component

Modèle pour l'élément de la liste des clés alternatives.

Remarque : le délégué est utilisé dans une ListView.

Les propriétés suivantes sont disponibles pour cet élément :

  • text : le texte de la clé
  • data : les données de la clé

alternateKeysListHighlight : Component

Modèle pour la mise en évidence de la liste des touches alternatives.

Remarque : le délégué est utilisé sous la forme ListView.highlight.

alternateKeysListItemHeight : real

Hauteur de l'élément de la liste des touches alternatives.

alternateKeysListItemWidth : real

Largeur de l'élément de la liste des touches alternatives.

alternateKeysListLeftMargin : real

Marge gauche du panneau contenant la liste des touches alternatives.

alternateKeysListRightMargin : real

Marge droite du panneau contenant la liste des touches alternatives.

alternateKeysListTopMargin : real

Marge supérieure du panneau contenant la liste des touches alternatives.

backspaceKeyPanel : Component

Modèle pour la touche « Retour arrière ».

Remarque : le délégué doit être dérivé du type ` KeyPanel `.

characterPreviewDelegate : Component

Modèle pour la fenêtre contextuelle d'aperçu du caractère.

Si le délégué contient la propriété « text », celle-ci est mise à jour avec le texte d'affichage lorsque le composant devient actif.

property string text

Exemple :

characterPreviewDelegate: Item {
    property string text
    id: characterPreview
    Rectangle {
        id: characterPreviewBackground
        anchors.fill: parent
        ...
        Text {
            text: characterPreview.text
            anchors.fill: parent
            ...
        }
    }
}

characterPreviewMargin : real

Nombre de pixels entre le haut de chaque touche et le bas de l'characterPreviewDelegate.

enterKeyPanel : Component

Modèle pour la touche Entrée.

Remarque : le délégué doit être basé sur le type KeyPanel.

fullScreenInputBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété contient le délégué défini pour l'arrière-plan du champ de saisie en plein écran.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété définit la couleur du texte du champ de saisie en mode plein écran.

La couleur par défaut est le noir.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputContainerBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété contient le délégué associé à l'arrière-plan du conteneur de saisie en plein écran.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputCursor : Component [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété contient le délégué du curseur dans le champ de saisie en plein écran.

Le délégué doit activer ou désactiver la visibilité du curseur en fonction de la propriété « parent.blinkStatus » définie pour le champ de saisie en plein écran. Par exemple :

fullScreenInputCursor: Rectangle {
    width: 1
    color: "#000"
    visible: parent.blinkStatus
}

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputFont : font [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété contient l'font e du champ de saisie en plein écran.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputMargins : real [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété définit les marges autour du champ de saisie en plein écran.

La valeur par défaut est « 0 ».

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputPadding : real [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété définit l'espacement autour du contenu saisi en mode plein écran.

La valeur par défaut est « 0 ».

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputPasswordCharacter : string [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété contient le caractère de masquage du mot de passe pour le champ de saisie en plein écran.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputSelectedTextColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété définit la couleur du texte sélectionné dans le champ de saisie en plein écran.

La couleur par défaut est définie sur fullScreenInputColor.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

fullScreenInputSelectionColor : color [since QtQuick.VirtualKeyboard.Styles 2.2]

Cette propriété définit la couleur de sélection du champ de saisie en plein écran.

La couleur par défaut est un noir semi-transparent.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.2.

functionPopupListBackground : Component [since 6.2]

Modèle pour l'arrière-plan de la liste contextuelle des fonctions.

Cette propriété a été introduite dans Qt 6.2.

functionPopupListDelegate : Component [since 6.2]

Modèle pour l'élément de la liste des fonctions.

Remarque : le délégué est utilisé dans une ListView.

Les propriétés suivantes sont disponibles pour l'élément :

  • keyboardFunction - Fonction clavier de l’élément actuel.

Cette propriété a été introduite dans Qt 6.2.

functionPopupListHighlight : Component [since 6.2]

Modèle pour la mise en surbrillance de la liste contextuelle de la fonction.

Remarque : le délégué est utilisé sous la forme ListView.highlight.

Cette propriété a été introduite dans Qt 6.2.

handwritingKeyPanel : Component

Modèle pour la touche du mode écriture manuscrite.

Remarque : le délégué doit être dérivé du type « KeyPanel ».

hideKeyPanel : Component

Modèle pour la clé « hide ».

Remarque : le délégué doit être dérivé du type ` KeyPanel `.

keyPanel : Component

Modèle pour les clés standard.

Remarque : le délégué doit être basé sur le type KeyPanel.

Exemple :

keyPanel: KeyPanel {
    Rectangle {
        anchors.fill: parent
        ...
        Text {
            anchors.fill: parent
            text: control.displayText
            ...
        }
    }
}

keyboardBackground : Component

Modèle pour l'arrière-plan du clavier.

Exemple :

keyboardBackground: Rectangle {
    color: "black"
}

keyboardDesignHeight : real

La hauteur de conception du clavier, exprimée en unités de création.

Associée à keyboardDesignWidth, elle définit le rapport d'aspect de conception de la disposition du clavier. La hauteur affichée est keyboardDesignHeight * width / keyboardDesignWidth, sauf si cette valeur dépasse keyboardDesignMaximumHeight, auquel cas le rapport d'aspect de conception est conservé et l'ensemble du clavier est mis à l'échelle par keyboardDesignMaximumHeight / keyboardDesignHeight à la place. Il s'agit également de la hauteur de référence utilisée par scaleHint.

keyboardDesignMaximumHeight : real [since 6.11]

Hauteur maximale de conception du clavier, en pixels logiques.

Lorsqu'elle est définie sur une valeur supérieure à 0, elle limite la hauteur affichée qui résulterait autrement de la mise à l'échelle de keyboardDesignHeight à la largeur disponible. Si la hauteur mise à l'échelle dépasse ce maximum, le clavier est affiché à la hauteur keyboardDesignMaximumHeight ; le rapport d'aspect de conception est conservé et l'ensemble du clavier est mis à l'échelle par keyboardDesignMaximumHeight / keyboardDesignHeight à la place, de sorte que le clavier ne dépasse jamais la hauteur maximale. Une valeur égale ou inférieure à 0 (valeur par défaut) signifie qu’il n’y a pas de limite maximale ; la hauteur suit donc keyboardDesignHeight mise à l’échelle en fonction de la largeur.

Contrairement à ` keyboardDesignWidth ` et ` keyboardDesignHeight`, cette valeur est exprimée en pixels logiques, car elle est comparée directement à la hauteur affichée.

Cette propriété a été introduite dans Qt 6.11.

keyboardDesignWidth : real

La largeur de conception du clavier, exprimée en unités de création.

Associée à l’ keyboardDesignHeight, elle définit le rapport d’aspect de conception de la disposition du clavier. Le style est créé à cette taille, puis mis à l’échelle en fonction de la largeur réelle ; la hauteur affichée est dérivée de l’ keyboardDesignHeight * width / keyboardDesignWidth.

keyboardHeight : real

La hauteur actuelle du clavier, en pixels logiques.

Il s'agit de la hauteur réelle, mise à l'échelle, à laquelle le clavier est affiché. Elle est définie par l'implémentation du clavier (liée à la hauteur du conteneur de la zone des touches) et reflète la disposition résultant de l'application des propriétés keyboardDesignWidth, keyboardDesignHeight et, si elle est définie, keyboardDesignMaximumHeight à la largeur disponible. Utilisez-la conjointement avec keyboardDesignHeight pour obtenir scaleHint.

keyboardRelativeBottomMargin : real

Distance entre les touches les plus basses et le bord inférieur du conteneur du clavier, exprimée en pourcentage (0.0 - 1.0) de la hauteur du clavier.

keyboardRelativeLeftMargin : real

Distance entre les touches situées à l'extrême gauche et le bord gauche du clavier, exprimée en pourcentage (0.0 - 1.0) de la largeur du clavier.

keyboardRelativeRightMargin : real

Distance entre les touches situées à l'extrême droite et le bord droit du clavier, exprimée en pourcentage (0.0 - 1.0) de la largeur du clavier.

Cette valeur est proportionnelle à la largeur du clavier.

keyboardRelativeTopMargin : real

Distance entre les touches les plus hautes et le bord supérieur du clavier, exprimée en pourcentage (0.0 - 1.0) de la hauteur du clavier.

languageKeyPanel : Component

Modèle pour la clé de langue.

Remarque : le délégué doit être basé sur le type ` KeyPanel `.

languageListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

Cette propriété définit la transition à appliquer aux éléments ajoutés à la vue de liste des langues.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

languageListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Modèle pour l'arrière-plan de la liste des langues.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

languageListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Modèle pour l'élément « Liste des langues ».

Remarque : le délégué est utilisé dans un ` ListView`.

Remarque : le délégué doit être basé sur le type SelectionListItem.

Les propriétés suivantes sont disponibles pour cet élément :

  • displayName Nom d'affichage de la langue.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

languageListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Modèle pour la mise en évidence de la liste des langues.

Remarque : le délégué est utilisé sous la forme ListView.highlight.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

languageListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

Cette propriété définit la transition à appliquer aux éléments supprimés de la vue de liste des langues.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

languagePopupListEnabled : bool [since QtQuick.VirtualKeyboard.Styles 2.1]

Cette propriété détermine si une liste déroulante s'affiche lorsque l'on clique sur la touche de langue. Si cette propriété est définie sur « false », cliquer sur la touche de langue permet de faire défiler les langues disponibles une par une.

La valeur par défaut est « false ».

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

modeKeyPanel : Component

Modèle pour la touche du mode générique.

Ce modèle permet de visualiser la touche, dont l'état peut être activé ou désactivé. Il est utilisé lorsque le libellé de la touche reste le même quel que soit son état.

L’état actuel est disponible dans la propriété ` control.mode `.

Remarque : le délégué doit être basé sur le type ` KeyPanel `.

Modèle pour l'élément mis en surbrillance dans la navigation.

Cet élément est utilisé en mode de navigation par touches fléchées pour mettre en évidence l'élément de navigation sélectionné à l'aide du clavier.

L'élément se présente généralement sous la forme d'un rectangle transparent doté d'une bordure à fort contraste.

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

popupListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

Cette propriété définit la transition à appliquer aux éléments ajoutés à la vue de liste contextuelle.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

popupListBackground : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Modèle pour l'arrière-plan de la liste contextuelle.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

popupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Modèle pour l'élément de la liste contextuelle.

Remarque : le délégué est utilisé dans un ListView.

Remarque : le délégué doit être basé sur le type SelectionListItem.

Les propriétés suivantes sont disponibles pour l'élément :

  • display Texte d'affichage de l'élément actuel.
  • wordCompletionLength Longueur de la suggestion de mot mesurée à partir de la fin du texte affiché.
  • dictionary Type de dictionnaire du mot, voir QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Valeur booléenne indiquant si le mot peut être supprimé du dictionnaire.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

popupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Modèle pour la mise en évidence de la liste contextuelle.

Remarque : le délégué est utilisé comme suit : ListView.highlight.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

popupListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 2.1]

Cette propriété définit la transition à appliquer aux éléments supprimés de la vue de liste contextuelle.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

scaleHint : real [read-only]

Indication d'échelle pour le style du clavier. Cette valeur est obtenue en divisant keyboardHeight par keyboardDesignHeight. Toutes les dimensions en pixels doivent être proportionnelles à cette valeur.

selectionHandle : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Cet élément sert à indiquer les limites de la sélection de texte et à permettre de déplacer de manière interactive le début ou la fin de la sélection. Le même élément est utilisé à la fois pour le début et pour la fin de la sélection.

Les poignées de sélection ne sont actuellement prises en charge que pour la méthode d'intégration basée sur l'application.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

selectionListAdd : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

Cette propriété définit la transition à appliquer aux éléments ajoutés à la vue de liste de sélection.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 1.3.

selectionListBackground : Component

Modèle pour l'arrière-plan de la liste de sélection.

selectionListDelegate : Component

Modèle pour l'élément de la liste de sélection.

Remarque : le délégué est utilisé dans un ListView.

Remarque : le délégué doit être basé sur le type SelectionListItem.

Les propriétés suivantes sont disponibles pour l'élément :

  • display Texte d'affichage de l'élément actuel.
  • wordCompletionLength Longueur de la complétion de mot mesurée à partir de la fin du texte d'affichage.
  • dictionary Type de dictionnaire du mot, voir QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Une valeur booléenne indiquant si le mot peut être supprimé du dictionnaire.

selectionListHeight : real

Hauteur de la liste de sélection.

selectionListHighlight : Component

Modèle pour la mise en évidence de la liste de sélection.

Remarque : le délégué est utilisé sous la forme ListView.highlight.

selectionListRemove : Transition [since QtQuick.VirtualKeyboard.Styles 1.3]

Cette propriété définit la transition à appliquer aux éléments supprimés de la vue de liste de sélection.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 1.3.

shiftKeyPanel : Component

Modèle pour la touche Maj.

Remarque : le délégué doit être dérivé du type ` KeyPanel `.

spaceKeyPanel : Component

Modèle pour la touche espace.

Remarque : le délégué doit être basé sur le type KeyPanel.

symbolKeyPanel : Component

Modèle pour la clé du mode symbole.

Remarque : le délégué doit être dérivé du type ` KeyPanel `.

traceCanvasDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Modèle permettant de créer un objet Trace.

Remarque : le délégué doit être basé sur le type ` TraceCanvas `.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

traceInputKeyPanelDelegate : Component [since QtQuick.VirtualKeyboard.Styles 2.1]

Modèle pour la clé d'entrée de trace.

Remarque : le délégué doit être basé sur le type ` TraceInputKeyPanel `.

Cette propriété a été introduite dans QtQuick.VirtualKeyboard.Styles 2.1.

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