<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gtkscalebutton">
    <refnamediv>
        <refname>gtk.ScaleButton</refname>
        <refpurpose>A button which pops up a scale. (new in PyGTK 2.12)</refpurpose>
    </refnamediv>

    <refsect1>
        <title>Synopsis</title>

    <classsynopsis language="python">
        <ooclass><classname>gtk.ScaleButton</classname></ooclass>
        <ooclass><classname><link linkend="class-gtkbutton">gtk.Button</link></classname></ooclass>
    <constructorsynopsis language="python">
        <methodname><link linkend="constructor-gtkscalebutton">gtk.ScaleButton</link></methodname>
        <methodparam><parameter role="keyword">size</parameter></methodparam>
        <methodparam><parameter role="keyword">min</parameter></methodparam>
        <methodparam><parameter role="keyword">max</parameter></methodparam>
        <methodparam><parameter role="keyword">step</parameter></methodparam>
        <methodparam><parameter role="keyword">icons</parameter><initializer>None</initializer></methodparam>
    </constructorsynopsis>
    
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--get-adjustment">get_adjustment</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--get-minus-button">get_minus_button</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--get-orientation">get_orientation</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--get-plus-button">get_plus_button</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--get-popup">get_popup</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--get-value">get_value</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--set-adjustment">set_adjustment</link></methodname>
        <methodparam><parameter role="keyword">adjustment</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--set-icons">set_icons</link></methodname>
        <methodparam><parameter role="keyword">icons</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--set-orientation">set_orientation</link></methodname>
        <methodparam><parameter role="keyword">icons</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtkscalebutton--set-value">set_value</link></methodname>
        <methodparam><parameter role="keyword">value</parameter></methodparam>
    </methodsynopsis>

    </classsynopsis>
    </refsect1>

    <refsect1>
        <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-gtkobject">gtk.Object</link>
    +-- <link linkend="class-gtkwidget">gtk.Widget</link>
      +-- <link linkend="class-gtkcontainer">gtk.Container</link>
        +-- <link linkend="class-gtkbin">gtk.Bin</link>
          +-- <link linkend="class-gtkbutton">gtk.Button</link>
            +-- <link linkend="class-gtkbutton">gtk.ScaleButton</link>
