QDial Class

Description détaillée

QDial est utilisé lorsque l'utilisateur doit contrôler une valeur dans une plage définissable par le programme, et que cette plage est cyclique (par exemple, pour des angles mesurés de 0 à 359 degrés) ou que la mise en page de la boîte de dialogue nécessite un widget carré.

Comme QDial hérite de ` QAbstractSlider`, le cadran se comporte de manière similaire à un ` slider`. Lorsque ` wrapping()` est à `false` (valeur par défaut), il n’y a pas de différence réelle entre un curseur et un cadran. Ils partagent tous deux les mêmes signaux, slots et fonctions membres. Le choix entre les deux dépend des attentes de vos utilisateurs et du type d’application.

Le cadran émet initialement le signal ` valueChanged()` en continu pendant que le curseur est déplacé ; vous pouvez réduire la fréquence d’émission de ce signal en désactivant la propriété ` tracking `. Le signal ` sliderMoved()` est émis en continu même lorsque le suivi est désactivé.

Le cadran émet également les signaux ` sliderPressed()` et ` sliderReleased()` lorsque le bouton de la souris est enfoncé puis relâché. Notez que la valeur du cadran peut changer sans que ces signaux soient émis, car le clavier et la molette peuvent également être utilisés pour modifier cette valeur.

Contrairement au curseur, QDial tente de dessiner un nombre « harmonieux » de crans plutôt qu'un par pas de ligne. Si possible, le nombre de crans dessinés est de un par pas de ligne, mais s’il n’y a pas assez de pixels pour tous les dessiner, QDial sautera des crans pour essayer de dessiner un ensemble uniforme (par exemple en dessinant un cran sur deux ou sur trois).

Tout comme le curseur, le cadran met à disposition la fonction QAbstractSlider setValue () en tant que slot.

L’interface clavier du cadran est assez simple : les touches fléchées left/up et right/down ajustent l’ value du cadran selon les valeurs définies singleStep, Page Up et Page Down selon les valeurs définies pageStep, tandis que les touches Home et End règlent la valeur sur les valeurs définies minimum et maximum.

Si vous utilisez la molette de la souris pour régler le cadran, la valeur d’incrément est déterminée par la plus petite des valeurs suivantes : wheelScrollLines multipliée par singleStep et pageStep.