<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkScaleButton">
<refmeta>
<refentrytitle role="top_of_page" id="GtkScaleButton.top_of_page">GtkScaleButton</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkScaleButton</refname>
<refpurpose>A button which pops up a scale</refpurpose>
</refnamediv>

<refsect1 id="GtkScaleButton.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-scale-button-new">gtk_scale_button_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-scale-button-set-adjustment">gtk_scale_button_set_adjustment</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-scale-button-set-icons">gtk_scale_button_set_icons</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-scale-button-set-value">gtk_scale_button_set_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkAdjustment"><returnvalue>GtkAdjustment</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-scale-button-get-adjustment">gtk_scale_button_get_adjustment</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-scale-button-get-value">gtk_scale_button_get_value</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-scale-button-get-popup">gtk_scale_button_get_popup</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-scale-button-get-plus-button">gtk_scale_button_get_plus_button</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-scale-button-get-minus-button">gtk_scale_button_get_minus_button</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkScaleButton.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkScaleButton--adjustment">adjustment</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GStrv"><type>GStrv</type></link></entry><entry role="property_name"><link linkend="GtkScaleButton--icons">icons</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkScaleButton--value">value</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkScaleButton.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkScaleButton-popdown">popdown</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkScaleButton-popup">popup</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkScaleButton-value-changed">value-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkScaleButton.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkScaleButton-struct">GtkScaleButton</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkScaleButton.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWidget">GtkWidget</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkScaleButton
                <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkVolumeButton">GtkVolumeButton</link>
</screen>
</refsect1>
<refsect1 id="GtkScaleButton.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkScaleButton implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link> and  <link linkend="GtkOrientable">GtkOrientable</link>.</para>

</refsect1>

<refsect1 id="GtkScaleButton.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkScaleButton.description" role="desc">
<title role="desc.title">Description</title>
<para><link linkend="GtkScaleButton"><type>GtkScaleButton</type></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="GtkVolumeButton"><type>GtkVolumeButton</type></link> subclass that
is tailored for this use case.</para>
<refsect2><title>CSS nodes</title><para>GtkScaleButton has a single CSS node with name button. To differentiate
it from a plain <link linkend="GtkButton"><type>GtkButton</type></link>, it gets the .scale style class.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkScaleButton.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-scale-button-new" role="function">
<title>gtk_scale_button_new&#160;()</title>
<indexterm zone="gtk-scale-button-new"><primary>gtk_scale_button_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_scale_button_new (<parameter><link linkend="gdouble"><type>gdouble</type></link> min</parameter>,
                      <parameter><link linkend="gdouble"><type>gdouble</type></link> max</parameter>,
                      <parameter><link linkend="gdouble"><type>gdouble</type></link> step</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> **icons</parameter>);</programlisting>
<para>Creates a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link>, with a range between <parameter>min</parameter>
 and <parameter>max</parameter>
, with
a stepping of <parameter>step</parameter>
.</para>
<refsect3 id="gtk-scale-button-new.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>min</para></entry>
<entry role="parameter_description"><para>the minimum value of the scale (usually 0)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>max</para></entry>
<entry role="parameter_description"><para>the maximum value of the scale (usually 100)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>step</para></entry>
<entry role="parameter_description"><para>the stepping of value when a scroll-wheel event,
or up/down arrow event occurs (usually 2)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icons</para></entry>
<entry role="parameter_description"><para>a <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated
array of icon names, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if you want to set the list
later with <link linkend="gtk-scale-button-set-icons"><function>gtk_scale_button_set_icons()</function></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>][<acronym>array</acronym> zero-terminated=1]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-scale-button-new.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-scale-button-set-adjustment" role="function">
<title>gtk_scale_button_set_adjustment&#160;()</title>
<indexterm zone="gtk-scale-button-set-adjustment"><primary>gtk_scale_button_set_adjustment</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_scale_button_set_adjustment (<parameter><link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button</parameter>,
                                 <parameter><link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> *adjustment</parameter>);</programlisting>
