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

KeyboardStyle QML Type

Fournit une interface de style pour le clavier virtuel. Plus d'informations...

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 InputPanel pour décorer le clavier virtuel.

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

Documentation sur les propriétés

alternateKeysListBackground : Component

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

alternateKeysListBottomMargin : real

Marge inférieure du panneau de 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 page ListView.

alternateKeysListHighlight : Component

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

Note : Le délégué est utilisé comme ListView.highlight.

alternateKeysListItemHeight : real

Hauteur de l'élément de la liste des clés alternatives.

alternateKeysListItemWidth : real

Largeur de l'élément de la liste des clés alternatives.

alternateKeysListLeftMargin : real

Marge gauche du panneau de la liste des touches alternatives.

alternateKeysListRightMargin : real

Marge droite du panneau de la liste des touches alternatives.

alternateKeysListTopMargin : real

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

backspaceKeyPanel : Component

Modèle pour la touche d'effacement arrière.

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

characterPreviewDelegate : Component

Modèle pour la fenêtre contextuelle de prévisualisation des caractères.

Si le délégué contient la propriété text, la propriété 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 clé et le bas du site 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é pour l'arrière-plan de l'entrée 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 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é pour l'arrière-plan du conteneur de saisie 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 plein écran.

Le délégué doit faire basculer la visibilité du curseur en fonction de la propriété parent.blinkStatus définie pour le champ de saisie plein écran. A titre d'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 le site font pour le champ de saisie 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 de l'entrée en 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 masque de mot de passe pour le champ de saisie 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é contient la couleur du texte sélectionné pour le champ de saisie en plein écran.

La couleur par défaut est 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 le 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 déroulante 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 de fonctions.

Remarque : le délégué est utilisé dans un site 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 évidence de la liste déroulante de la fonction.

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

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

handwritingKeyPanel : Component

Modèle pour la touche de mode d'écriture.

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

hideKeyPanel : Component

Modèle pour la clé de dissimulation.

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

keyPanel : Component

Modèle pour les clés ordinaires.

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.

keyboardDesignMaximumHeight : real [since 6.11]

La hauteur maximale du clavier.

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

keyboardDesignWidth : real

La largeur de conception du clavier.

keyboardHeight : real

La hauteur actuelle du clavier.

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 les plus à 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 les plus à 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 le code langue.

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

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

Cette propriété contient la transition à appliquer aux éléments qui sont ajoutés à la vue de la 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 de la liste des langues.

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

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

Les propriétés suivantes sont disponibles pour l'é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.

Note : Le délégué est utilisé comme 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 qui sont supprimés de la 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 contextuelle s'affiche lorsque l'on clique sur le bouton de la langue. Si la valeur de cette propriété est false, un clic sur le code langue fait défiler les langues disponibles une à 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 de mode générique.

Ce modèle fournit une visualisation de la touche dans laquelle l'état peut être activé ou désactivé. Ce modèle est utilisé dans les situations où l'étiquette de la touche reste la même quel que soit l'é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 de mise en évidence de la navigation.

Cet élément est utilisé en mode de navigation par touches fléchées pour mettre en évidence le focus de navigation sur le clavier.

L'élément est typiquement un rectangle transparent avec une bordure très contrastée.

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

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

Cette propriété contient la transition à appliquer aux éléments qui sont ajoutés à la liste déroulante.

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 déroulante.

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 déroulante.

Remarque : le délégué est utilisé dans une application 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 en cours.
  • wordCompletionLength Longueur d'achèvement du mot mesurée à partir de la fin du texte affiché.
  • dictionary Type de dictionnaire du mot, voir QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Un booléen 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 déroulante.

Note : Le délégué est utilisé comme 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é contient la transition à appliquer aux éléments qui sont retirés de la liste déroulante.

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

scaleHint : real [read-only]

L'indice d'échelle du style de clavier. Cette valeur est déterminée en divisant keyboardHeight par keyboardDesignHeight. Toutes les dimensions des pixels doivent être proportionnelles à cette valeur.

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

Cet élément est utilisé pour indiquer où se trouvent les limites de la sélection de texte et pour pouvoir déplacer de manière interactive le début ou la fin de la sélection. Le même élément est utilisé pour la sélection de début et de fin.

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é contient la transition à appliquer aux éléments qui sont ajoutés à la vue de la 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 une application 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 en cours.
  • wordCompletionLength Longueur d'achèvement du mot mesurée à partir de la fin du texte affiché.
  • dictionary Type de dictionnaire du mot, voir QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Un booléen 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.

Note : Le délégué est utilisé comme ListView.highlight.

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

Cette propriété contient la transition à appliquer aux éléments qui sont retirés de la vue de la liste de sélection.

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

shiftKeyPanel : Component

Modèle pour la touche majuscule.

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

spaceKeyPanel : Component

Modèle pour la clé d'espacement.

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

symbolKeyPanel : Component

Modèle pour la touche de mode de symbole.

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

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

Modèle de rendu d'un objet Trace.

Note : 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 la 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.