Sur cette page

Commandes de saisie

Qt Quick Controls propose divers contrôles de saisie pour les données numériques et textuelles.

ComboBox

Combinaison d’un bouton et d’une liste déroulante pour sélectionner des options

Dial

Molette circulaire à faire tourner pour définir une valeur

DoubleSpinBox

Permet à l’utilisateur de choisir parmi un ensemble de valeurs à virgule flottante prédéfinies

RangeSlider

Permet de sélectionner une plage de valeurs en faisant glisser deux curseurs le long d'une piste

SearchField

Champ de saisie spécialisé conçu pour la fonctionnalité de recherche

Slider

Permet de sélectionner une valeur en faisant glisser un curseur le long d'une piste

SpinBox

Permet à l'utilisateur de choisir parmi un ensemble de valeurs prédéfinies

TextArea

Zone de saisie de texte multiligne

TextField

Champ de saisie de texte à une ligne

Tumbler

Molette rotative permettant de sélectionner des éléments

Chaque type de contrôle de saisie a son propre cas d'utilisation spécifique. Les sections suivantes proposent des recommandations pour choisir le type de contrôle de saisie approprié, en fonction du cas d'utilisation.

Contrôle ComboBox

ComboBox est utilisé pour sélectionner une valeur dans une liste déroulante statique à plusieurs lignes. Il n'est pas possible d'ajouter de nouvelles valeurs, et une seule option peut être sélectionnée.

Recommandations :

  • Si le nombre de valeurs est très important, envisagez d'appliquer un filtre.
  • Si la liste est très restreinte, envisagez d'utiliser une liste « RadioButton ». Cela présente l'avantage de permettre à l'utilisateur de voir toutes les options en même temps.
  • Sélectionnez une valeur par défaut, c'est-à-dire la valeur qui sera choisie le plus souvent.

Voir également: Contrôle CheckBox, Contrôle Tumbler.

Le contrôle « Dial »

Commande à cadran pour la sélection de valeurs circulaires

Dial est similaire à un bouton rotatif traditionnel que l'on trouve sur des appareils tels que les chaînes hi-fi ou les équipements industriels.

On fait tourner le cadran en cliquant et en faisant glisser, la poignée indiquant la valeur du cadran.

Pour les applications où la rapidité de saisie est importante, l’ input mode circulaire est utile, car un clic sur le cadran le déplace directement à cette position.

Pour les applications où la précision de la saisie est importante, les modes de saisie horizontaux et verticaux sont recommandés, car ils permettent d’effectuer de légers ajustements par rapport à l’endroit où l’on clique sur le cadran. Ces modes sont également préférables pour les cadrans où des sauts de valeur importants pourraient présenter un risque, comme un cadran de contrôle du volume audio.

Voir également le contrôle « Tumbler ».

Contrôle TextArea

Zone de texte permettant la saisie de texte sur plusieurs lignes

TextArea est un éditeur de texte multiligne.

Contrôle TextField

Champ de saisie permettant de saisir du texte sur une seule ligne

TextField est un éditeur de texte à une seule ligne.

Voir également le contrôle Tumbler.

Le contrôle Slider

Slider sert à sélectionner une valeur en faisant glisser un curseur le long d'une piste.

Contrôle RangeSlider

RangeSlider permet de sélectionner une plage définie par deux valeurs, en faisant glisser chaque curseur le long d'une piste.

Voir également « Contrôle Slider ».

Contrôle « Tumbler »

Curseur permettant de faire défiler les valeurs

Tumbler est une molette rotative permettant de sélectionner des éléments.

Voir également Contrôle ComboBox.

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