</synopsis>

    </refsect1>
    
    <refsect1>
		<title>Implemented Interfaces</title>
		<para>
			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>
			implements 
			<link linkend="class-gtkbuildable"><classname>gtk.Buildable</classname></link>
		</para>
	</refsect1>


    <refsect1 id="properties-gtkscalebutton">
        <title>gtk.ScaleButton Properties</title>
    
        <para><link linkend="properties-gtkobject">gtk.Object Properties</link></para>
        <para><link linkend="properties-gtkwidget">gtk.Widget Properties</link></para>
        <para><link linkend="properties-gtkcontainer">gtk.Container Properties</link></para>
        <para><link linkend="properties-gtkbutton">gtk.Button Properties</link></para>

        <blockquote role="properties">
            <informaltable pgwide="1" frame="none">
                <tgroup cols="3">
                    <colspec column="1" colwidth="1in"/>
                    <colspec column="2" colwidth="1in"/>
                    <colspec column="3" colwidth="3.5in"/>
                    <tbody>
                        <row valign="top">
                            <entry>"adjustment"</entry>
                            <entry>Read/Write</entry>
                            <entry>
                                The <link linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
                                that contains the current value of this scale button object.
                            </entry>
                        </row>

                        <row valign="top">
                            <entry>"icons"</entry>
                            <entry>Read/Write</entry>
                            <entry>
                                The names of the icons to be used by the scale button. The first item in the array
                                will be used in the button when the current value is the lowest value, the second
                                item for the highest value. All the subsequent icons will be used for all the other
                                values, spread evenly over the range of values. If there's only one icon name in the
                                icons array, it will be used for all the values. If only two icon names are in the
                                icons array, the first one will be used for the bottom 50% of the scale, and the
                                second one for the top 50%.
                                It is recommended to use at least 3 icons so that the GtkScaleButton reflects the
                                current value of the scale better for the users.
                            </entry>
                        </row>

                        <row valign="top">
                            <entry>"orientation"</entry>
                            <entry>Read/Write</entry>
                            <entry>
                                The orientation of the
				<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
				popup window. Default value: gtk.ORIENTATION_VERTICAL.
				Available from GTK+ 2.14.
                            </entry>
                        </row>

                        <row valign="top">
                            <entry>"size"</entry>
                            <entry>Read/Write</entry>
                            <entry>
                                The icon size. Default value: gtk.ICON_SIZE_SMALL_TOOLBAR.
                            </entry>
                        </row>

                        <row valign="top">
                            <entry>"value"</entry>
                            <entry>Read/Write</entry>
                            <entry>
                                The value of the scale. Default value: 0.
                            </entry>
                        </row>
                    </tbody>
                </tgroup>
            </informaltable>
        </blockquote>
    </refsect1>

    <refsect1 id="style-properties-gtkscalebutton">
        <title>gtk.ScaleButton Style Properties</title>

        <para><link linkend="style-properties-gtkwidget">gtk.Widget Style Properties</link></para>
        <para><link linkend="style-properties-gtkbutton">gtk.Button Style Properties</link></para>

    </refsect1>
    
    <refsect1 id="signal-prototypes-gtkscalebutton">
        <title>gtk.ScaleButton Signal Prototypes</title>

        <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para>
        <para><link linkend="signal-prototypes-gtkobject">gtk.Object Signal Prototypes</link></para>
        <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para>
        <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para>
        <para><link linkend="signal-prototypes-gtkbutton">gtk.Button Signal Prototypes</link></para>

        <variablelist>
            <varlistentry>
                <term>"<link linkend="signal-gtkscalebutton--popdown">popdown</link>"</term>
                <listitem>
                    <methodsynopsis language="python"><methodname>callback</methodname>
                        <methodparam><parameter>scalebutton</parameter></methodparam>
                        <methodparam><parameter>user_param1</parameter></methodparam>
                        <methodparam><parameter>...</parameter></methodparam>
                    </methodsynopsis>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>"<link linkend="signal-gtkscalebutton--popdown">popup</link>"</term>
                <listitem>
                    <methodsynopsis language="python"><methodname>callback</methodname>
                        <methodparam><parameter>scalebutton</parameter></methodparam>
                        <methodparam><parameter>user_param1</parameter></methodparam>
                        <methodparam><parameter>...</parameter></methodparam>
                    </methodsynopsis>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>"<link linkend="signal-gtkscalebutton--popdown">value-changed</link>"</term>
                <listitem>
                    <methodsynopsis language="python"><methodname>callback</methodname>
                        <methodparam><parameter>scalebutton</parameter></methodparam>
                        <methodparam><parameter>value</parameter></methodparam>
                        <methodparam><parameter>user_param1</parameter></methodparam>
                        <methodparam><parameter>...</parameter></methodparam>
                    </methodsynopsis>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsect1>

    <refsect1>
        <title>Description</title>
            <para>
                <link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>
                provides a button which pops up a scale widget. This kind of widget is commonly
                used for volume controls in multimedia applications, and GTK+ provides a
                <link linkend="class-gtkvolumebutton"><classname>gtk.VolumeButton</classname></link>
                subclass that is tailored for this use case.
            </para>
    </refsect1>

    <refsect1 id="constructor-gtkscalebutton">
        <title>Constructor</title>

        <programlisting><constructorsynopsis language="python">
            <methodname>gtk.ScaleButton</methodname>
            <methodparam><parameter role="keyword">size</parameter></methodparam>
            <methodparam><parameter role="keyword">min</parameter></methodparam>
            <methodparam><parameter role="keyword">max</parameter></methodparam>
            <methodparam><parameter role="keyword">step</parameter></methodparam>
            <methodparam><parameter role="keyword">icons</parameter><initializer>None</initializer></methodparam>
        </constructorsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">size</parameter>&nbsp;:</term>
                <listitem><simpara>A stock icon size.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">min</parameter>&nbsp;:</term>
                <listitem><simpara>The minimum value of the scale (usually 0).</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">max</parameter>&nbsp;:</term>
                <listitem><simpara>The maximum value of the scale (usually 100).</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">step</parameter>&nbsp;:</term>
                <listitem><simpara>The stepping of value when a scroll-wheel event, or
                up/down arrow event occurs (usually 2).</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">icons</parameter>&nbsp;:</term>
                <listitem><simpara>Optionally a list or tuple of icon names, you will be able to set the
                list later with <methodname><link linkend="method-gtkscalebutton--set-icons">set_icons</link></methodname>
                </simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>a new
                <link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>
                object.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This constructor is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Creates a <link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>,
            with a range between <parameter>min</parameter> and <parameter>max</parameter>,
            with a stepping of <parameter>step</parameter>.
        </para>
    </refsect1>

    <refsect1>
        <title>Methods</title>

        <refsect2 id="method-gtkscalebutton--get-adjustment">
            <title>gtk.ScaleButton.get_adjustment</title>

            <programlisting><methodsynopsis language="python">
                <methodname>get_adjustment</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                        <listitem><simpara>The
                        <link linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
                        associated with the scale.</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.12 and above.</para>
            </note>

            <para>
                The <methodname>get_adjustment</methodname>() method gets the
                <link linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
                associated with the
                <link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
                scale. See
                <methodname><link linkend="method-gtkrange--get-adjustment">gtk.Range.get_adjustment</link></methodname>
                for details.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--get-minus-button">
            <title>gtk.ScaleButton.get_minus_button</title>

            <programlisting><methodsynopsis language="python">
                <methodname>get_minus_button</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                        <listitem><simpara>the minus button of the
			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
			</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.14 and above.</para>
            </note>

            <para>
                The <methodname>get_minus_button</methodname>() method
		retrieves the minus button of the
		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--get-orientation">
            <title>gtk.ScaleButton.get_orientation</title>

            <programlisting><methodsynopsis language="python">
                <methodname>get_orientation</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                        <listitem><simpara>the
			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
			orientation.
			</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.14 and above.</para>
            </note>

            <para>
                The <methodname>get_orientation</methodname>() method
		gets the orientation of the
		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
		popup window.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--get-plus-button">
            <title>gtk.ScaleButton.get_plus_button</title>

            <programlisting><methodsynopsis language="python">
                <methodname>get_plus_button</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                        <listitem><simpara>the plus button of the
			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
			</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.14 and above.</para>
            </note>

            <para>
                The <methodname>get_plus_button</methodname>() method
		retrieves the plus button of the
		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--get-popup">
            <title>gtk.ScaleButton.get_popup</title>

            <programlisting><methodsynopsis language="python">
                <methodname>get_popup</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                        <listitem><simpara>the popup of the
			<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
			</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.14 and above.</para>
            </note>

            <para>
                The <methodname>get_popup</methodname>() method
		gets the popup of the
		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--get-value">
            <title>gtk.ScaleButton.get_value</title>

            <programlisting><methodsynopsis language="python">
                <methodname>get_value</methodname>
                <methodparam></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><emphasis>Returns</emphasis>&nbsp;:</term>
                        <listitem><simpara>The current value of the scale button.</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.12 and above.</para>
            </note>

            <para>
                The <methodname>get_value</methodname>() method gets the current value of the scale button.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--set-adjustment">
            <title>gtk.ScaleButton.set_adjustment</title>

            <programlisting><methodsynopsis language="python">
                <methodname>set_adjustment</methodname>
                <methodparam><parameter>adjustment</parameter></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><parameter role="keyword">adjustment</parameter>&nbsp;:</term>
                        <listitem><simpara>The
                        <link linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
                        to set.</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.12 and above.</para>
            </note>

            <para>
                The <methodname>set_adjustment</methodname>() method sets the
                <link linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
                to be used as a model for the
                <link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
                scale. See
                <methodname><link linkend="method-gtkrange--set-adjustment">gtk.Range.set_adjustment</link></methodname>
                for details.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--set-icons">
            <title>gtk.ScaleButton.set_icons</title>

            <programlisting><methodsynopsis language="python">
                <methodname>set_icons</methodname>
                <methodparam><parameter>icons</parameter></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><parameter role="keyword">icons</parameter>&nbsp;:</term>
                        <listitem><simpara>A list or tuple of icon names.</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.12 and above.</para>
            </note>

            <para>
                The <methodname>set_icons</methodname>() method sets the icons to be used by the
                scale button. For details, see the <link linkend="properties-gtkbutton">gtk.ScaleButton:icons property</link>
                for details.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--set-orientation">
            <title>gtk.ScaleButton.set_orientation</title>

            <programlisting><methodsynopsis language="python">
                <methodname>set_orientation</methodname>
                <methodparam><parameter>icons</parameter></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><parameter role="keyword">orientation</parameter>&nbsp;:</term>
                        <listitem><simpara>the new orientation.</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.14 and above.</para>
            </note>

            <para>
                The <methodname>set_orientation</methodname>() method sets the
		orientation of the
		<link linkend="class-gtkscalebutton"><classname>gtk.ScaleButton</classname></link>'s
		popup window.
            </para>
        </refsect2>

        <refsect2 id="method-gtkscalebutton--set-value">
            <title>gtk.ScaleButton.set_value</title>

            <programlisting><methodsynopsis language="python">
                <methodname>set_value</methodname>
                <methodparam><parameter>value</parameter></methodparam>
            </methodsynopsis></programlisting>
            
            <variablelist>
                <varlistentry>
                    <term><parameter role="keyword">value</parameter>&nbsp;:</term>
                        <listitem><simpara>The new value of the scale button.</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This method is available in PyGTK 2.12 and above.</para>
            </note>

            <para>
                The <methodname>set_value</methodname>() method sets the current value of the scale;
                if the value is outside the minimum or maximum range values, it will be
                clamped to fit inside them. The scale button emits the
                <link linkend="signal-gtkscalebutton--popdown">value-changed</link> signal if the value changes.
            </para>
        </refsect2>
    </refsect1>
    
    <refsect1>
        <title>Signals</title>

        <refsect2 id="signal-gtkscalebutton--popdown">
            <title>The "popdown" gtk.ScaleButton Signal</title>

            <programlisting><methodsynopsis language="python">
                <methodname>callback</methodname>
                    <methodparam><parameter>scalebutton</parameter></methodparam>
                    <methodparam><parameter>user_param1</parameter></methodparam>
                    <methodparam><parameter>...</parameter></methodparam>
                </methodsynopsis></programlisting>

            <variablelist>
                <varlistentry>
                    <term><parameter>scalebutton</parameter>&nbsp;:</term>
                    <listitem><simpara>the scalebutton that received the "popdown" signal</simpara></listitem>
                </varlistentry>
                <varlistentry>
                    <term><parameter>user_param1</parameter>&nbsp;:</term>
                    <listitem><simpara>the first user parameter (if any) specified
                    with the <link linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
                    method</simpara></listitem>
                </varlistentry>
                <varlistentry>
                    <term><parameter>...</parameter>&nbsp;:</term>
                    <listitem><simpara>additional user parameters (if
                    any)</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This signal is available in PyGTK 2.12 and above.</para>
            </note>

            <para>
                The "popdown" signal is a keybinding signal which gets emitted to popdown the scale widget.
                The default binding for this signal is Escape.
            </para>
        </refsect2>

        <refsect2 id="signal-gtkscalebutton--popup">
            <title>The "popup" gtk.ScaleButton Signal</title>

            <programlisting><methodsynopsis language="python">
                <methodname>callback</methodname>
                    <methodparam><parameter>scalebutton</parameter></methodparam>
                    <methodparam><parameter>user_param1</parameter></methodparam>
                    <methodparam><parameter>...</parameter></methodparam>
                </methodsynopsis></programlisting>

            <variablelist>
                <varlistentry>
                    <term><parameter>scalebutton</parameter>&nbsp;:</term>
                    <listitem><simpara>the scalebutton that received the "popup" signal</simpara></listitem>
                </varlistentry>
                <varlistentry>
                    <term><parameter>user_param1</parameter>&nbsp;:</term>
                    <listitem><simpara>the first user parameter (if any) specified
                    with the <link linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
                    method</simpara></listitem>
                </varlistentry>
                <varlistentry>
                    <term><parameter>...</parameter>&nbsp;:</term>
                    <listitem><simpara>additional user parameters (if
                    any)</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This signal is available in PyGTK 2.12 and above.</para>
            </note>

            <para>
                The "popup" signal is a keybinding signal which gets emitted to popup the scale widget.
                The default bindings for this signal are Space, Enter and Return.
            </para>
        </refsect2>

        <refsect2 id="signal-gtkscalebutton--value-changed">
            <title>The "value-changed" gtk.ScaleButton Signal</title>

            <programlisting><methodsynopsis language="python">
                <methodname>callback</methodname>
                    <methodparam><parameter>scalebutton</parameter></methodparam>
                    <methodparam><parameter>value</parameter></methodparam>
                    <methodparam><parameter>user_param1</parameter></methodparam>
                    <methodparam><parameter>...</parameter></methodparam>
                </methodsynopsis></programlisting>

            <variablelist>
                <varlistentry>
                    <term><parameter>scalebutton</parameter>&nbsp;:</term>
                    <listitem><simpara>the scalebutton that received the "value-changed" signal</simpara></listitem>
                </varlistentry>
                <varlistentry>
                    <term><parameter>value</parameter>&nbsp;:</term>
                    <listitem><simpara>the new value</simpara></listitem>
                </varlistentry>
                <varlistentry>
                    <term><parameter>user_param1</parameter>&nbsp;:</term>
                    <listitem><simpara>the first user parameter (if any) specified
                    with the <link linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
                    method</simpara></listitem>
                </varlistentry>
                <varlistentry>
                    <term><parameter>...</parameter>&nbsp;:</term>
                    <listitem><simpara>additional user parameters (if
                    any)</simpara></listitem>
                </varlistentry>
            </variablelist>

            <note>
                <para>This signal is available in PyGTK 2.12 and above.</para>
            </note>

            <para>
                The "value-changed" signal is emitted when the value field has changed.
            </para>
        </refsect2>
    </refsect1>
</refentry>
