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 touches 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 touches alternatives.

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


alternateKeysListHighlight : Component

Modèle pour la surbrillance 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 touches de remplacement.


alternateKeysListLeftMargin : real

Marge gauche du panneau de la liste des clés de remplacement.


alternateKeysListRightMargin : real

Marge droite du panneau de la liste des clés de remplacement.


alternateKeysListTopMargin : real

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


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 de 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 touche et le bas du site characterPreviewDelegate.


enterKeyPanel : Component

Template pour la touche Entrée.

Note : 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 la 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 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é définit le délégué pour 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 faire basculer la visibilité du curseur en fonction de la propriété parent.blinkStatus définie pour le champ de saisie en 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 la zone de saisie 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 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 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 la sélection pour le 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 QtQuick.VirtualKeyboard.Styles 6.2]

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

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


functionPopupListDelegate : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

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

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

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

  • keyboardFunction - Fonction clavier de l'élément courant.

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


functionPopupListHighlight : Component [since QtQuick.VirtualKeyboard.Styles 6.2]

Modèle de liste déroulante de fonctions en surbrillance.

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

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


handwritingKeyPanel : Component

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

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


hideKeyPanel : Component

Modèle pour la touche de masquage.

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


keyPanel : Component

Modèle pour les touches régulières.

Note : 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 du clavier.


keyboardDesignWidth : real

La largeur nominale du clavier.


keyboardHeight : real

La hauteur actuelle du clavier.


keyboardRelativeBottomMargin : real

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


keyboardRelativeLeftMargin : real

La 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

La 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

La 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 touche 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é 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.

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

  • 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 de 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é contient 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 à 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 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.

Note : Le délégué est utilisé dans une page 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 supprimé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 interactivement le début ou la fin de la sélection. Le même élément est utilisé pour le début et 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é 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.

Note : Le délégué est utilisé dans une page 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 retiré du dictionnaire.

selectionListHeight : real

Hauteur de la liste de sélection.


selectionListHighlight : Component

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

Remarque : 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 liste de sélection.

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


shiftKeyPanel : Component

Modèle pour la touche shift.

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


spaceKeyPanel : Component

Modèle pour la touche espace.

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


symbolKeyPanel : Component

Modèle pour la touche mode symbole.

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


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

Modèle pour le 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 touche 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.


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