Sur cette page

Contrôles de saisie

Qt Quick Les contrôles offrent une variété de contrôles de saisie pour les entrées numériques et textuelles.

ComboBox

Bouton et liste déroulante combinés pour la sélection d'options

Dial

Cadran circulaire que l'on fait tourner pour définir une valeur

DoubleSpinBox

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

RangeSlider

Utilisé pour sélectionner une plage de valeurs en faisant glisser deux poignées le long d'une piste.

SearchField

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

Slider

Permet de sélectionner une valeur en faisant glisser une poignée le long d'une piste

SpinBox

Permet à l'utilisateur de sélectionner une valeur à partir d'un ensemble de valeurs prédéfinies

TextArea

Zone de saisie de texte sur plusieurs lignes

TextField

Zone de saisie de texte sur une seule ligne

Tumbler

Roue tournante d'éléments pouvant être sélectionnés

Chaque type de contrôle d'entrée a son propre cas d'utilisation spécifique. Les sections suivantes donnent des conseils 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 de 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 élevé, envisagez d'appliquer un filtre.
  • Si la liste est très limitée, envisagez d'utiliser 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.

Contrôle par cadran

Commande par cadran pour la sélection des valeurs circulaires

Dial est similaire à un bouton de cadran traditionnel que l'on trouve sur des appareils tels que les chaînes stéréo ou les équipements industriels.

Le cadran est tourné en cliquant et en faisant glisser, la poignée indiquant la valeur du cadran.

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

Pour les applications où une saisie précise est importante, les modes de saisie horizontale et verticale sont recommandés, car ils permettent d'effectuer de petits ajustements par rapport à l'endroit où l'on clique sur le cadran. Ces modes sont également plus appropriés pour les cadrans dont les sauts de valeurs peuvent être dangereux, comme un cadran qui contrôle le volume audio.

Voir aussi Contrôle Tumbler.

Contrôle TextArea

Zone de texte pour la saisie de texte multiligne

TextArea est un éditeur de texte multi-lignes.

Le contrôle TextField

Champ de texte pour la saisie d'une seule ligne de texte

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

Voir aussi le contrôle Tumbler.

Contrôle Slider

Slider est utilisé pour sélectionner une valeur en faisant glisser une poignée le long d'une piste.

Contrôle RangeSlider

RangeSlider est utilisé pour sélectionner une plage spécifiée par deux valeurs, en faisant glisser chaque poignée le long d'une piste.

Voir également la commande Slider.

Contrôle Tumbler

Gobelet affichant une sélection de valeurs par défilement

Tumbler est une roue dans laquelle on peut faire tourner des éléments qui peuvent être sélectionnés.

Voir aussi 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.