.. -*- coding: utf-8-*- .. _schieberegler: Schieberegler ~~~~~~~~~~~~~ .. class:: gtk.HScale .. class:: gtk.VScale .. currentclass:: gtk.VScale Mit gtk.HScale und gtk.VScale lässt sich über einen Schieberegler ein Wert einstellen. Die beide Klassen sind bis auf das Aussehen identisch: gtk.HScale ist ein horizontaler Regler, gtk.VScale ein vertikaler. .. image:: schieberegler.png :scale: 100 :alt: Schieberegler :align: center .. note:: Um den Schieberegler benutzen zu können, müssen Sie ihm in Glade bei den Eigenschaften eine Stellgröße zuweisen. In den Eigenschaften der Stellgröße können sie den Wertebereich usw. des Schiebereglers einstellen. .. _gtk.hscale-signale: Wichtige Signale ---------------- .. currentclass:: gtk.VScale .. signal:: value-changed Dieses Signal wird ausgelöst, wenn der Wert des Reglers (durch den Benutzer oder durch das Programm) verändert wird. Die Behandlungsroutine sieht so aus: .. function:: callback(self, scale, *args) :noindex: :param scale: die ``gtk.VScale``-Instanz :param args: weitere Parameter, die beim Aufruf von ``connect`` angegeben wurden .. _gtk.hscale-methoden: Wichtige Methoden ----------------- .. method:: set_value(value) :noindex: :param value: neuer Wert Setzt einen neuen Wert für den Schieberegler .. method:: get_value() :noindex: :returns: Wert des Schiebereglers Gibt den momentan eingestellten Wert zurück :signal:`value-changed` Beispiel -------- .. code-block:: python :linenos: def on_btn_save_clicked(self, button, *args): year = self.builder.get_object('scale_rating').get_value() print year def on_btn_clean_clicked(self, button, *args): self.builder.get_object('scale_rating').set_value(0) Hier wird die Methode ``on_btn_save_clicked`` durch das ``clicked``-Signal eines ``Speichern``-:ref:`Knopfs ` namens ``btn_save`` ausgelöst. Über die :class:`gtk.Builder`-Instanz ``self.builder`` wird auf den Schieberegler namens ``scale_rating`` zugegriffen und über dessen Methode :meth:`get_value` der aktuelle Wert abgefragt. Die Methode ``on_btn_clean_clicked`` gehört zu dem ``Leeren``-Knopf ``btn_clean``. Wieder wird über ``self.builder`` auf ``scale_rating`` zugegriffen. Über die Methode ``set_value`` wird die Zahl ``0`` als Wert gesetzt.