<para>Sets the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> to be used as a model
for the <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link>’s scale.
See <link linkend="gtk-range-set-adjustment"><function>gtk_range_set_adjustment()</function></link> for details.</para>
<refsect3 id="gtk-scale-button-set-adjustment.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>adjustment</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-scale-button-set-icons" role="function">
<title>gtk_scale_button_set_icons&#160;()</title>
<indexterm zone="gtk-scale-button-set-icons"><primary>gtk_scale_button_set_icons</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_scale_button_set_icons (<parameter><link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> **icons</parameter>);</programlisting>
<para>Sets the icons to be used by the scale button.
For details, see the <link linkend="GtkScaleButton--icons"><type>“icons”</type></link> property.</para>
<refsect3 id="gtk-scale-button-set-icons.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icons</para></entry>
<entry role="parameter_description"><para>a <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of icon names. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>array</acronym> zero-terminated=1]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-scale-button-set-value" role="function">
<title>gtk_scale_button_set_value&#160;()</title>
<indexterm zone="gtk-scale-button-set-value"><primary>gtk_scale_button_set_value</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_scale_button_set_value (<parameter><link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button</parameter>,
                            <parameter><link linkend="gdouble"><type>gdouble</type></link> value</parameter>);</programlisting>
<para>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="GtkScaleButton-value-changed"><type>“value-changed”</type></link>
signal if the value changes.</para>
<refsect3 id="gtk-scale-button-set-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>new value of the scale button</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-scale-button-get-adjustment" role="function">
<title>gtk_scale_button_get_adjustment&#160;()</title>
<indexterm zone="gtk-scale-button-get-adjustment"><primary>gtk_scale_button_get_adjustment</primary></indexterm>
<programlisting language="C"><link linkend="GtkAdjustment"><returnvalue>GtkAdjustment</returnvalue></link>&#160;*
gtk_scale_button_get_adjustment (<parameter><link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button</parameter>);</programlisting>
<para>Gets the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> associated with the <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link>’s scale.
See <link linkend="gtk-range-get-adjustment"><function>gtk_range_get_adjustment()</function></link> for details.</para>
<refsect3 id="gtk-scale-button-get-adjustment.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-scale-button-get-adjustment.returns" role="returns">
<title>Returns</title>
<para>the adjustment associated with the scale. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-scale-button-get-value" role="function">
<title>gtk_scale_button_get_value&#160;()</title>
<indexterm zone="gtk-scale-button-get-value"><primary>gtk_scale_button_get_value</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
gtk_scale_button_get_value (<parameter><link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button</parameter>);</programlisting>
<para>Gets the current value of the scale button.</para>
<refsect3 id="gtk-scale-button-get-value.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-scale-button-get-value.returns" role="returns">
<title>Returns</title>
<para> current value of the scale button</para>
</refsect3></refsect2>
<refsect2 id="gtk-scale-button-get-popup" role="function">
<title>gtk_scale_button_get_popup&#160;()</title>
<indexterm zone="gtk-scale-button-get-popup"><primary>gtk_scale_button_get_popup</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_scale_button_get_popup (<parameter><link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button</parameter>);</programlisting>
<para>Retrieves the popup of the <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link>.</para>
<refsect3 id="gtk-scale-button-get-popup.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-scale-button-get-popup.returns" role="returns">
<title>Returns</title>
<para>the popup of the <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-scale-button-get-plus-button" role="function">
<title>gtk_scale_button_get_plus_button&#160;()</title>
<indexterm zone="gtk-scale-button-get-plus-button"><primary>gtk_scale_button_get_plus_button</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_scale_button_get_plus_button (<parameter><link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button</parameter>);</programlisting>
<para>Retrieves the plus button of the <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link>.</para>
<refsect3 id="gtk-scale-button-get-plus-button.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-scale-button-get-plus-button.returns" role="returns">
<title>Returns</title>
<para>the plus button of the <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> as a <link linkend="GtkButton"><type>GtkButton</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>type</acronym> Gtk.Button]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-scale-button-get-minus-button" role="function">
<title>gtk_scale_button_get_minus_button&#160;()</title>
<indexterm zone="gtk-scale-button-get-minus-button"><primary>gtk_scale_button_get_minus_button</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_scale_button_get_minus_button (<parameter><link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button</parameter>);</programlisting>
<para>Retrieves the minus button of the <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link>.</para>
<refsect3 id="gtk-scale-button-get-minus-button.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-scale-button-get-minus-button.returns" role="returns">
<title>Returns</title>
<para>the minus button of the <link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> as a <link linkend="GtkButton"><type>GtkButton</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>type</acronym> Gtk.Button]</emphasis></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkScaleButton.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkScaleButton-struct" role="struct">
<title>struct GtkScaleButton</title>
<indexterm zone="GtkScaleButton-struct"><primary>GtkScaleButton</primary></indexterm>
<programlisting language="C">struct GtkScaleButton;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkScaleButton.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkScaleButton--adjustment" role="property"><title>The <literal>“adjustment”</literal> property</title>
<indexterm zone="GtkScaleButton--adjustment"><primary>GtkScaleButton:adjustment</primary></indexterm>
<programlisting>  “adjustment”               <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>&#160;*</programlisting>
<para>The GtkAdjustment that contains the current value of this scale button object.</para><para>Owner: GtkScaleButton</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkScaleButton--icons" role="property"><title>The <literal>“icons”</literal> property</title>
<indexterm zone="GtkScaleButton--icons"><primary>GtkScaleButton:icons</primary></indexterm>
<programlisting>  “icons”                    <link linkend="GStrv"><type>GStrv</type></link></programlisting>
<para>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.</para>
<para>If there's only one icon name in the <parameter>icons</parameter>
 array, it will
