Imported Upstream version 2.2.14

This commit is contained in:
Ari Pollak
2010-08-11 01:17:12 -04:00
parent 70ad8213cf
commit a2f097051e
490 changed files with 35329 additions and 58398 deletions

View File

@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GimpSizeEntry</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
<link rel="up" href="libgimpwidgets-utils.html" title="Part&#160;V.&#160;GIMP Widgets Utilities">
<link rel="prev" href="libgimpwidgets-GimpQueryBox.html" title="GimpQueryBox">
<link rel="next" href="libgimpwidgets-GimpStock.html" title="GimpStock">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="libgimpwidgets-widgets.html" title="Part&#160;I.&#160;GIMP Widgets">
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
@ -28,25 +28,29 @@
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
<td><a accesskey="n" href="libgimpwidgets-GimpStock.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2569228" class="shortcut">Top</a>
&#160;|&#160;
<a href="#desc" class="shortcut">Description</a>
<a href="#id2628276" class="shortcut">Description</a>
&#160;|&#160;
<a href="#object_hierarchy" class="shortcut">Object Hierarchy</a>
<a href="#id2628106" class="shortcut">Object Hierarchy</a>
&#160;|&#160;
<a href="#signal_proto" class="shortcut">Signals</a></nobr></td></tr>
<a href="#id2628160" class="shortcut">Implemented Interfaces</a>
&#160;|&#160;
<a href="#id2628182" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GimpSizeEntry"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="top_of_page"></a>GimpSizeEntry</span></h2>
<h2>
<a name="id2569228"></a><span class="refentrytitle">GimpSizeEntry</span>
</h2>
<p>GimpSizeEntry &#8212; Widget for entering pixel values and resolutions.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="synopsis"></a><h2>Synopsis</h2>
<h2>Synopsis</h2>
<pre class="synopsis">
@ -121,7 +125,7 @@ GtkWidget* <a href="GimpSizeEntry.html#gimp-size-entry-get-help-widget">gimp_si
</pre>
</div>
<div class="refsect1" lang="en">
<a name="object_hierarchy"></a><h2>Object Hierarchy</h2>
<a name="id2628106"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
GObject
@ -134,13 +138,13 @@ GtkWidget* <a href="GimpSizeEntry.html#gimp-size-entry-get-help-widget">gimp_si
</pre>
</div>
<div class="refsect1" lang="en">
<a name="impl_interfaces"></a><h2>Implemented Interfaces</h2>
<a name="id2628160"></a><h2>Implemented Interfaces</h2>
<p>
GimpSizeEntry implements
AtkImplementorIface.</p>
</div>
<div class="refsect1" lang="en">
<a name="signal_proto"></a><h2>Signals</h2>
<a name="id2628182"></a><h2>Signals</h2>
<pre class="synopsis">
"<a href="GimpSizeEntry.html#GimpSizeEntry-refval-changed">refval-changed</a>"
@ -155,7 +159,7 @@ GimpSizeEntry implements
</pre>
</div>
<div class="refsect1" lang="en">
<a name="desc"></a><h2>Description</h2>
<a name="id2628276"></a><h2>Description</h2>
<p>
This widget is used to enter pixel distances/sizes and resolutions.
</p>
@ -187,29 +191,29 @@ real-world-unit.
</p>
</div>
<div class="refsect1" lang="en">
<a name="details"></a><h2>Details</h2>
<a name="id2636671"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2603504"></a><h3>
<a name="id2636680"></a><h3>
<a name="GimpSizeEntry-struct"></a>GimpSizeEntry</h3>
<a class="indexterm" name="id2603515"></a><pre class="programlisting">typedef struct _GimpSizeEntry GimpSizeEntry;</pre>
<a class="indexterm" name="id2636691"></a><pre class="programlisting">typedef struct _GimpSizeEntry GimpSizeEntry;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603529"></a><h3>
<a name="id2636705"></a><h3>
<a name="GimpSizeEntryField"></a>GimpSizeEntryField</h3>
<a class="indexterm" name="id2603540"></a><pre class="programlisting">typedef struct _GimpSizeEntryField GimpSizeEntryField;</pre>
<a class="indexterm" name="id2636716"></a><pre class="programlisting">typedef struct _GimpSizeEntryField GimpSizeEntryField;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603554"></a><h3>
<a name="id2636730"></a><h3>
<a name="GimpSizeEntryUpdatePolicy"></a>enum GimpSizeEntryUpdatePolicy</h3>
<a class="indexterm" name="id2603565"></a><pre class="programlisting">typedef enum
<a class="indexterm" name="id2636741"></a><pre class="programlisting">typedef enum
{
GIMP_SIZE_ENTRY_UPDATE_NONE = 0,
GIMP_SIZE_ENTRY_UPDATE_SIZE = 1,
@ -222,9 +226,9 @@ real-world-unit.
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2603581"></a><h3>
<a name="id2636757"></a><h3>
<a name="gimp-size-entry-new"></a>gimp_size_entry_new ()</h3>
<a class="indexterm" name="id2603592"></a><pre class="programlisting">GtkWidget* gimp_size_entry_new (gint number_of_fields,
<a class="indexterm" name="id2636768"></a><pre class="programlisting">GtkWidget* gimp_size_entry_new (gint number_of_fields,
<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> unit,
@ -278,62 +282,53 @@ of the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpU
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>number_of_fields</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>number_of_fields</code></em>&#160;:</span></td>
<td> The number of input fields.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
<td> The initial unit.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>unit_format</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>unit_format</code></em>&#160;:</span></td>
<td> A printf-like unit-format string as is used with
<a href="GimpUnitMenu.html#gimp-unit-menu-new"><code class="function">gimp_unit_menu_new()</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>menu_show_pixels</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>menu_show_pixels</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the unit menu shold contain an item for
GIMP_UNIT_PIXEL (ignored if the <em class="parameter"><code>update_policy</code></em> is not
GIMP_SIZE_ENTRY_UPDATE_NONE).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>menu_show_percent</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>menu_show_percent</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the unit menu shold contain an item for
GIMP_UNIT_PERCENT.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>show_refval</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>show_refval</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if you want an extra "reference value"
spinbutton per input field.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>spinbutton_width</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>spinbutton_width</code></em>&#160;:</span></td>
<td> The minimal horizontal size of the <span class="type">GtkSpinButton</span>'s.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>update_policy</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>update_policy</code></em>&#160;:</span></td>
<td> How the automatic pixel &lt;-&gt; real-world-unit
calculations should be done.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A Pointer to the new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.
</td>
</tr>
@ -342,9 +337,9 @@ of the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpU
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604030"></a><h3>
<a name="id2637205"></a><h3>
<a name="gimp-size-entry-add-field"></a>gimp_size_entry_add_field ()</h3>
<a class="indexterm" name="id2604042"></a><pre class="programlisting">void gimp_size_entry_add_field (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2637216"></a><pre class="programlisting">void gimp_size_entry_add_field (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
GtkSpinButton *value_spinbutton,
GtkSpinButton *refval_spinbutton);</pre>
<p>
@ -362,20 +357,17 @@ as <code class="literal">TRUE</code> in <a href="GimpSizeEntry.html#gimp-size-en
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to add a field to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value_spinbutton</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>value_spinbutton</code></em>&#160;:</span></td>
<td> The spinbutton to display the field's value.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>refval_spinbutton</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>refval_spinbutton</code></em>&#160;:</span></td>
<td> The spinbutton to display the field's reference value.
</td>
</tr>
@ -384,9 +376,9 @@ as <code class="literal">TRUE</code> in <a href="GimpSizeEntry.html#gimp-size-en
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604203"></a><h3>
<a name="id2637351"></a><h3>
<a name="gimp-size-entry-attach-label"></a>gimp_size_entry_attach_label ()</h3>
<a class="indexterm" name="id2604216"></a><pre class="programlisting">GtkWidget* gimp_size_entry_attach_label (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2637364"></a><pre class="programlisting">GtkWidget* gimp_size_entry_attach_label (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
const gchar *text,
gint row,
gint column,
@ -400,38 +392,32 @@ Attaches a <span class="type">GtkLabel</span> to the <a href="GimpSizeEntry.html
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to add a label to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
<td> The text of the label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>row</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>row</code></em>&#160;:</span></td>
<td> The row where the label will be attached.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>column</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>column</code></em>&#160;:</span></td>
<td> The column where the label will be attached.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>alignment</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>alignment</code></em>&#160;:</span></td>
<td> The horizontal alignment of the label.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A pointer to the new <span class="type">GtkLabel</span> widget.
</td>
</tr>
@ -440,9 +426,9 @@ Attaches a <span class="type">GtkLabel</span> to the <a href="GimpSizeEntry.html
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604393"></a><h3>
<a name="id2637523"></a><h3>
<a name="gimp-size-entry-set-resolution"></a>gimp_size_entry_set_resolution ()</h3>
<a class="indexterm" name="id2604406"></a><pre class="programlisting">void gimp_size_entry_set_resolution (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2637535"></a><pre class="programlisting">void gimp_size_entry_set_resolution (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble resolution,
gboolean keep_size);</pre>
@ -467,26 +453,22 @@ This function does nothing if the <a href="GimpSizeEntry.html#GimpSizeEntryUpdat
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to set a resolution for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to set the resolution for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>resolution</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>resolution</code></em>&#160;:</span></td>
<td> The new resolution (in dpi) for the chosen <em class="parameter"><code>field</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>keep_size</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>keep_size</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the <em class="parameter"><code>field</code></em>'s size in pixels should stay the same.
<code class="literal">FALSE</code> if the <em class="parameter"><code>field</code></em>'s size in units should stay the same.
</td>
@ -496,9 +478,9 @@ This function does nothing if the <a href="GimpSizeEntry.html#GimpSizeEntryUpdat
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604625"></a><h3>
<a name="id2637733"></a><h3>
<a name="gimp-size-entry-set-size"></a>gimp_size_entry_set_size ()</h3>
<a class="indexterm" name="id2604636"></a><pre class="programlisting">void gimp_size_entry_set_size (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2637743"></a><pre class="programlisting">void gimp_size_entry_set_size (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble lower,
gdouble upper);</pre>
@ -521,26 +503,22 @@ This function does nothing if the <a href="GimpSizeEntry.html#GimpSizeEntryUpdat
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to set a size for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to set the size for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td> The reference value which will be treated as 0%.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td> The reference value which will be treated as 100%.
</td>
</tr>
@ -549,9 +527,9 @@ This function does nothing if the <a href="GimpSizeEntry.html#GimpSizeEntryUpdat
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2604831"></a><h3>
<a name="id2637919"></a><h3>
<a name="gimp-size-entry-set-value-boundaries"></a>gimp_size_entry_set_value_boundaries ()</h3>
<a class="indexterm" name="id2604845"></a><pre class="programlisting">void gimp_size_entry_set_value_boundaries
<a class="indexterm" name="id2637932"></a><pre class="programlisting">void gimp_size_entry_set_value_boundaries
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble lower,
@ -577,26 +555,22 @@ NOTE: In most cases you won't be interested in these values because the
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to set value boundaries for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to set value boundaries for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td> The new lower boundary of the value of the chosen <em class="parameter"><code>field</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td> The new upper boundary of the value of the chosen <em class="parameter"><code>field</code></em>.
</td>
</tr>
@ -605,9 +579,9 @@ NOTE: In most cases you won't be interested in these values because the
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605030"></a><h3>
<a name="id2638100"></a><h3>
<a name="gimp-size-entry-get-value"></a>gimp_size_entry_get_value ()</h3>
<a class="indexterm" name="id2605042"></a><pre class="programlisting">gdouble gimp_size_entry_get_value (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2638112"></a><pre class="programlisting">gdouble gimp_size_entry_get_value (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);</pre>
<p>
Returns the value of field # <em class="parameter"><code>field</code></em> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
@ -630,20 +604,17 @@ NOTE: In most cases you won't be interested in this value because the
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to know a value of.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to know the value of.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The value of the chosen <em class="parameter"><code>field</code></em>.
</td>
</tr>
@ -652,9 +623,9 @@ NOTE: In most cases you won't be interested in this value because the
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605200"></a><h3>
<a name="id2638253"></a><h3>
<a name="gimp-size-entry-set-value"></a>gimp_size_entry_set_value ()</h3>
<a class="indexterm" name="id2605212"></a><pre class="programlisting">void gimp_size_entry_set_value (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2638264"></a><pre class="programlisting">void gimp_size_entry_set_value (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble value);</pre>
<p>
@ -678,20 +649,17 @@ NOTE: In most cases you won't be interested in this value because the
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to set a value for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to set a value for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
<td> The new value for <em class="parameter"><code>field</code></em>.
</td>
</tr>
@ -700,9 +668,9 @@ NOTE: In most cases you won't be interested in this value because the
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605380"></a><h3>
<a name="id2638415"></a><h3>
<a name="gimp-size-entry-set-refval-boundaries"></a>gimp_size_entry_set_refval_boundaries ()</h3>
<a class="indexterm" name="id2605394"></a><pre class="programlisting">void gimp_size_entry_set_refval_boundaries
<a class="indexterm" name="id2638428"></a><pre class="programlisting">void gimp_size_entry_set_refval_boundaries
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble lower,
@ -721,27 +689,23 @@ The current reference value of the <em class="parameter"><code>field</code></em>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to set the reference value boundaries for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to set the reference value
boundaries for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td> The new lower boundary of the reference value of the chosen <em class="parameter"><code>field</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td> The new upper boundary of the reference value of the chosen <em class="parameter"><code>field</code></em>.
</td>
</tr>
@ -750,9 +714,9 @@ The current reference value of the <em class="parameter"><code>field</code></em>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605533"></a><h3>
<a name="id2638574"></a><h3>
<a name="gimp-size-entry-set-refval-digits"></a>gimp_size_entry_set_refval_digits ()</h3>
<a class="indexterm" name="id2605546"></a><pre class="programlisting">void gimp_size_entry_set_refval_digits
<a class="indexterm" name="id2638587"></a><pre class="programlisting">void gimp_size_entry_set_refval_digits
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gint digits);</pre>
@ -771,20 +735,17 @@ of digits will equal to 0 for <span class="type">GIMP_SIZE_ENTRY_UPDATE_SIZE</sp
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to set the reference value digits for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to set the reference value for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td> The new number of decimal digits for the <span class="type">GtkSpinButton</span> which
displays <em class="parameter"><code>field</code></em>'s reference value.
</td>
@ -794,9 +755,9 @@ of digits will equal to 0 for <span class="type">GIMP_SIZE_ENTRY_UPDATE_SIZE</sp
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605680"></a><h3>
<a name="id2638721"></a><h3>
<a name="gimp-size-entry-get-refval"></a>gimp_size_entry_get_refval ()</h3>
<a class="indexterm" name="id2605692"></a><pre class="programlisting">gdouble gimp_size_entry_get_refval (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2638732"></a><pre class="programlisting">gdouble gimp_size_entry_get_refval (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);</pre>
<p>
Returns the reference value for field # <em class="parameter"><code>field</code></em> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
@ -812,20 +773,17 @@ in dpi, depending on which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to know a reference value of.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to know the reference value of.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The reference value of the chosen <em class="parameter"><code>field</code></em>.
</td>
</tr>
@ -834,9 +792,9 @@ in dpi, depending on which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605804"></a><h3>
<a name="id2638845"></a><h3>
<a name="gimp-size-entry-set-refval"></a>gimp_size_entry_set_refval ()</h3>
<a class="indexterm" name="id2605815"></a><pre class="programlisting">void gimp_size_entry_set_refval (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2638856"></a><pre class="programlisting">void gimp_size_entry_set_refval (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble refval);</pre>
<p>
@ -853,20 +811,17 @@ depending on which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy"><span
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to set a reference value for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> The index of the field you want to set the reference value for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>refval</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>refval</code></em>&#160;:</span></td>
<td> The new reference value for <em class="parameter"><code>field</code></em>.
</td>
</tr>
@ -875,9 +830,9 @@ depending on which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy"><span
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2605941"></a><h3>
<a name="id2638982"></a><h3>
<a name="gimp-size-entry-get-unit"></a>gimp_size_entry_get_unit ()</h3>
<a class="indexterm" name="id2605952"></a><pre class="programlisting"><a
<a class="indexterm" name="id2638992"></a><pre class="programlisting"><a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> gimp_size_entry_get_unit (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);</pre>
<p>
@ -892,14 +847,12 @@ href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to know the unit of.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The sizeentry's unit.
</td>
</tr>
@ -908,9 +861,9 @@ href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606025"></a><h3>
<a name="id2639066"></a><h3>
<a name="gimp-size-entry-set-unit"></a>gimp_size_entry_set_unit ()</h3>
<a class="indexterm" name="id2606036"></a><pre class="programlisting">void gimp_size_entry_set_unit (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2639077"></a><pre class="programlisting">void gimp_size_entry_set_unit (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> unit);</pre>
@ -926,14 +879,12 @@ according to which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy"><span
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to change the unit for.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
<td> The new unit.
</td>
</tr>
@ -942,9 +893,9 @@ according to which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy"><span
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606122"></a><h3>
<a name="id2639163"></a><h3>
<a name="gimp-size-entry-set-pixel-digits"></a>gimp_size_entry_set_pixel_digits ()</h3>
<a class="indexterm" name="id2606135"></a><pre class="programlisting">void gimp_size_entry_set_pixel_digits
<a class="indexterm" name="id2639176"></a><pre class="programlisting">void gimp_size_entry_set_pixel_digits
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint digits);</pre>
<p>
@ -957,14 +908,12 @@ you set up a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="typ
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td> the number of digits to display for a pixel size
</td>
</tr>
@ -973,9 +922,9 @@ you set up a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="typ
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606224"></a><h3>
<a name="id2639265"></a><h3>
<a name="gimp-size-entry-grab-focus"></a>gimp_size_entry_grab_focus ()</h3>
<a class="indexterm" name="id2606235"></a><pre class="programlisting">void gimp_size_entry_grab_focus (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);</pre>
<a class="indexterm" name="id2639276"></a><pre class="programlisting">void gimp_size_entry_grab_focus (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);</pre>
<p>
This function is rather ugly and just a workaround for the fact that
it's impossible to implement <code class="function">gtk_widget_grab_focus()</code> for a <span class="type">GtkTable</span>.</p>
@ -985,8 +934,7 @@ it's impossible to implement <code class="function">gtk_widget_grab_focus()</cod
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> The sizeentry you want to grab the keyboard focus.
</td>
</tr></tbody>
@ -994,9 +942,9 @@ it's impossible to implement <code class="function">gtk_widget_grab_focus()</cod
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606296"></a><h3>
<a name="id2639337"></a><h3>
<a name="gimp-size-entry-get-help-widget"></a>gimp_size_entry_get_help_widget ()</h3>
<a class="indexterm" name="id2606308"></a><pre class="programlisting">GtkWidget* gimp_size_entry_get_help_widget (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a class="indexterm" name="id2639349"></a><pre class="programlisting">GtkWidget* gimp_size_entry_get_help_widget (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);</pre>
<p>
You shouldn't fiddle with the internals of a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> but
@ -1009,20 +957,17 @@ can use this function to get a pointer to the spinbuttons.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gse</code></em>&#160;:</span></td>
<td> a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>field</code></em>&#160;:</span></td>
<td> the index of the widget you want to get a pointer to
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a <span class="type">GtkWidget</span> pointer that you can attach a tooltip to.
</td>
</tr>
@ -1031,11 +976,11 @@ can use this function to get a pointer to the spinbuttons.</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="signals"></a><h2>Signal Details</h2>
<a name="id2639455"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id2606423"></a><h3>
<a name="id2639464"></a><h3>
<a name="GimpSizeEntry-refval-changed"></a>The "refval-changed" signal</h3>
<a class="indexterm" name="id2606433"></a><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
<a class="indexterm" name="id2639474"></a><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data) : Run first</pre>
<p>
@ -1044,15 +989,13 @@ can use this function to get a pointer to the spinbuttons.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gimpsizeentry</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gimpsizeentry</code></em>&#160;:</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
@ -1060,9 +1003,9 @@ can use this function to get a pointer to the spinbuttons.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606494"></a><h3>
<a name="id2639535"></a><h3>
<a name="GimpSizeEntry-unit-changed"></a>The "unit-changed" signal</h3>
<a class="indexterm" name="id2606501"></a><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
<a class="indexterm" name="id2639542"></a><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data) : Run first</pre>
<p>
@ -1071,15 +1014,13 @@ can use this function to get a pointer to the spinbuttons.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gimpsizeentry</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gimpsizeentry</code></em>&#160;:</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
@ -1087,9 +1028,9 @@ can use this function to get a pointer to the spinbuttons.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606562"></a><h3>
<a name="id2639603"></a><h3>
<a name="GimpSizeEntry-value-changed"></a>The "value-changed" signal</h3>
<a class="indexterm" name="id2606570"></a><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
<a class="indexterm" name="id2639611"></a><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data) : Run first</pre>
<p>
@ -1098,15 +1039,13 @@ can use this function to get a pointer to the spinbuttons.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>gimpsizeentry</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>gimpsizeentry</code></em>&#160;:</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
@ -1114,7 +1053,7 @@ can use this function to get a pointer to the spinbuttons.</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2606634"></a><h2>See Also</h2>
<a name="id2639675"></a><h2>See Also</h2>
<p>
<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"