New upstream version 3.24.10

This commit is contained in:
Simon McVittie
2019-07-17 09:56:23 +01:00
935 changed files with 651818 additions and 1086686 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="NumericEntry.html" title="Numeric and Text Data Entry">
<link rel="prev" href="GtkScale.html" title="GtkScale">
<link rel="next" href="GtkSearchEntry.html" title="GtkSearchEntry">
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
<meta name="generator" content="GTK-Doc V1.30.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -33,7 +33,7 @@
<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>
the user</p>
</td>
<td class="gallery_image" valign="top" align="right"><img src="spinbutton.png"></td>
</tr></table></div>
@ -420,13 +420,13 @@ to the desired number of characters to display in the entry.</p>
5
6
7</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="normal">spinbutton</span><span class="symbol">.</span><span class="normal">horizontal</span>
<span class="normal">├── undershoot</span><span class="symbol">.</span><span class="normal">left</span>
<span class="normal">├── undershoot</span><span class="symbol">.</span><span class="normal">right</span>
<span class="normal">├── entry</span>
<span class="normal"> ╰── </span><span class="symbol">...</span>
<span class="normal">├── button</span><span class="symbol">.</span><span class="normal">down</span>
<span class="normal">╰── button</span><span class="symbol">.</span><span class="normal">up</span></pre></td>
<td class="listing_code"><pre class="programlisting"><span class="n">spinbutton</span><span class="p">.</span><span class="n">horizontal</span>
<span class="err">├──</span> <span class="n">undershoot</span><span class="p">.</span><span class="n">left</span>
<span class="err">├──</span> <span class="n">undershoot</span><span class="p">.</span><span class="n">right</span>
<span class="err">├──</span> <span class="n">entry</span>
<span class="err"></span> <span class="err">╰──</span> <span class="p">...</span>
<span class="err">├──</span> <span class="n">button</span><span class="p">.</span><span class="n">down</span>
<span class="err">╰──</span> <span class="n">button</span><span class="p">.</span><span class="n">up</span></pre></td>
</tr>
</tbody>
</table>
@ -444,13 +444,13 @@ to the desired number of characters to display in the entry.</p>
5
6
7</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="normal">spinbutton</span><span class="symbol">.</span><span class="normal">vertical</span>
<span class="normal">├── undershoot</span><span class="symbol">.</span><span class="normal">left</span>
<span class="normal">├── undershoot</span><span class="symbol">.</span><span class="normal">right</span>
<span class="normal">├── button</span><span class="symbol">.</span><span class="normal">up</span>
<span class="normal">├── entry</span>
<span class="normal"> ╰── </span><span class="symbol">...</span>
<span class="normal">╰── button</span><span class="symbol">.</span><span class="normal">down</span></pre></td>
<td class="listing_code"><pre class="programlisting"><span class="n">spinbutton</span><span class="p">.</span><span class="n">vertical</span>
<span class="err">├──</span> <span class="n">undershoot</span><span class="p">.</span><span class="n">left</span>
<span class="err">├──</span> <span class="n">undershoot</span><span class="p">.</span><span class="n">right</span>
<span class="err">├──</span> <span class="n">button</span><span class="p">.</span><span class="n">up</span>
<span class="err">├──</span> <span class="n">entry</span>
<span class="err"></span> <span class="err">╰──</span> <span class="p">...</span>
<span class="err">╰──</span> <span class="n">button</span><span class="p">.</span><span class="n">down</span></pre></td>
</tr>
</tbody>
</table>
@ -496,34 +496,34 @@ the .vertical or .horizontal style class on the main node.</p>
26
27
28</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="comment">// Provides a function to retrieve an integer value from a GtkSpinButton</span>
<span class="comment">// and creates a spin button to model percentage values.</span>
<td class="listing_code"><pre class="programlisting"><span class="c1">// Provides a function to retrieve an integer value from a GtkSpinButton</span>
<span class="c1">// and creates a spin button to model percentage values.</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="n">gint</span>
<span class="nf">grab_int_value</span> <span class="p">(</span><span class="n">GtkSpinButton</span> <span class="o">*</span><span class="n">button</span><span class="p">,</span>
<span class="n">gpointer</span> <span class="n">user_data</span><span class="p">)</span>
<span class="p">{</span>
<span class="k">return</span> <span class="n">gtk_spin_button_get_value_as_int</span> <span class="p">(</span><span class="n">button</span><span class="p">);</span>
<span class="p">}</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="kt">void</span>
<span class="nf">create_integer_spin_button</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span>
<span class="p">{</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="n">GtkWidget</span> <span class="o">*</span><span class="n">window</span><span class="p">,</span> <span class="o">*</span><span class="n">button</span><span class="p">;</span>
<span class="n">GtkAdjustment</span> <span class="o">*</span><span class="n">adjustment</span><span class="p">;</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="n">adjustment</span> <span class="o">=</span> <span class="n">gtk_adjustment_new</span> <span class="p">(</span><span class="mf">50.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">100.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">,</span> <span class="mf">5.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">);</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="GtkWindow.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="n">window</span> <span class="o">=</span> <span class="n">gtk_window_new</span> <span class="p">(</span><span class="n">GTK_WINDOW_TOPLEVEL</span><span class="p">);</span>
<span class="n">gtk_container_set_border_width</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">window</span><span class="p">),</span> <span class="mi">5</span><span class="p">);</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="c1">// creates the spinbutton, with no decimal places</span>
<span class="n">button</span> <span class="o">=</span> <span class="n">gtk_spin_button_new</span> <span class="p">(</span><span class="n">adjustment</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span>
<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">window</span><span class="p">),</span> <span class="n">button</span><span class="p">);</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>
<span class="n">gtk_widget_show_all</span> <span class="p">(</span><span class="n">window</span><span class="p">);</span>
<span class="p">}</span></pre></td>
</tr>
</tbody>
</table>
@ -564,33 +564,33 @@ the .vertical or .horizontal style class on the main node.</p>
25
26
27</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>
<td class="listing_code"><pre class="programlisting"><span class="c1">// Provides a function to retrieve a floating point value from a</span>
<span class="c1">// GtkSpinButton, and creates a high precision spin button.</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="n">gfloat</span>
<span class="nf">grab_float_value</span> <span class="p">(</span><span class="n">GtkSpinButton</span> <span class="o">*</span><span class="n">button</span><span class="p">,</span>
<span class="n">gpointer</span> <span class="n">user_data</span><span class="p">)</span>
<span class="p">{</span>
<span class="k">return</span> <span class="n">gtk_spin_button_get_value</span> <span class="p">(</span><span class="n">button</span><span class="p">);</span>
<span class="p">}</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="kt">void</span>
<span class="nf">create_floating_spin_button</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span>
<span class="p">{</span>
<span class="n">GtkWidget</span> <span class="o">*</span><span class="n">window</span><span class="p">,</span> <span class="o">*</span><span class="n">button</span><span class="p">;</span>
<span class="n">GtkAdjustment</span> <span class="o">*</span><span class="n">adjustment</span><span class="p">;</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="n">adjustment</span> <span class="o">=</span> <span class="n">gtk_adjustment_new</span> <span class="p">(</span><span class="mf">2.500</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">5.0</span><span class="p">,</span> <span class="mf">0.001</span><span class="p">,</span> <span class="mf">0.1</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">);</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="GtkWindow.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="n">window</span> <span class="o">=</span> <span class="n">gtk_window_new</span> <span class="p">(</span><span class="n">GTK_WINDOW_TOPLEVEL</span><span class="p">);</span>
<span class="n">gtk_container_set_border_width</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">window</span><span class="p">),</span> <span class="mi">5</span><span class="p">);</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="c1">// creates the spinbutton, with three decimal places</span>
<span class="n">button</span> <span class="o">=</span> <span class="n">gtk_spin_button_new</span> <span class="p">(</span><span class="n">adjustment</span><span class="p">,</span> <span class="mf">0.001</span><span class="p">,</span> <span class="mi">3</span><span class="p">);</span>
<span class="n">gtk_container_add</span> <span class="p">(</span><span class="n">GTK_CONTAINER</span> <span class="p">(</span><span class="n">window</span><span class="p">),</span> <span class="n">button</span><span class="p">);</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>
<span class="n">gtk_widget_show_all</span> <span class="p">(</span><span class="n">window</span><span class="p">);</span>
<span class="p">}</span></pre></td>
</tr>
</tbody>
</table>
@ -1417,7 +1417,7 @@ See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-update-policy"
<td class="enum_member_name"><p><a name="GTK-UPDATE-ALWAYS:CAPS"></a>GTK_UPDATE_ALWAYS</p></td>
<td class="enum_member_description">
<p>When refreshing your <a class="link" href="GtkSpinButton.html" title="GtkSpinButton"><span class="type">GtkSpinButton</span></a>, the value is
always displayed</p>
always displayed</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -1425,8 +1425,8 @@ See <a class="link" href="GtkSpinButton.html#gtk-spin-button-set-update-policy"
<td class="enum_member_name"><p><a name="GTK-UPDATE-IF-VALID:CAPS"></a>GTK_UPDATE_IF_VALID</p></td>
<td class="enum_member_description">
<p>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</p>
only displayed if it is valid within the bounds of the spin button's
adjustment</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -1713,23 +1713,23 @@ of the value that is displayed in the spin buttons entry.</p>
15
16
17</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>
<td class="listing_code"><pre class="programlisting"><span class="c1">// show leading zeros</span>
<span class="k">static</span> <span class="n">gboolean</span>
<span class="nf">on_output</span> <span class="p">(</span><span class="n">GtkSpinButton</span> <span class="o">*</span><span class="n">spin</span><span class="p">,</span>
<span class="n">gpointer</span> <span class="n">data</span><span class="p">)</span>
<span class="p">{</span>
<span class="n">GtkAdjustment</span> <span class="o">*</span><span class="n">adjustment</span><span class="p">;</span>
<span class="n">gchar</span> <span class="o">*</span><span class="n">text</span><span class="p">;</span>
<span class="kt">int</span> <span class="n">value</span><span class="p">;</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="n">adjustment</span> <span class="o">=</span> <span class="n">gtk_spin_button_get_adjustment</span> <span class="p">(</span><span class="n">spin</span><span class="p">);</span>
<span class="n">value</span> <span class="o">=</span> <span class="p">(</span><span class="kt">int</span><span class="p">)</span><span class="n">gtk_adjustment_get_value</span> <span class="p">(</span><span class="n">adjustment</span><span class="p">);</span>
<span class="n">text</span> <span class="o">=</span> <span class="n">g_strdup_printf</span> <span class="p">(</span><span class="s">&quot;%02d&quot;</span><span class="p">,</span> <span class="n">value</span><span class="p">);</span>
<span class="n">gtk_entry_set_text</span> <span class="p">(</span><span class="n">GTK_ENTRY</span> <span class="p">(</span><span class="n">spin</span><span class="p">),</span> <span class="n">text</span><span class="p">);</span>
<span class="n">g_free</span> <span class="p">(</span><span class="n">text</span><span class="p">);</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>
<span class="k">return</span> <span class="n">TRUE</span><span class="p">;</span>
<span class="p">}</span></pre></td>
</tr>
</tbody>
</table>
@ -1837,6 +1837,6 @@ from its maximum to minimum value or vice-versa.</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.29</div>
<hr>Generated by GTK-Doc V1.30.1</div>
</body>
</html>