be used for all the values. If only two icon names are in
the <parameter>icons</parameter>
 array, the first one will be used for the bottom
50% of the scale, and the second one for the top 50%.</para>
<para>It is recommended to use at least 3 icons so that the
<link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> reflects the current value of the scale
better for the users.</para>
<para>Owner: GtkScaleButton</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkScaleButton--value" role="property"><title>The <literal>“value”</literal> property</title>
<indexterm zone="GtkScaleButton--value"><primary>GtkScaleButton:value</primary></indexterm>
<programlisting>  “value”                    <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>The value of the scale.</para><para>Owner: GtkScaleButton</para>
<para>Flags: Read / Write</para>
<para>Default value: 0</para>
</refsect2>

</refsect1>
<refsect1 id="GtkScaleButton.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkScaleButton-popdown" role="signal"><title>The <literal>“popdown”</literal> signal</title>
<indexterm zone="GtkScaleButton-popdown"><primary>GtkScaleButton::popdown</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button,
               <link linkend="gpointer"><type>gpointer</type></link>        user_data)</programlisting>
<para>The ::popdown signal is a
<link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted to popdown the scale widget.</para>
<para>The default binding for this signal is Escape.</para>
<refsect3 id="GtkScaleButton-popdown.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkScaleButton-popup" role="signal"><title>The <literal>“popup”</literal> signal</title>
<indexterm zone="GtkScaleButton-popup"><primary>GtkScaleButton::popup</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button,
               <link linkend="gpointer"><type>gpointer</type></link>        user_data)</programlisting>
<para>The ::popup signal is a
<link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted to popup the scale widget.</para>
<para>The default bindings for this signal are Space, Enter and Return.</para>
<refsect3 id="GtkScaleButton-popup.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkScaleButton-value-changed" role="signal"><title>The <literal>“value-changed”</literal> signal</title>
<indexterm zone="GtkScaleButton-value-changed"><primary>GtkScaleButton::value-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkScaleButton"><type>GtkScaleButton</type></link> *button,
               <link linkend="gdouble"><type>gdouble</type></link>         value,
               <link linkend="gpointer"><type>gpointer</type></link>        user_data)</programlisting>
<para>The ::value-changed signal is emitted when the value field has
changed.</para>
<refsect3 id="GtkScaleButton-value-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>button</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>the new value</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2>
</refsect1>

</refentry>
