<refentry id="GtkVScale">
<refmeta>
<refentrytitle>GtkVScale</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkVScale</refname><refpurpose>a vertical slider widget for selecting a value from a range.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gtk/gtk.h&gt;


struct      <link linkend="GtkVScale-struct">GtkVScale</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-vscale-new">gtk_vscale_new</link>                  (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-vscale-new-with-range">gtk_vscale_new_with_range</link>       (<link linkend="gdouble">gdouble</link> min,
                                             <link linkend="gdouble">gdouble</link> max,
                                             <link linkend="gdouble">gdouble</link> step);


</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----<link linkend="GtkObject">GtkObject</link>
         +----<link linkend="GtkWidget">GtkWidget</link>
               +----<link linkend="GtkRange">GtkRange</link>
                     +----<link linkend="GtkScale">GtkScale</link>
                           +----GtkVScale
</synopsis>

</refsect1>




<refsect1>
<title>Description</title>
<para>
The <link linkend="GtkVScale">GtkVScale</link> widget is used to allow the user to select a value using
a vertical slider.
To create one, use <link linkend="gtk-hscale-new-with-range">gtk_hscale_new_with_range</link>().
</para>
<para>
The position to show the current value, and the number of decimal places
shown can be set using the parent <link linkend="GtkScale">GtkScale</link> class's functions.
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GtkVScale-struct">struct GtkVScale</title>
<programlisting>struct GtkVScale;</programlisting>
<para>
The <link linkend="GtkVScale-struct">GtkVScale</link> struct contains private data only, and
should be accessed using the functions below.
</para></refsect2>
<refsect2>
<title><anchor id="gtk-vscale-new">gtk_vscale_new ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_vscale_new                  (<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);</programlisting>
<para>
Creates a new <link linkend="GtkVScale">GtkVScale</link>.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>adjustment</parameter>&nbsp;:</entry>
<entry>the <link linkend="GtkAdjustment">GtkAdjustment</link> which sets the range of the scale.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>a new <link linkend="GtkVScale">GtkVScale</link>.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-vscale-new-with-range">gtk_vscale_new_with_range ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_vscale_new_with_range       (<link linkend="gdouble">gdouble</link> min,
                                             <link linkend="gdouble">gdouble</link> max,
                                             <link linkend="gdouble">gdouble</link> step);</programlisting>
<para>
Creates a new vertical scale widget that lets the user input a
number between <parameter>min</parameter> and <parameter>max</parameter> (including <parameter>min</parameter> and <parameter>max</parameter>) with the
increment <parameter>step</parameter>.  <parameter>step</parameter> must be nonzero; it's the distance the
slider moves when using the arrow keys to adjust the scale value.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>min</parameter>&nbsp;:</entry>
<entry> minimum value
</entry></row>
<row><entry align="right"><parameter>max</parameter>&nbsp;:</entry>
<entry> maximum value
</entry></row>
<row><entry align="right"><parameter>step</parameter>&nbsp;:</entry>
<entry> step increment (tick size) used with keyboard shortcuts
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> a new <link linkend="GtkVScale">GtkVScale</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>




</refentry>
