QDial Class

Description détaillée

QDial est utilisé lorsque l'utilisateur a besoin de contrôler une valeur dans une plage définie par le programme, et que cette plage s'étend (par exemple, avec des angles mesurés de 0 à 359 degrés) ou que la présentation de la boîte de dialogue nécessite un widget carré.

Puisque QDial hérite de QAbstractSlider, le cadran se comporte de la même manière qu'un slider. Lorsque wrapping() est faux (paramètre par défaut), il n'y a pas de réelle différence entre un curseur et un cadran. Ils partagent tous deux les mêmes signaux, les mêmes emplacements et les mêmes fonctions membres. Le choix de l'un ou l'autre dépend des attentes de vos utilisateurs et du type d'application.

Le cadran émet initialement des signaux valueChanged() en continu lorsque le curseur est déplacé ; vous pouvez faire en sorte qu'il émette le signal moins souvent 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é et relâché. Notez que la valeur du cadran peut changer sans que ces signaux soient émis puisque le clavier et la molette peuvent également être utilisés pour modifier la valeur.

Contrairement au curseur, QDial tente de dessiner un "bon" nombre d'encoches plutôt qu'une par pas de ligne. Si possible, le nombre d'encoches dessinées est d'une par pas de ligne, mais s'il n'y a pas assez de pixels pour les dessiner toutes, QDial saute des encoches pour essayer de dessiner un ensemble uniforme (par exemple, en dessinant une encoche sur deux ou sur trois).

Comme le curseur, le cadran met à disposition la fonction QAbstractSlider setValue () en tant qu'emplacement.

L'interface clavier du cadran est assez simple : Les touches fléchées left/up et right/down ajustent la valeur du cadran value en fonction de la valeur définie singleStep, Page Up et Page Down en fonction de la valeur définie pageStep, et les touches Home et End fixent la valeur aux valeurs définies minimum et maximum.

Si vous utilisez la molette de la souris pour régler le cadran, la valeur d'incrémentation est déterminée par la plus petite valeur de wheelScrollLines multipliée par singleStep, et pageStep.