QDial Class

Ausführliche Beschreibung

QDial wird verwendet, wenn der Benutzer einen Wert innerhalb eines programmierbaren Bereichs steuern muss und dieser Bereich entweder zyklisch verläuft (beispielsweise bei Winkeln von 0 bis 359 Grad) oder das Dialoglayout ein quadratisches Widget erfordert.

Da QDial von ` QAbstractSlider` erbt, verhält sich das Drehfeld ähnlich wie ein ` slider`. Wenn ` wrapping()` auf `false` gesetzt ist (Standardeinstellung), gibt es keinen wirklichen Unterschied zwischen einem Schieberegler und einem Drehfeld. Beide verfügen über dieselben Signale, Slots und Mitgliedsfunktionen. Welches Sie verwenden, hängt von den Erwartungen Ihrer Benutzer und von der Art der Anwendung ab.

Das Drehfeld sendet zunächst kontinuierlich das Signal „ valueChanged()“, während der Schieberegler bewegt wird; Sie können die Häufigkeit der Signalausgabe verringern, indem Sie die Eigenschaft „ tracking “ deaktivieren. Das Signal „ sliderMoved()“ wird auch dann kontinuierlich ausgesendet, wenn die Nachführung deaktiviert ist.

Das Drehfeld sendet außerdem die Signale „ sliderPressed()“ und „ sliderReleased()“, wenn die Maustaste gedrückt und losgelassen wird. Beachten Sie, dass sich der Wert des Drehfelds ändern kann, ohne dass diese Signale gesendet werden, da der Wert auch über die Tastatur und das Mausrad geändert werden kann.

Im Gegensatz zum Schieberegler versucht QDial, eine „angemessene“ Anzahl von Raststufen zu zeichnen, anstatt nur eine pro Zeilenschritt. Wenn möglich, beträgt die Anzahl der gezeichneten Rastermarkierungen eine pro Zeilenschritt; stehen jedoch nicht genügend Pixel zur Verfügung, um jede einzelne zu zeichnen, überspringt QDial Rastermarkierungen, um zu versuchen, eine gleichmäßige Anordnung zu erzielen (z. B. durch Zeichnen jeder zweiten oder dritten Rastermarkierung).

Wie der Schieberegler stellt auch das Drehfeld die Funktion „ QAbstractSlider “ setValue() als Slot zur Verfügung.

pageStepDie Tastatursteuerung des Drehreglers ist recht einfach: Die Pfeiltasten „ left “ / „up “ und „ right “ / „down “ passen den „ value “ des Drehreglers um die definierten Werte „ singleStep “, „ Page Up “ und „ Page Down “ an, während die Tasten „ Home “ und „ End “ den Wert auf die definierten Werte „ minimum “ und „ maximum “ setzen.

Wenn Sie das Mausrad zur Einstellung des Drehreglers verwenden, wird der Schrittwert durch den kleineren Wert aus wheelScrollLines multipliziert mit singleStep und pageStep bestimmt.