RubyGems - gdk3 - Versions diffs - 1.2.0-x86-mingw32 - Mend

gdk3 1.2.0-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1337) hide show

data/vendor/local/share/gtk-doc/html/gtk3/GtkSocket.html ADDED Viewed

@@ -0,0 +1,360 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GtkSocket</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="PlugSocket.html" title="Cross-process Embedding">
+<link rel="prev" href="GtkPlug.html" title="GtkPlug">
+<link rel="next" href="RecentDocuments.html" title="Recently Used Documents">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="GtkPlug.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="PlugSocket.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="RecentDocuments.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#GtkSocket.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#GtkSocket.description" class="shortcut">Description</a>
+                   |
+                  <a href="#GtkSocket.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#GtkSocket.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
+                   |
+                  <a href="#GtkSocket.signals" class="shortcut">Signals</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="GtkSocket"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="GtkSocket.top_of_page"></a>GtkSocket</span></h2>
+<p>GtkSocket — Container for widgets from other processes</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="GtkSocket.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gtk/gtkx.h&gt;
+struct              <a class="link" href="GtkSocket.html#GtkSocket-struct" title="struct GtkSocket">GtkSocket</a>;
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkSocket.html#gtk-socket-new" title="gtk_socket_new ()">gtk_socket_new</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSocket.html#gtk-socket-add-id" title="gtk_socket_add_id ()">gtk_socket_add_id</a>                   (<em class="parameter"><code><a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_</code></em>,
+                                                         <em class="parameter"><code><span class="type">Window</span> window</code></em>);
+<span class="returnvalue">Window</span>              <a class="link" href="GtkSocket.html#gtk-socket-get-id" title="gtk_socket_get_id ()">gtk_socket_get_id</a>                   (<em class="parameter"><code><a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_</code></em>);
+<a href="../gdk3/gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="GtkSocket.html#gtk-socket-get-plug-window" title="gtk_socket_get_plug_window ()">gtk_socket_get_plug_window</a>          (<em class="parameter"><code><a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkSocket.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  GObject
+   +----GInitiallyUnowned
+         +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+               +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
+                     +----GtkSocket
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkSocket.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
+<p>
+GtkSocket implements
+ AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GtkSocket.signals"></a><h2>Signals</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkSocket.html#GtkSocket-plug-added" title='The "plug-added" signal'>plug-added</a>"                                     : <code class="literal">Run Last</code>
+  "<a class="link" href="GtkSocket.html#GtkSocket-plug-removed" title='The "plug-removed" signal'>plug-removed</a>"                                   : <code class="literal">Run Last</code>
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkSocket.description"></a><h2>Description</h2>
+<p>
+Together with <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a>, <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> provides the ability to embed
+widgets from one process into another process in a fashion that
+is transparent to the user. One process creates a <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> widget
+and passes that widget's window ID to the other process, which then
+creates a <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> with that window ID. Any widgets contained in the
+<a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> then will appear inside the first application's window.
+</p>
+<p>
+The socket's window ID is obtained by using <a class="link" href="GtkSocket.html#gtk-socket-get-id" title="gtk_socket_get_id ()"><code class="function">gtk_socket_get_id()</code></a>.
+Before using this function, the socket must have been realized,
+and for hence, have been added to its parent.
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idm140520311840544"></a><p class="title"><b>Example 107. Obtaining the window ID of a socket.</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">socket </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkSocket.html#gtk-socket-new">gtk_socket_new</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="function"><a href="GtkWidget.html#gtk-widget-show">gtk_widget_show</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">socket</span><span class="symbol">);</span>
+<span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">parent</span><span class="symbol">),</span><span class="normal"> socket</span><span class="symbol">);</span>
+<span class="comment">/* The following call is only necessary if one of</span>
+<span class="comment"> * the ancestors of the socket is not yet visible.</span>
+<span class="comment"> */</span>
+<span class="function"><a href="GtkWidget.html#gtk-widget-realize">gtk_widget_realize</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">socket</span><span class="symbol">);</span>
+<span class="function">g_print</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"The ID of the sockets window is %&lt;GTKDOCLINK HREF="</span><span class="normal">x</span><span class="string">"&gt;x&lt;/GTKDOCLINK&gt;</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span>
+<span class="normal">         </span><span class="function"><a href="GtkSocket.html#gtk-socket-get-id">gtk_socket_get_id</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">socket</span><span class="symbol">));</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+<p>
+Note that if you pass the window ID of the socket to another
+process that will create a plug in the socket, you must make
+sure that the socket widget is not destroyed until that plug
+is created. Violating this rule will cause unpredictable
+consequences, the most likely consequence being that the plug
+will appear as a separate toplevel window. You can check if
+the plug has been created by using <a class="link" href="GtkSocket.html#gtk-socket-get-plug-window" title="gtk_socket_get_plug_window ()"><code class="function">gtk_socket_get_plug_window()</code></a>.
+If it returns a non-<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> value, then the plug has been
+successfully created inside of the socket.
+</p>
+<p>
+When GTK+ is notified that the embedded window has been destroyed,
+then it will destroy the socket as well. You should always,
+therefore, be prepared for your sockets to be destroyed at any
+time when the main event loop is running. To prevent this from
+happening, you can connect to the <a class="link" href="GtkSocket.html#GtkSocket-plug-removed" title='The "plug-removed" signal'><span class="type">"plug-removed"</span></a> signal.
+</p>
+<p>
+The communication between a <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> and a <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> follows the
+<a class="ulink" href="http://www.freedesktop.org/Standards/xembed-spec" target="_top">XEmbed</a>
+protocol. This protocol has also been implemented in other toolkits,
+e.g. <span class="application">Qt</span>, allowing the same level of
+integration when embedding a <span class="application">Qt</span> widget
+in GTK or vice versa.
+</p>
+<p>
+</p>
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Note</h3>
+The <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> and <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> widgets are only available when GTK+
+is compiled for the X11 platform and <a href="../gdk3/gdk3-General.html#GDK-WINDOWING-X11:CAPS"><code class="literal">GDK_WINDOWING_X11</code></a> is defined.
+They can only be used on a <span class="type">GdkX11Display</span>. To use <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> and
+<a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>, you need to include the <code class="filename">gtk/gtkx.h</code>
+header.
+</div>
+<p>
+</p>
+</div>
+<div class="refsect1">
+<a name="GtkSocket.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkSocket-struct"></a><h3>struct GtkSocket</h3>
+<pre class="programlisting">struct GtkSocket;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-socket-new"></a><h3>gtk_socket_new ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_socket_new                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Create a new empty <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the new <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-socket-add-id"></a><h3>gtk_socket_add_id ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_socket_add_id                   (<em class="parameter"><code><a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_</code></em>,
+                                                         <em class="parameter"><code><span class="type">Window</span> window</code></em>);</pre>
+<p>
+Adds an XEMBED client, such as a <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a>, to the <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>.  The
+client may be in the same process or in a different process.
+</p>
+<p>
+To embed a <a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> in a <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>, you can either create the
+<a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a> with <code class="literal">gtk_plug_new (0)</code>, call
+<a class="link" href="GtkPlug.html#gtk-plug-get-id" title="gtk_plug_get_id ()"><code class="function">gtk_plug_get_id()</code></a> to get the window ID of the plug, and then pass that to the
+<a class="link" href="GtkSocket.html#gtk-socket-add-id" title="gtk_socket_add_id ()"><code class="function">gtk_socket_add_id()</code></a>, or you can call <a class="link" href="GtkSocket.html#gtk-socket-get-id" title="gtk_socket_get_id ()"><code class="function">gtk_socket_get_id()</code></a> to get the
+window ID for the socket, and call <a class="link" href="GtkPlug.html#gtk-plug-new" title="gtk_plug_new ()"><code class="function">gtk_plug_new()</code></a> passing in that
+ID.
+</p>
+<p>
+The <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> must have already be added into a toplevel window
+ before you can make this call.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>socket_</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
+<td>the Window of a client participating in the XEMBED protocol.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-socket-get-id"></a><h3>gtk_socket_get_id ()</h3>
+<pre class="programlisting"><span class="returnvalue">Window</span>              gtk_socket_get_id                   (<em class="parameter"><code><a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_</code></em>);</pre>
+<p>
+Gets the window ID of a <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> widget, which can then
+be used to create a client embedded inside the socket, for
+instance with <a class="link" href="GtkPlug.html#gtk-plug-new" title="gtk_plug_new ()"><code class="function">gtk_plug_new()</code></a>.
+</p>
+<p>
+The <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> must have already be added into a toplevel window
+before you can make this call.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>socket_</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the window ID for the socket</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-socket-get-plug-window"></a><h3>gtk_socket_get_plug_window ()</h3>
+<pre class="programlisting"><a href="../gdk3/gdk3-Windows.html#GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gtk_socket_get_plug_window          (<em class="parameter"><code><a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_</code></em>);</pre>
+<p>
+Retrieves the window of the plug. Use this to check if the plug has
+been created inside of the socket.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>socket_</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the window of the plug if available, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.14</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkSocket.signal-details"></a><h2>Signal Details</h2>
+<div class="refsect2">
+<a name="GtkSocket-plug-added"></a><h3>The <code class="literal">"plug-added"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_,
+                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Run Last</code></pre>
+<p>
+This signal is emitted when a client is successfully
+added to the socket.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>socket_</code></em> :</span></p></td>
+<td>the object which received the signal</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSocket-plug-removed"></a><h3>The <code class="literal">"plug-removed"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            user_function                      (<a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> *socket_,
+                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Run Last</code></pre>
+<p>
+This signal is emitted when a client is removed from the socket.
+The default action is to destroy the <a class="link" href="GtkSocket.html" title="GtkSocket"><span class="type">GtkSocket</span></a> widget, so if you
+want to reuse it you must add a signal handler that returns <code class="literal">TRUE</code>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>socket_</code></em> :</span></p></td>
+<td>the object which received the signal</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> to stop other handlers from being invoked.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkSocket.see-also"></a><h2>See Also</h2>
+<a class="link" href="GtkPlug.html" title="GtkPlug"><span class="type">GtkPlug</span></a>, <a class="ulink" href="http://www.freedesktop.org/Standards/xembed-spec" target="_top">XEmbed</a>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkSpinButton.html ADDED Viewed

