.. -*- 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 <knopf>`
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.