@@ -0,0 +1,1380 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GtkSpinButton</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="NumericEntry.html" title="Numeric/Text Data Entry">
+<link rel="prev" href="GtkVScale.html" title="GtkVScale">
+<link rel="next" href="GtkSearchEntry.html" title="GtkSearchEntry">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="GtkVScale.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="NumericEntry.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="GtkSearchEntry.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#GtkSpinButton.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#GtkSpinButton.description" class="shortcut">Description</a>
+                   |
+                  <a href="#GtkSpinButton.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#GtkSpinButton.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
+                   |
+                  <a href="#GtkSpinButton.properties" class="shortcut">Properties</a>
+                   |
+                  <a href="#GtkSpinButton.style-properties" class="shortcut">Style Properties</a>
+                   |
+                  <a href="#GtkSpinButton.signals" class="shortcut">Signals</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="GtkSpinButton"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="GtkSpinButton.top_of_page"></a>GtkSpinButton</span></h2>
+<p>GtkSpinButton — Retrieve an integer or floating-point number from
+    the user</p>
+</td>
+<td valign="top" align="right"><img src="spinbutton.png"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="GtkSpinButton.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+struct              <a class="link" href="GtkSpinButton.html#GtkSpinButton-struct" title="struct GtkSpinButton">GtkSpinButton</a>;
+enum                <a class="link" href="GtkSpinButton.html#GtkSpinButtonUpdatePolicy" title="enum GtkSpinButtonUpdatePolicy">GtkSpinButtonUpdatePolicy</a>;
+enum                <a class="link" href="GtkSpinButton.html#GtkSpinType" title="enum GtkSpinType">GtkSpinType</a>;
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-configure" title="gtk_spin_button_configure ()">gtk_spin_button_configure</a>           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> climb_rate</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> digits</code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkSpinButton.html#gtk-spin-button-new" title="gtk_spin_button_new ()">gtk_spin_button_new</a>                 (<em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> climb_rate</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> digits</code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkSpinButton.html#gtk-spin-button-new-with-range" title="gtk_spin_button_new_with_range ()">gtk_spin_button_new_with_range</a>      (<em class="parameter"><code><span class="type">gdouble</span> min</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> max</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> step</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-adjustment" title="gtk_spin_button_set_adjustment ()">gtk_spin_button_set_adjustment</a>      (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);
+<a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-adjustment" title="gtk_spin_button_get_adjustment ()">gtk_spin_button_get_adjustment</a>      (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-digits" title="gtk_spin_button_set_digits ()">gtk_spin_button_set_digits</a>          (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> digits</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-increments" title="gtk_spin_button_set_increments ()">gtk_spin_button_set_increments</a>      (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> step</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> page</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-range" title="gtk_spin_button_set_range ()">gtk_spin_button_set_range</a>           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> min</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> max</code></em>);
+<span class="returnvalue">gint</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-value-as-int" title="gtk_spin_button_get_value_as_int ()">gtk_spin_button_get_value_as_int</a>    (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-value" title="gtk_spin_button_set_value ()">gtk_spin_button_set_value</a>           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-update-policy" title="gtk_spin_button_set_update_policy ()">gtk_spin_button_set_update_policy</a>   (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkSpinButton.html#GtkSpinButtonUpdatePolicy" title="enum GtkSpinButtonUpdatePolicy"><span class="type">GtkSpinButtonUpdatePolicy</span></a> policy</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-numeric" title="gtk_spin_button_set_numeric ()">gtk_spin_button_set_numeric</a>         (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> numeric</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-spin" title="gtk_spin_button_spin ()">gtk_spin_button_spin</a>                (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkSpinButton.html#GtkSpinType" title="enum GtkSpinType"><span class="type">GtkSpinType</span></a> direction</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> increment</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-wrap" title="gtk_spin_button_set_wrap ()">gtk_spin_button_set_wrap</a>            (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> wrap</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-snap-to-ticks" title="gtk_spin_button_set_snap_to_ticks ()">gtk_spin_button_set_snap_to_ticks</a>   (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> snap_to_ticks</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-update" title="gtk_spin_button_update ()">gtk_spin_button_update</a>              (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+<span class="returnvalue">guint</span>               <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-digits" title="gtk_spin_button_get_digits ()">gtk_spin_button_get_digits</a>          (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-increments" title="gtk_spin_button_get_increments ()">gtk_spin_button_get_increments</a>      (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> *step</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> *page</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-numeric" title="gtk_spin_button_get_numeric ()">gtk_spin_button_get_numeric</a>         (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-range" title="gtk_spin_button_get_range ()">gtk_spin_button_get_range</a>           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> *min</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> *max</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-snap-to-ticks" title="gtk_spin_button_get_snap_to_ticks ()">gtk_spin_button_get_snap_to_ticks</a>   (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+<a class="link" href="GtkSpinButton.html#GtkSpinButtonUpdatePolicy" title="enum GtkSpinButtonUpdatePolicy"><span class="returnvalue">GtkSpinButtonUpdatePolicy</span></a> <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-update-policy" title="gtk_spin_button_get_update_policy ()">gtk_spin_button_get_update_policy</a>
+                                                        (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+<span class="returnvalue">gdouble</span>             <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-value" title="gtk_spin_button_get_value ()">gtk_spin_button_get_value</a>           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="GtkSpinButton.html#gtk-spin-button-get-wrap" title="gtk_spin_button_get_wrap ()">gtk_spin_button_get_wrap</a>            (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);
+#define             <a class="link" href="GtkSpinButton.html#GTK-INPUT-ERROR:CAPS" title="GTK_INPUT_ERROR">GTK_INPUT_ERROR</a>
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  GObject
+   +----GInitiallyUnowned
+         +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+               +----<a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a>
+                     +----GtkSpinButton
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
+<p>
+GtkSpinButton implements
+ AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>,  <a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a>,  <a class="link" href="GtkCellEditable.html" title="GtkCellEditable">GtkCellEditable</a> and  <a class="link" href="gtk3-Orientable.html#GtkOrientable">GtkOrientable</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.properties"></a><h2>Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--adjustment" title='The "adjustment" property'>adjustment</a>"               <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--climb-rate" title='The "climb-rate" property'>climb-rate</a>"               <span class="type">gdouble</span>               : Read / Write
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--digits" title='The "digits" property'>digits</a>"                   <span class="type">guint</span>                 : Read / Write
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--numeric" title='The "numeric" property'>numeric</a>"                  <span class="type">gboolean</span>              : Read / Write
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--snap-to-ticks" title='The "snap-to-ticks" property'>snap-to-ticks</a>"            <span class="type">gboolean</span>              : Read / Write
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--update-policy" title='The "update-policy" property'>update-policy</a>"            <a class="link" href="GtkSpinButton.html#GtkSpinButtonUpdatePolicy" title="enum GtkSpinButtonUpdatePolicy"><span class="type">GtkSpinButtonUpdatePolicy</span></a>  : Read / Write
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--value" title='The "value" property'>value</a>"                    <span class="type">gdouble</span>               : Read / Write
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--wrap" title='The "wrap" property'>wrap</a>"                     <span class="type">gboolean</span>              : Read / Write
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.style-properties"></a><h2>Style Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton--s-shadow-type" title='The "shadow-type" style property'>shadow-type</a>"              <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a>         : Read
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.signals"></a><h2>Signals</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton-change-value" title='The "change-value" signal'>change-value</a>"                                   : <code class="literal">Action</code>
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton-input" title='The "input" signal'>input</a>"                                          : <code class="literal">Run Last</code>
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton-output" title='The "output" signal'>output</a>"                                         : <code class="literal">Run Last</code>
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton-value-changed" title='The "value-changed" signal'>value-changed</a>"                                  : <code class="literal">Run Last</code>
+  "<a class="link" href="GtkSpinButton.html#GtkSpinButton-wrapped" title='The "wrapped" signal'>wrapped</a>"                                        : <code class="literal">Run Last</code>
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.description"></a><h2>Description</h2>
+<p>
+A <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> is an ideal way to allow the user to set the value of
+some attribute. Rather than having to directly type a number into a
+<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>, GtkSpinButton allows the user to click on one of two arrows
+to increment or decrement the displayed value. A value can still be
+typed in, with the bonus that it can be checked to ensure it is in a
+given range.
+</p>
+<p>
+The main properties of a GtkSpinButton are through an adjustment.
+See the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> section for more details about an adjustment's
+properties.
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idm140520378901792"></a><p class="title"><b>Example 56. Using a GtkSpinButton to get an integer</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/* Provides a function to retrieve an integer value from a</span>
+<span class="comment"> * GtkSpinButton and creates a spin button to model percentage</span>
+<span class="comment"> * values.</span>
+<span class="comment"> */</span>
+<span class="normal">gint</span>
+<span class="function">grab_int_value</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkSpinButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">button</span><span class="symbol">,</span>
+<span class="normal">                </span><span class="usertype">gpointer</span><span class="normal">       user_data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="GtkSpinButton.html#gtk-spin-button-get-value-as-int">gtk_spin_button_get_value_as_int</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">button</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
+<span class="type">void</span>
+<span class="function">create_integer_spin_button</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">button</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="usertype">GtkAdjustment</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">adjustment</span><span class="symbol">;</span>
+<span class="normal">  adjustment </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkAdjustment.html#gtk-adjustment-new">gtk_adjustment_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">50.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">5.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">);</span>
+<span class="normal">  window </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkWindow.html#gtk-window-new">gtk_window_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gtk3-Standard-Enumerations.html#GTK-WINDOW-TOPLEVEL:CAPS">GTK_WINDOW_TOPLEVEL</a></span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="GtkContainer.html#gtk-container-set-border-width">gtk_container_set_border_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">),</span><span class="normal"> </span><span class="number">5</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="comment">/* creates the spinbutton, with no decimal places */</span>
+<span class="normal">  button </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkSpinButton.html#gtk-spin-button-new">gtk_spin_button_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">adjustment</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">),</span><span class="normal"> button</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="GtkWidget.html#gtk-widget-show-all">gtk_widget_show_all</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idm140520378898928"></a><p class="title"><b>Example 57. Using a GtkSpinButton to get a floating point value</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/* Provides a function to retrieve a floating point value from a</span>
+<span class="comment"> * GtkSpinButton, and creates a high precision spin button.</span>
+<span class="comment"> */</span>
+<span class="normal">gfloat</span>
+<span class="function">grab_float_value</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkSpinButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">button</span><span class="symbol">,</span>
+<span class="normal">                  </span><span class="usertype">gpointer</span><span class="normal">       user_data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="GtkSpinButton.html#gtk-spin-button-get-value">gtk_spin_button_get_value</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">button</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
+<span class="type">void</span>
+<span class="function">create_floating_spin_button</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">button</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="usertype">GtkAdjustment</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">adjustment</span><span class="symbol">;</span>
+<span class="normal">  adjustment </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkAdjustment.html#gtk-adjustment-new">gtk_adjustment_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">2.500</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">5.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.001</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.1</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">);</span>
+<span class="normal">  window </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkWindow.html#gtk-window-new">gtk_window_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gtk3-Standard-Enumerations.html#GTK-WINDOW-TOPLEVEL:CAPS">GTK_WINDOW_TOPLEVEL</a></span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="GtkContainer.html#gtk-container-set-border-width">gtk_container_set_border_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">),</span><span class="normal"> </span><span class="number">5</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="comment">/* creates the spinbutton, with three decimal places */</span>
+<span class="normal">  button </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkSpinButton.html#gtk-spin-button-new">gtk_spin_button_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">adjustment</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.001</span><span class="symbol">,</span><span class="normal"> </span><span class="number">3</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">),</span><span class="normal"> button</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="GtkWidget.html#gtk-widget-show-all">gtk_widget_show_all</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkSpinButton-struct"></a><h3>struct GtkSpinButton</h3>
+<pre class="programlisting">struct GtkSpinButton;</pre>
+<p>
+The <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> struct contains only private data and should
+not be directly modified.
+</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButtonUpdatePolicy"></a><h3>enum GtkSpinButtonUpdatePolicy</h3>
+<pre class="programlisting">typedef enum {
+  GTK_UPDATE_ALWAYS,
+  GTK_UPDATE_IF_VALID
+} GtkSpinButtonUpdatePolicy;
+</pre>
+<p>
+The spin button update policy determines whether the spin button displays
+values even if they are outside the bounds of its adjustment.
+See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-update-policy" title="gtk_spin_button_set_update_policy ()"><code class="function">gtk_spin_button_set_update_policy()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><a name="GTK-UPDATE-ALWAYS:CAPS"></a><span class="term"><code class="literal">GTK_UPDATE_ALWAYS</code></span></p></td>
+<td>When refreshing your <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>, the value is
+    always displayed
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-UPDATE-IF-VALID:CAPS"></a><span class="term"><code class="literal">GTK_UPDATE_IF_VALID</code></span></p></td>
+<td>When refreshing your <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>, the value is
+    only displayed if it is valid within the bounds of the spin button's
+    adjustment
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinType"></a><h3>enum GtkSpinType</h3>
+<pre class="programlisting">typedef enum {
+  GTK_SPIN_STEP_FORWARD,
+  GTK_SPIN_STEP_BACKWARD,
+  GTK_SPIN_PAGE_FORWARD,
+  GTK_SPIN_PAGE_BACKWARD,
+  GTK_SPIN_HOME,
+  GTK_SPIN_END,
+  GTK_SPIN_USER_DEFINED
+} GtkSpinType;
+</pre>
+<p>
+The values of the GtkSpinType enumeration are used to specify the
+change to make in <a class="link" href="GtkSpinButton.html#gtk-spin-button-spin" title="gtk_spin_button_spin ()"><code class="function">gtk_spin_button_spin()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><a name="GTK-SPIN-STEP-FORWARD:CAPS"></a><span class="term"><code class="literal">GTK_SPIN_STEP_FORWARD</code></span></p></td>
+<td>Increment by the adjustments step increment.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-SPIN-STEP-BACKWARD:CAPS"></a><span class="term"><code class="literal">GTK_SPIN_STEP_BACKWARD</code></span></p></td>
+<td>Decrement by the adjustments step increment.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-SPIN-PAGE-FORWARD:CAPS"></a><span class="term"><code class="literal">GTK_SPIN_PAGE_FORWARD</code></span></p></td>
+<td>Increment by the adjustments page increment.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-SPIN-PAGE-BACKWARD:CAPS"></a><span class="term"><code class="literal">GTK_SPIN_PAGE_BACKWARD</code></span></p></td>
+<td>Decrement by the adjustments page increment.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-SPIN-HOME:CAPS"></a><span class="term"><code class="literal">GTK_SPIN_HOME</code></span></p></td>
+<td>Go to the adjustments lower bound.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-SPIN-END:CAPS"></a><span class="term"><code class="literal">GTK_SPIN_END</code></span></p></td>
+<td>Go to the adjustments upper bound.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-SPIN-USER-DEFINED:CAPS"></a><span class="term"><code class="literal">GTK_SPIN_USER_DEFINED</code></span></p></td>
+<td>Change by a specified amount.
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-configure"></a><h3>gtk_spin_button_configure ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_configure           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> climb_rate</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> digits</code></em>);</pre>
+<p>
+Changes the properties of an existing spin button. The adjustment,
+climb rate, and number of decimal places are all changed accordingly,
+after this function call.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>adjustment</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>climb_rate</code></em> :</span></p></td>
+<td>the new climb rate</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>digits</code></em> :</span></p></td>
+<td>the number of decimal places to display in the spin button</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-new"></a><h3>gtk_spin_button_new ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_spin_button_new                 (<em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> climb_rate</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> digits</code></em>);</pre>
+<p>
+Creates a new <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>adjustment</code></em> :</span></p></td>
+<td>the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> object that this spin
+button should use, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>climb_rate</code></em> :</span></p></td>
+<td>specifies how much the spin button changes when an arrow
+is clicked on</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>digits</code></em> :</span></p></td>
+<td>the number of decimal places to display</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>The new spin button as a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-new-with-range"></a><h3>gtk_spin_button_new_with_range ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_spin_button_new_with_range      (<em class="parameter"><code><span class="type">gdouble</span> min</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> max</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> step</code></em>);</pre>
+<p>
+This is a convenience constructor that allows creation of a numeric
+<a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> without manually creating an adjustment. The value is
+initially set to the minimum value and a page increment of 10 * <em class="parameter"><code>step</code></em>
+is the default. The precision of the spin button is equivalent to the
+precision of <em class="parameter"><code>step</code></em>.
+</p>
+<p>
+Note that the way in which the precision is derived works best if <em class="parameter"><code>step</code></em>
+is a power of ten. If the resulting precision is not suitable for your
+needs, use <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-digits" title="gtk_spin_button_set_digits ()"><code class="function">gtk_spin_button_set_digits()</code></a> to correct it.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>min</code></em> :</span></p></td>
+<td>Minimum allowable value</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
+<td>Maximum allowable value</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>step</code></em> :</span></p></td>
+<td>Increment added or subtracted by spinning the widget</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>The new spin button as a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-adjustment"></a><h3>gtk_spin_button_set_adjustment ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_adjustment      (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);</pre>
+<p>
+Replaces the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> associated with <em class="parameter"><code>spin_button</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>adjustment</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> to replace the existing adjustment</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-adjustment"></a><h3>gtk_spin_button_get_adjustment ()</h3>
+<pre class="programlisting"><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *     gtk_spin_button_get_adjustment      (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Get the adjustment associated with a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> of <em class="parameter"><code>spin_button</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-digits"></a><h3>gtk_spin_button_set_digits ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_digits          (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint</span> digits</code></em>);</pre>
+<p>
+Set the precision to be displayed by <em class="parameter"><code>spin_button</code></em>. Up to 20 digit precision
+is allowed.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>digits</code></em> :</span></p></td>
+<td>the number of digits after the decimal point to be displayed for the spin button's value</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-increments"></a><h3>gtk_spin_button_set_increments ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_increments      (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> step</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> page</code></em>);</pre>
+<p>
+Sets the step and page increments for spin_button.  This affects how
+quickly the value changes when the spin button's arrows are activated.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>step</code></em> :</span></p></td>
+<td>increment applied for a button 1 press.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>page</code></em> :</span></p></td>
+<td>increment applied for a button 2 press.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-range"></a><h3>gtk_spin_button_set_range ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_range           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> min</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> max</code></em>);</pre>
+<p>
+Sets the minimum and maximum allowable values for <em class="parameter"><code>spin_button</code></em>.
+</p>
+<p>
+If the current value is outside this range, it will be adjusted
+to fit within the range, otherwise it will remain unchanged.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>min</code></em> :</span></p></td>
+<td>minimum allowable value</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
+<td>maximum allowable value</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-value-as-int"></a><h3>gtk_spin_button_get_value_as_int ()</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_spin_button_get_value_as_int    (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Get the value <em class="parameter"><code>spin_button</code></em> represented as an integer.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the value of <em class="parameter"><code>spin_button</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-value"></a><h3>gtk_spin_button_set_value ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_value           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> value</code></em>);</pre>
+<p>
+Sets the value of <em class="parameter"><code>spin_button</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
+<td>the new value</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-update-policy"></a><h3>gtk_spin_button_set_update_policy ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_update_policy   (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkSpinButton.html#GtkSpinButtonUpdatePolicy" title="enum GtkSpinButtonUpdatePolicy"><span class="type">GtkSpinButtonUpdatePolicy</span></a> policy</code></em>);</pre>
+<p>
+Sets the update behavior of a spin button.
+This determines wether the spin button is always updated
+or only when a valid value is set.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>policy</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html#GtkSpinButtonUpdatePolicy" title="enum GtkSpinButtonUpdatePolicy"><span class="type">GtkSpinButtonUpdatePolicy</span></a> value</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-numeric"></a><h3>gtk_spin_button_set_numeric ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_numeric         (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> numeric</code></em>);</pre>
+<p>
+Sets the flag that determines if non-numeric text can be typed
+into the spin button.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>numeric</code></em> :</span></p></td>
+<td>flag indicating if only numeric entry is allowed</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-spin"></a><h3>gtk_spin_button_spin ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_spin                (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkSpinButton.html#GtkSpinType" title="enum GtkSpinType"><span class="type">GtkSpinType</span></a> direction</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> increment</code></em>);</pre>
+<p>
+Increment or decrement a spin button's value in a specified
+direction by a specified amount.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>direction</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html#GtkSpinType" title="enum GtkSpinType"><span class="type">GtkSpinType</span></a> indicating the direction to spin</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>increment</code></em> :</span></p></td>
+<td>step increment to apply in the specified direction</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-wrap"></a><h3>gtk_spin_button_set_wrap ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_wrap            (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> wrap</code></em>);</pre>
+<p>
+Sets the flag that determines if a spin button value wraps
+around to the opposite limit when the upper or lower limit
+of the range is exceeded.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>wrap</code></em> :</span></p></td>
+<td>a flag indicating if wrapping behavior is performed</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-set-snap-to-ticks"></a><h3>gtk_spin_button_set_snap_to_ticks ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_set_snap_to_ticks   (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> snap_to_ticks</code></em>);</pre>
+<p>
+Sets the policy as to whether values are corrected to the
+nearest step increment when a spin button is activated after
+providing an invalid value.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>snap_to_ticks</code></em> :</span></p></td>
+<td>a flag indicating if invalid values should be corrected</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-update"></a><h3>gtk_spin_button_update ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_update              (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Manually force an update of the spin button.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-digits"></a><h3>gtk_spin_button_get_digits ()</h3>
+<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_spin_button_get_digits          (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Fetches the precision of <em class="parameter"><code>spin_button</code></em>. See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-digits" title="gtk_spin_button_set_digits ()"><code class="function">gtk_spin_button_set_digits()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the current precision</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-increments"></a><h3>gtk_spin_button_get_increments ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_get_increments      (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> *step</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> *page</code></em>);</pre>
+<p>
+Gets the current step and page the increments used by <em class="parameter"><code>spin_button</code></em>. See
+<a class="link" href="GtkSpinButton.html#gtk-spin-button-set-increments" title="gtk_spin_button_set_increments ()"><code class="function">gtk_spin_button_set_increments()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>step</code></em> :</span></p></td>
+<td>location to store step increment, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>page</code></em> :</span></p></td>
+<td>location to store page increment, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-numeric"></a><h3>gtk_spin_button_get_numeric ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_spin_button_get_numeric         (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Returns whether non-numeric text can be typed into the spin button.
+See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-numeric" title="gtk_spin_button_set_numeric ()"><code class="function">gtk_spin_button_set_numeric()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if only numeric text can be entered</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-range"></a><h3>gtk_spin_button_get_range ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_spin_button_get_range           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> *min</code></em>,
+                                                         <em class="parameter"><code><span class="type">gdouble</span> *max</code></em>);</pre>
+<p>
+Gets the range allowed for <em class="parameter"><code>spin_button</code></em>.
+See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-range" title="gtk_spin_button_set_range ()"><code class="function">gtk_spin_button_set_range()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>min</code></em> :</span></p></td>
+<td>location to store minimum allowed value, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
+<td>location to store maximum allowed value, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-snap-to-ticks"></a><h3>gtk_spin_button_get_snap_to_ticks ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_spin_button_get_snap_to_ticks   (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Returns whether the values are corrected to the nearest step.
+See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-snap-to-ticks" title="gtk_spin_button_set_snap_to_ticks ()"><code class="function">gtk_spin_button_set_snap_to_ticks()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if values are snapped to the nearest step</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-update-policy"></a><h3>gtk_spin_button_get_update_policy ()</h3>
+<pre class="programlisting"><a class="link" href="GtkSpinButton.html#GtkSpinButtonUpdatePolicy" title="enum GtkSpinButtonUpdatePolicy"><span class="returnvalue">GtkSpinButtonUpdatePolicy</span></a> gtk_spin_button_get_update_policy
+                                                        (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Gets the update behavior of a spin button.
+See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-update-policy" title="gtk_spin_button_set_update_policy ()"><code class="function">gtk_spin_button_set_update_policy()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the current update policy</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-value"></a><h3>gtk_spin_button_get_value ()</h3>
+<pre class="programlisting"><span class="returnvalue">gdouble</span>             gtk_spin_button_get_value           (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Get the value in the <em class="parameter"><code>spin_button</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the value of <em class="parameter"><code>spin_button</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-spin-button-get-wrap"></a><h3>gtk_spin_button_get_wrap ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_spin_button_get_wrap            (<em class="parameter"><code><a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button</code></em>);</pre>
+<p>
+Returns whether the spin button's value wraps around to the
+opposite limit when the upper or lower limit of the range is
+exceeded. See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-wrap" title="gtk_spin_button_set_wrap ()"><code class="function">gtk_spin_button_set_wrap()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if the spin button wraps around</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GTK-INPUT-ERROR:CAPS"></a><h3>GTK_INPUT_ERROR</h3>
+<pre class="programlisting">#define GTK_INPUT_ERROR -1
+</pre>
+<p>
+Constant to return from a signal handler for the <a class="link" href="GtkSpinButton.html#GtkSpinButton-input" title='The "input" signal'><span class="type">"input"</span></a>
+signal in case of conversion failure.
+</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.property-details"></a><h2>Property Details</h2>
+<div class="refsect2">
+<a name="GtkSpinButton--adjustment"></a><h3>The <code class="literal">"adjustment"</code> property</h3>
+<pre class="programlisting">  "adjustment"               <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>*        : Read / Write</pre>
+<p>The adjustment that holds the value of the spin button.</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton--climb-rate"></a><h3>The <code class="literal">"climb-rate"</code> property</h3>
+<pre class="programlisting">  "climb-rate"               <span class="type">gdouble</span>               : Read / Write</pre>
+<p>The acceleration rate when you hold down a button.</p>
+<p>Allowed values: &gt;= 0</p>
+<p>Default value: 0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton--digits"></a><h3>The <code class="literal">"digits"</code> property</h3>
+<pre class="programlisting">  "digits"                   <span class="type">guint</span>                 : Read / Write</pre>
+<p>The number of decimal places to display.</p>
+<p>Allowed values: &lt;= 20</p>
+<p>Default value: 0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton--numeric"></a><h3>The <code class="literal">"numeric"</code> property</h3>
+<pre class="programlisting">  "numeric"                  <span class="type">gboolean</span>              : Read / Write</pre>
+<p>Whether non-numeric characters should be ignored.</p>
+<p>Default value: FALSE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton--snap-to-ticks"></a><h3>The <code class="literal">"snap-to-ticks"</code> property</h3>
+<pre class="programlisting">  "snap-to-ticks"            <span class="type">gboolean</span>              : Read / Write</pre>
+<p>Whether erroneous values are automatically changed to a spin button's nearest step increment.</p>
+<p>Default value: FALSE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton--update-policy"></a><h3>The <code class="literal">"update-policy"</code> property</h3>
+<pre class="programlisting">  "update-policy"            <a class="link" href="GtkSpinButton.html#GtkSpinButtonUpdatePolicy" title="enum GtkSpinButtonUpdatePolicy"><span class="type">GtkSpinButtonUpdatePolicy</span></a>  : Read / Write</pre>
+<p>Whether the spin button should update always, or only when the value is legal.</p>
+<p>Default value: GTK_UPDATE_ALWAYS</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton--value"></a><h3>The <code class="literal">"value"</code> property</h3>
+<pre class="programlisting">  "value"                    <span class="type">gdouble</span>               : Read / Write</pre>
+<p>Reads the current value, or sets a new value.</p>
+<p>Default value: 0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton--wrap"></a><h3>The <code class="literal">"wrap"</code> property</h3>
+<pre class="programlisting">  "wrap"                     <span class="type">gboolean</span>              : Read / Write</pre>
+<p>Whether a spin button should wrap upon reaching its limits.</p>
+<p>Default value: FALSE</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.style-property-details"></a><h2>Style Property Details</h2>
+<div class="refsect2">
+<a name="GtkSpinButton--s-shadow-type"></a><h3>The <code class="literal">"shadow-type"</code> style property</h3>
+<pre class="programlisting">  "shadow-type"              <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a>         : Read</pre>
+<p>Style of bevel around the spin button.</p>
+<p>Default value: GTK_SHADOW_IN</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.signal-details"></a><h2>Signal Details</h2>
+<div class="refsect2">
+<a name="GtkSpinButton-change-value"></a><h3>The <code class="literal">"change-value"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spinbutton,
+                                                        <a class="link" href="gtk3-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a>  arg1,
+                                                        <span class="type">gpointer</span>       user_data)       : <code class="literal">Action</code></pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton-input"></a><h3>The <code class="literal">"input"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>                user_function                      (<a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button,
+                                                        <span class="type">gpointer</span>       new_value,
+                                                        <span class="type">gpointer</span>       user_data)        : <code class="literal">Run Last</code></pre>
+<p>
+The ::input signal can be used to influence the conversion of
+the users input into a double value. The signal handler is
+expected to use <a class="link" href="GtkEntry.html#gtk-entry-get-text" title="gtk_entry_get_text ()"><code class="function">gtk_entry_get_text()</code></a> to retrieve the text of
+the entry and set <em class="parameter"><code>new_value</code></em> to the new value.
+</p>
+<p>
+The default conversion uses <code class="function">g_strtod()</code>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>the object on which the signal was emitted</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>new_value</code></em> :</span></p></td>
+<td>return location for the new value. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> double]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> for a successful conversion, <code class="literal">FALSE</code> if the input
+was not handled, and <a class="link" href="GtkSpinButton.html#GTK-INPUT-ERROR:CAPS" title="GTK_INPUT_ERROR"><code class="literal">GTK_INPUT_ERROR</code></a> if the conversion failed.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton-output"></a><h3>The <code class="literal">"output"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            user_function                      (<a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spin_button,
+                                                        <span class="type">gpointer</span>       user_data)        : <code class="literal">Run Last</code></pre>
+<p>
+The ::output signal can be used to change to formatting
+of the value that is displayed in the spin buttons entry.
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/* show leading zeros */</span>
+<span class="keyword">static</span><span class="normal"> gboolean</span>
+<span class="function">on_output</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkSpinButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">spin</span><span class="symbol">,</span>
+<span class="normal">           </span><span class="usertype">gpointer</span><span class="normal">       data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">   </span><span class="usertype">GtkAdjustment</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">adjustment</span><span class="symbol">;</span>
+<span class="normal">   </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">text</span><span class="symbol">;</span>
+<span class="normal">   </span><span class="type">int</span><span class="normal"> value</span><span class="symbol">;</span>
+<span class="normal">   adjustment </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkSpinButton.html#gtk-spin-button-get-adjustment">gtk_spin_button_get_adjustment</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">spin</span><span class="symbol">);</span>
+<span class="normal">   value </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="symbol">)</span><span class="function"><a href="GtkAdjustment.html#gtk-adjustment-get-value">gtk_adjustment_get_value</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">adjustment</span><span class="symbol">);</span>
+<span class="normal">   text </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_strdup_printf</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"%02d"</span><span class="symbol">,</span><span class="normal"> value</span><span class="symbol">);</span>
+<span class="normal">   </span><span class="function"><a href="GtkEntry.html#gtk-entry-set-text">gtk_entry_set_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_ENTRY</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">spin</span><span class="symbol">),</span><span class="normal"> text</span><span class="symbol">);</span>
+<span class="normal">   </span><span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">);</span>
+<span class="normal">   </span><span class="keyword">return</span><span class="normal"> TRUE</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spin_button</code></em> :</span></p></td>
+<td>the object which received the signal</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if the value has been displayed</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton-value-changed"></a><h3>The <code class="literal">"value-changed"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spinbutton,
+                                                        <span class="type">gpointer</span>       user_data)       : <code class="literal">Run Last</code></pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkSpinButton-wrapped"></a><h3>The <code class="literal">"wrapped"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a> *spinbutton,
+                                                        <span class="type">gpointer</span>       user_data)       : <code class="literal">Run Last</code></pre>
+<p>
+The wrapped signal is emitted right after the spinbutton wraps
+from its maximum to minimum value or vice-versa.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>spinbutton</code></em> :</span></p></td>
+<td>the object which received the signal</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.10</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkSpinButton.see-also"></a><h2>See Also</h2>
+<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>