Imported Upstream version 2.2.6

This commit is contained in:
Ari Pollak
2010-08-11 01:14:17 -04:00
parent c5acc8ae10
commit 60968fd622
464 changed files with 20333 additions and 24254 deletions

View File

@ -1,90 +1,132 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>GimpSizeEntry</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"><link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual"><link rel="up" href="libgimpwidgets-utils.html" title="Part<72>V.<2E>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.2 (XML mode)"><style type="text/css">
.synopsis, .classsynopsis {
background: #eeeeee;
border: solid 1px #aaaaaa;
padding: 0.5em;
}
.programlisting {
background: #eeeeff;
border: solid 1px #aaaaff;
padding: 0.5em;
}
.variablelist {
padding: 4px;
margin-left: 3em;
}
.navigation {
background: #ffeeee;
border: solid 1px #ffaaaa;
margin-top: 0.5em;
margin-bottom: 0.5em;
}
.navigation a {
color: #770000;
}
.navigation a:visited {
color: #550000;
}
.navigation .title {
font-size: 200%;
}
</style></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libgimpwidgets-GimpQueryBox.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="libgimpwidgets-utils.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">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></table><div class="refentry" lang="en"><a name="GimpSizeEntry"></a><div class="titlepage"></div><div class="refnamediv"><h2><span class="refentrytitle">GimpSizeEntry</span></h2><p>GimpSizeEntry &#8212; Widget for entering pixel values and resolutions.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>GimpSizeEntry</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"><link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual"><link rel="up" href="libgimpwidgets-utils.html" title="Part<72>V.<2E>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.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="libgimpwidgets-widgets.html" title="Part<72>I.<2E>GIMP Widgets"><link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy"><link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView"><link rel="part" href="libgimpwidgets-colordisplay.html" title="Part<72>II.<2E>GIMP Display Filters"><link rel="part" href="libgimpwidgets-colorselector.html" title="Part<72>III.<2E>GIMP Color Selectors"><link rel="part" href="libgimpwidgets-controller.html" title="Part<72>IV.<2E>GIMP Controllers"><link rel="part" href="libgimpwidgets-utils.html" title="Part<72>V.<2E>GIMP Widgets Utilities"><link rel="part" href="libgimpwidgets-deprecated.html" title="Part<72>VI.<2E>Deprecated API"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libgimpwidgets-GimpQueryBox.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="libgimpwidgets-utils.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">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></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">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"><h2>Synopsis</h2><pre class="synopsis">
struct <a href="GimpSizeEntry.html#GimpSizeEntry-struct">GimpSizeEntry</a>;
struct <a href="GimpSizeEntry.html#GimpSizeEntryField">GimpSizeEntryField</a>;
<a href="GimpSizeEntry.html#GimpSizeEntry-struct">GimpSizeEntry</a>;
<a href="GimpSizeEntry.html#GimpSizeEntryField">GimpSizeEntryField</a>;
enum <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a>;
GtkWidget* <a href="GimpSizeEntry.html#gimp-size-entry-new">gimp_size_entry_new</a> (gint number_of_fields,
<a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GimpSizeEntry.html#gimp-size-entry-new">gimp_size_entry_new</a> (<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> number_of_fields,
<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> unit,
const gchar *unit_format,
gboolean menu_show_pixels,
gboolean menu_show_percent,
gboolean show_refval,
gint spinbutton_width,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *unit_format,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> menu_show_pixels,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> menu_show_percent,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> show_refval,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> spinbutton_width,
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy);
void <a href="GimpSizeEntry.html#gimp-size-entry-add-field">gimp_size_entry_add_field</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
GtkSpinButton *value_spinbutton,
GtkSpinButton *refval_spinbutton);
GtkWidget* <a href="GimpSizeEntry.html#gimp-size-entry-attach-label">gimp_size_entry_attach_label</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
const gchar *text,
gint row,
gint column,
gfloat alignment);
<a
href="../gtk/GtkSpinButton.html"
>GtkSpinButton</a> *value_spinbutton,
<a
href="../gtk/GtkSpinButton.html"
>GtkSpinButton</a> *refval_spinbutton);
<a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GimpSizeEntry.html#gimp-size-entry-attach-label">gimp_size_entry_attach_label</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *text,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> row,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> column,
<a
href="../glib/glib-Basic-Types.html#gfloat"
>gfloat</a> alignment);
void <a href="GimpSizeEntry.html#gimp-size-entry-set-resolution">gimp_size_entry_set_resolution</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble resolution,
gboolean keep_size);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> resolution,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> keep_size);
void <a href="GimpSizeEntry.html#gimp-size-entry-set-size">gimp_size_entry_set_size</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble lower,
gdouble upper);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> lower,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> upper);
void <a href="GimpSizeEntry.html#gimp-size-entry-set-value-boundaries">gimp_size_entry_set_value_boundaries</a>
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble lower,
gdouble upper);
gdouble <a href="GimpSizeEntry.html#gimp-size-entry-get-value">gimp_size_entry_get_value</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> lower,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> upper);
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> <a href="GimpSizeEntry.html#gimp-size-entry-get-value">gimp_size_entry_get_value</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field);
void <a href="GimpSizeEntry.html#gimp-size-entry-set-value">gimp_size_entry_set_value</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble value);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> value);
void <a href="GimpSizeEntry.html#gimp-size-entry-set-refval-boundaries">gimp_size_entry_set_refval_boundaries</a>
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble lower,
gdouble upper);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> lower,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> upper);
void <a href="GimpSizeEntry.html#gimp-size-entry-set-refval-digits">gimp_size_entry_set_refval_digits</a>
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gint digits);
gdouble <a href="GimpSizeEntry.html#gimp-size-entry-get-refval">gimp_size_entry_get_refval</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> digits);
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> <a href="GimpSizeEntry.html#gimp-size-entry-get-refval">gimp_size_entry_get_refval</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field);
void <a href="GimpSizeEntry.html#gimp-size-entry-set-refval">gimp_size_entry_set_refval</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble refval);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> refval);
<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> <a href="GimpSizeEntry.html#gimp-size-entry-get-unit">gimp_size_entry_get_unit</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);
@ -94,33 +136,55 @@ href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> unit);
void <a href="GimpSizeEntry.html#gimp-size-entry-set-pixel-digits">gimp_size_entry_set_pixel_digits</a>
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint digits);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> digits);
void <a href="GimpSizeEntry.html#gimp-size-entry-grab-focus">gimp_size_entry_grab_focus</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);
GtkWidget* <a href="GimpSizeEntry.html#gimp-size-entry-get-help-widget">gimp_size_entry_get_help_widget</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);
<a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GimpSizeEntry.html#gimp-size-entry-get-help-widget">gimp_size_entry_get_help_widget</a> (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field);
</pre></div><div class="refsect1" lang="en"><a name="id2610576"></a><h2>Object Hierarchy</h2><pre class="synopsis">
</pre></div><div class="refsect1" lang="en"><a name="id2607944"></a><h2>Object Hierarchy</h2><pre class="synopsis">
GObject
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkTable
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="../gtk/GtkObject.html"
>GtkObject</a>
+----<a
href="../gtk/GtkWidget.html"
>GtkWidget</a>
+----<a
href="../gtk/GtkContainer.html"
>GtkContainer</a>
+----<a
href="../gtk/GtkTable.html"
>GtkTable</a>
+----GimpSizeEntry
</pre></div><div class="refsect1" lang="en"><a name="id2610612"></a><h2>Implemented Interfaces</h2><p>
</pre></div><div class="refsect1" lang="en"><a name="id2607980"></a><h2>Implemented Interfaces</h2><p>
GimpSizeEntry implements
AtkImplementorIface.</p></div><div class="refsect1" lang="en"><a name="id2605216"></a><h2>Signal Prototypes</h2><pre class="synopsis">
AtkImplementorIface.</p></div><div class="refsect1" lang="en"><a name="id2606089"></a><h2>Signal Prototypes</h2><pre class="synopsis">
"<a href="GimpSizeEntry.html#GimpSizeEntry-refval-changed">refval-changed</a>"
void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data);
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
"<a href="GimpSizeEntry.html#GimpSizeEntry-unit-changed">unit-changed</a>"
void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data);
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
"<a href="GimpSizeEntry.html#GimpSizeEntry-value-changed">value-changed</a>"
void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data);
</pre></div><div class="refsect1" lang="en"><a name="id2605294"></a><h2>Description</h2><p>
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
</pre></div><div class="refsect1" lang="en"><a name="id2606167"></a><h2>Description</h2><p>
This widget is used to enter pixel distances/sizes and resolutions.
</p><p>
You can specify the number of fields the widget should provide. For
@ -132,9 +196,15 @@ specify the <a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
><span class="type">GimpUnit</span></a> of the displayed values.
</p><p>
For each field, there can be one or two <span class="type">GtkSpinButton</span>'s to enter
"value" and "reference value". If you specify <i class="parameter"><tt>show_refval</tt></i> as <span class="type">FALSE</span>
in <a href="GimpSizeEntry.html#gimp-size-entry-new"><tt class="function">gimp_size_entry_new()</tt></a> there will be only one <span class="type">GtkSpinButton</span> and the
For each field, there can be one or two <a
href="../gtk/GtkSpinButton.html"
><span class="type">GtkSpinButton</span></a>'s to enter
"value" and "reference value". If you specify <i class="parameter"><tt>show_refval</tt></i> as <a
href="../glib/glib-Standard-Macros.html#FALSE--CAPS"
><span class="type">FALSE</span></a>
in <a href="GimpSizeEntry.html#gimp-size-entry-new"><tt class="function">gimp_size_entry_new()</tt></a> there will be only one <a
href="../gtk/GtkSpinButton.html"
><span class="type">GtkSpinButton</span></a> and the
<a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> will contain an item for selecting GIMP_UNIT_PIXEL.
</p><p>
The "reference value" is either of GIMP_UNIT_PIXEL or dpi, depending
@ -144,11 +214,11 @@ real-world-unit (see <a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
><span class="type">GimpUnit</span></a>) or the dpi value mapped to pixels per
real-world-unit.
</p></div><div class="refsect1" lang="en"><a name="id2605395"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2605400"></a><h3><a name="GimpSizeEntry-struct"></a>struct GimpSizeEntry</h3><a class="indexterm" name="id2605408"></a><pre class="programlisting">struct GimpSizeEntry;</pre><p>
</p></div><div class="refsect1" lang="en"><a name="id2606267"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2606272"></a><h3><a name="GimpSizeEntry-struct"></a>GimpSizeEntry</h3><a class="indexterm" name="id2606280"></a><pre class="programlisting">typedef struct _GimpSizeEntry GimpSizeEntry;</pre><p>
</p></div><hr><div class="refsect2" lang="en"><a name="id2605418"></a><h3><a name="GimpSizeEntryField"></a>struct GimpSizeEntryField</h3><a class="indexterm" name="id2605426"></a><pre class="programlisting">struct GimpSizeEntryField;</pre><p>
</p></div><hr><div class="refsect2" lang="en"><a name="id2606291"></a><h3><a name="GimpSizeEntryField"></a>GimpSizeEntryField</h3><a class="indexterm" name="id2606299"></a><pre class="programlisting">typedef struct _GimpSizeEntryField GimpSizeEntryField;</pre><p>
</p></div><hr><div class="refsect2" lang="en"><a name="id2605436"></a><h3><a name="GimpSizeEntryUpdatePolicy"></a>enum GimpSizeEntryUpdatePolicy</h3><a class="indexterm" name="id2605445"></a><pre class="programlisting">typedef enum
</p></div><hr><div class="refsect2" lang="en"><a name="id2606310"></a><h3><a name="GimpSizeEntryUpdatePolicy"></a>enum GimpSizeEntryUpdatePolicy</h3><a class="indexterm" name="id2606319"></a><pre class="programlisting">typedef enum
{
GIMP_SIZE_ENTRY_UPDATE_NONE = 0,
GIMP_SIZE_ENTRY_UPDATE_SIZE = 1,
@ -156,15 +226,29 @@ real-world-unit.
} GimpSizeEntryUpdatePolicy;
</pre><p>
</p></div><hr><div class="refsect2" lang="en"><a name="id2605458"></a><h3><a name="gimp-size-entry-new"></a>gimp_size_entry_new ()</h3><a class="indexterm" name="id2605466"></a><pre class="programlisting">GtkWidget* gimp_size_entry_new (gint number_of_fields,
</p></div><hr><div class="refsect2" lang="en"><a name="id2606332"></a><h3><a name="gimp-size-entry-new"></a>gimp_size_entry_new ()</h3><a class="indexterm" name="id2606340"></a><pre class="programlisting"><a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* gimp_size_entry_new (<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> number_of_fields,
<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> unit,
const gchar *unit_format,
gboolean menu_show_pixels,
gboolean menu_show_percent,
gboolean show_refval,
gint spinbutton_width,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *unit_format,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> menu_show_pixels,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> menu_show_percent,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> show_refval,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> spinbutton_width,
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy);</pre><p>
Creates a new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.
</p><p>
@ -188,7 +272,9 @@ For each input field:
</p><p>
7. <a href="GimpSizeEntry.html#gimp-size-entry-set-refval"><tt class="function">gimp_size_entry_set_refval()</tt></a> (or <a href="GimpSizeEntry.html#gimp-size-entry-set-value"><tt class="function">gimp_size_entry_set_value()</tt></a>)
</p><p>
The <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> is derived from <span class="type">GtkTable</span> and will have
The <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> is derived from <a
href="../gtk/GtkTable.html"
><span class="type">GtkTable</span></a> and will have
an empty border of one cell width on each side plus an empty column left
of the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> to allow the caller to add labels or a
<a href="GimpChainButton.html" title="GimpChainButton"><span class="type">GimpChainButton</span></a>.</p><p>
@ -204,47 +290,77 @@ of the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpU
GIMP_UNIT_PERCENT.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>show_refval</tt></i><EFBFBD>:</span></td><td> <tt class="literal">TRUE</tt> if you want an extra "reference value"
spinbutton per input field.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>spinbutton_width</tt></i><EFBFBD>:</span></td><td> The minimal horizontal size of the <span class="type">GtkSpinButton</span>'s.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>spinbutton_width</tt></i><EFBFBD>:</span></td><td> The minimal horizontal size of the <a
href="../gtk/GtkSpinButton.html"
><span class="type">GtkSpinButton</span></a>'s.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>update_policy</tt></i><EFBFBD>:</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> :</span></td><td> A Pointer to the new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2617178"></a><h3><a name="gimp-size-entry-add-field"></a>gimp_size_entry_add_field ()</h3><a class="indexterm" name="id2617186"></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>
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> A Pointer to the new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2614392"></a><h3><a name="gimp-size-entry-add-field"></a>gimp_size_entry_add_field ()</h3><a class="indexterm" name="id2614401"></a><pre class="programlisting">void gimp_size_entry_add_field (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../gtk/GtkSpinButton.html"
>GtkSpinButton</a> *value_spinbutton,
<a
href="../gtk/GtkSpinButton.html"
>GtkSpinButton</a> *refval_spinbutton);</pre><p>
Adds an input field to the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p><p>
The new input field will have the index 0. If you specified <i class="parameter"><tt>show_refval</tt></i>
as <tt class="literal">TRUE</tt> in <a href="GimpSizeEntry.html#gimp-size-entry-new"><tt class="function">gimp_size_entry_new()</tt></a> you have to pass an additional
<span class="type">GtkSpinButton</span> to hold the reference value. If <i class="parameter"><tt>show_refval</tt></i> was <tt class="literal">FALSE</tt>,
<a
href="../gtk/GtkSpinButton.html"
><span class="type">GtkSpinButton</span></a> to hold the reference value. If <i class="parameter"><tt>show_refval</tt></i> was <tt class="literal">FALSE</tt>,
<i class="parameter"><tt>refval_spinbutton</tt></i> will be ignored.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to add a field to.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>value_spinbutton</tt></i><EFBFBD>:</span></td><td> The spinbutton to display the field's value.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>refval_spinbutton</tt></i><EFBFBD>:</span></td><td> The spinbutton to display the field's reference value.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2617291"></a><h3><a name="gimp-size-entry-attach-label"></a>gimp_size_entry_attach_label ()</h3><a class="indexterm" name="id2617298"></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,
gfloat alignment);</pre><p>
Attaches a <span class="type">GtkLabel</span> to the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> (which is a <span class="type">GtkTable</span>).</p><p>
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2614517"></a><h3><a name="gimp-size-entry-attach-label"></a>gimp_size_entry_attach_label ()</h3><a class="indexterm" name="id2614528"></a><pre class="programlisting"><a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* gimp_size_entry_attach_label (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *text,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> row,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> column,
<a
href="../glib/glib-Basic-Types.html#gfloat"
>gfloat</a> alignment);</pre><p>
Attaches a <a
href="../gtk/GtkLabel.html"
><span class="type">GtkLabel</span></a> to the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> (which is a <a
href="../gtk/GtkTable.html"
><span class="type">GtkTable</span></a>).</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to add a label to.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>text</tt></i><EFBFBD>:</span></td><td> The text of the label.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>row</tt></i><EFBFBD>:</span></td><td> The row where the label will be attached.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>column</tt></i><EFBFBD>:</span></td><td> The column where the label will be attached.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>alignment</tt></i><EFBFBD>:</span></td><td> The horizontal alignment of the label.
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A pointer to the new <span class="type">GtkLabel</span> widget.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2617434"></a><h3><a name="gimp-size-entry-set-resolution"></a>gimp_size_entry_set_resolution ()</h3><a class="indexterm" name="id2617443"></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><p>
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> A pointer to the new <a
href="../gtk/GtkLabel.html"
><span class="type">GtkLabel</span></a> widget.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2614673"></a><h3><a name="gimp-size-entry-set-resolution"></a>gimp_size_entry_set_resolution ()</h3><a class="indexterm" name="id2614684"></a><pre class="programlisting">void gimp_size_entry_set_resolution (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> resolution,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> keep_size);</pre><p>
Sets the resolution (in dpi) for field # <i class="parameter"><tt>field</tt></i> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p><p>
The <i class="parameter"><tt>resolution</tt></i> passed will be clamped to fit in
[<a
href="../libgimpbase/libgimpbase-gimplimits.html#GIMP-MIN-RESOLUTION-CAPS"
href="../libgimpbase/libgimpbase-gimplimits.html#GIMP-MIN-RESOLUTION--CAPS"
><span class="type">GIMP_MIN_RESOLUTION</span></a>..<a
href="../libgimpbase/libgimpbase-gimplimits.html#GIMP-MAX-RESOLUTION-CAPS"
href="../libgimpbase/libgimpbase-gimplimits.html#GIMP-MAX-RESOLUTION--CAPS"
><span class="type">GIMP_MAX_RESOLUTION</span></a>].
</p><p>
This function does nothing if the <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> specified in
@ -255,10 +371,16 @@ This function does nothing if the <a href="GimpSizeEntry.html#GimpSizeEntryUpdat
</td></tr><tr><td><span class="term"><i class="parameter"><tt>resolution</tt></i><EFBFBD>:</span></td><td> The new resolution (in dpi) for the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>keep_size</tt></i><EFBFBD>:</span></td><td> <tt class="literal">TRUE</tt> if the <i class="parameter"><tt>field</tt></i>'s size in pixels should stay the same.
<tt class="literal">FALSE</tt> if the <i class="parameter"><tt>field</tt></i>'s size in units should stay the same.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2617601"></a><h3><a name="gimp-size-entry-set-size"></a>gimp_size_entry_set_size ()</h3><a class="indexterm" name="id2617610"></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><p>
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2614848"></a><h3><a name="gimp-size-entry-set-size"></a>gimp_size_entry_set_size ()</h3><a class="indexterm" name="id2614856"></a><pre class="programlisting">void gimp_size_entry_set_size (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> lower,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> upper);</pre><p>
Sets the pixel values for field # <i class="parameter"><tt>field</tt></i> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
which will be treated as 0% and 100%.
</p><p>
@ -273,11 +395,17 @@ This function does nothing if the <a href="GimpSizeEntry.html#GimpSizeEntryUpdat
</td></tr><tr><td><span class="term"><i class="parameter"><tt>field</tt></i><EFBFBD>:</span></td><td> The index of the field you want to set the size for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>lower</tt></i><EFBFBD>:</span></td><td> The reference value which will be treated as 0%.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>upper</tt></i><EFBFBD>:</span></td><td> The reference value which will be treated as 100%.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2617758"></a><h3><a name="gimp-size-entry-set-value-boundaries"></a>gimp_size_entry_set_value_boundaries ()</h3><a class="indexterm" name="id2617766"></a><pre class="programlisting">void gimp_size_entry_set_value_boundaries
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2615007"></a><h3><a name="gimp-size-entry-set-value-boundaries"></a>gimp_size_entry_set_value_boundaries ()</h3><a class="indexterm" name="id2615019"></a><pre class="programlisting">void gimp_size_entry_set_value_boundaries
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble lower,
gdouble upper);</pre><p>
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> lower,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> upper);</pre><p>
Limits the range of possible values which can be entered in field # <i class="parameter"><tt>field</tt></i>
of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p><p>
@ -294,8 +422,12 @@ NOTE: In most cases you won't be interested in these values because the
</td></tr><tr><td><span class="term"><i class="parameter"><tt>field</tt></i><EFBFBD>:</span></td><td> The index of the field you want to set value boundaries for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>lower</tt></i><EFBFBD>:</span></td><td> The new lower boundary of the value of the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>upper</tt></i><EFBFBD>:</span></td><td> The new upper boundary of the value of the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2617908"></a><h3><a name="gimp-size-entry-get-value"></a>gimp_size_entry_get_value ()</h3><a class="indexterm" name="id2617916"></a><pre class="programlisting">gdouble gimp_size_entry_get_value (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);</pre><p>
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2615163"></a><h3><a name="gimp-size-entry-get-value"></a>gimp_size_entry_get_value ()</h3><a class="indexterm" name="id2615172"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> gimp_size_entry_get_value (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field);</pre><p>
Returns the value of field # <i class="parameter"><tt>field</tt></i> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p><p>
The <i class="parameter"><tt>value</tt></i> returned is a distance or resolution
@ -310,10 +442,14 @@ NOTE: In most cases you won't be interested in this value because the
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to know a value of.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>field</tt></i><EFBFBD>:</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> :</span></td><td> The value of the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618039"></a><h3><a name="gimp-size-entry-set-value"></a>gimp_size_entry_set_value ()</h3><a class="indexterm" name="id2618047"></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>
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> The value of the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2615298"></a><h3><a name="gimp-size-entry-set-value"></a>gimp_size_entry_set_value ()</h3><a class="indexterm" name="id2615307"></a><pre class="programlisting">void gimp_size_entry_set_value (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> value);</pre><p>
Sets the value for field # <i class="parameter"><tt>field</tt></i> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p><p>
The <i class="parameter"><tt>value</tt></i> passed is treated to be a distance or resolution
@ -329,11 +465,17 @@ NOTE: In most cases you won't be interested in this value because the
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to set a value for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>field</tt></i><EFBFBD>:</span></td><td> The index of the field you want to set a value for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>value</tt></i><EFBFBD>:</span></td><td> The new value for <i class="parameter"><tt>field</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618177"></a><h3><a name="gimp-size-entry-set-refval-boundaries"></a>gimp_size_entry_set_refval_boundaries ()</h3><a class="indexterm" name="id2618186"></a><pre class="programlisting">void gimp_size_entry_set_refval_boundaries
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2615440"></a><h3><a name="gimp-size-entry-set-refval-boundaries"></a>gimp_size_entry_set_refval_boundaries ()</h3><a class="indexterm" name="id2615452"></a><pre class="programlisting">void gimp_size_entry_set_refval_boundaries
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field,
gdouble lower,
gdouble upper);</pre><p>
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> lower,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> upper);</pre><p>
Limits the range of possible reference values which can be entered in
field # <i class="parameter"><tt>field</tt></i> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p><p>
@ -345,10 +487,14 @@ The current reference value of the <i class="parameter"><tt>field</tt></i> will
boundaries for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>lower</tt></i><EFBFBD>:</span></td><td> The new lower boundary of the reference value of the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>upper</tt></i><EFBFBD>:</span></td><td> The new upper boundary of the reference value of the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618307"></a><h3><a name="gimp-size-entry-set-refval-digits"></a>gimp_size_entry_set_refval_digits ()</h3><a class="indexterm" name="id2618316"></a><pre class="programlisting">void gimp_size_entry_set_refval_digits
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2615575"></a><h3><a name="gimp-size-entry-set-refval-digits"></a>gimp_size_entry_set_refval_digits ()</h3><a class="indexterm" name="id2615587"></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><p>
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> digits);</pre><p>
Sets the decimal digits of field # <i class="parameter"><tt>field</tt></i> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> to
<i class="parameter"><tt>digits</tt></i>.
</p><p>
@ -358,10 +504,16 @@ of digits will equal to 0 for <span class="type">GIMP_SIZE_ENTRY_UPDATE_SIZE</sp
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to set the reference value digits for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>field</tt></i><EFBFBD>:</span></td><td> The index of the field you want to set the reference value for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>digits</tt></i><EFBFBD>:</span></td><td> The new number of decimal digits for the <span class="type">GtkSpinButton</span> which
</td></tr><tr><td><span class="term"><i class="parameter"><tt>digits</tt></i><EFBFBD>:</span></td><td> The new number of decimal digits for the <a
href="../gtk/GtkSpinButton.html"
><span class="type">GtkSpinButton</span></a> which
displays <i class="parameter"><tt>field</tt></i>'s reference value.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618430"></a><h3><a name="gimp-size-entry-get-refval"></a>gimp_size_entry_get_refval ()</h3><a class="indexterm" name="id2618439"></a><pre class="programlisting">gdouble gimp_size_entry_get_refval (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);</pre><p>
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2615706"></a><h3><a name="gimp-size-entry-get-refval"></a>gimp_size_entry_get_refval ()</h3><a class="indexterm" name="id2615715"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> gimp_size_entry_get_refval (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field);</pre><p>
Returns the reference value for field # <i class="parameter"><tt>field</tt></i> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p><p>
The reference value is either a distance in pixels or a resolution
@ -370,10 +522,14 @@ in dpi, depending on which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to know a reference value of.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>field</tt></i><EFBFBD>:</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> :</span></td><td> The reference value of the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618535"></a><h3><a name="gimp-size-entry-set-refval"></a>gimp_size_entry_set_refval ()</h3><a class="indexterm" name="id2618543"></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>
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> The reference value of the chosen <i class="parameter"><tt>field</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2615813"></a><h3><a name="gimp-size-entry-set-refval"></a>gimp_size_entry_set_refval ()</h3><a class="indexterm" name="id2615822"></a><pre class="programlisting">void gimp_size_entry_set_refval (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> field,
<a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> refval);</pre><p>
Sets the reference value for field # <i class="parameter"><tt>field</tt></i> of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p><p>
The <i class="parameter"><tt>refval</tt></i> passed is either a distance in pixels or a resolution in dpi,
@ -383,7 +539,7 @@ depending on which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy"><span
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to set a reference value for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>field</tt></i><EFBFBD>:</span></td><td> The index of the field you want to set the reference value for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>refval</tt></i><EFBFBD>:</span></td><td> The new reference value for <i class="parameter"><tt>field</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618649"></a><h3><a name="gimp-size-entry-get-unit"></a>gimp_size_entry_get_unit ()</h3><a class="indexterm" name="id2618658"></a><pre class="programlisting"><a
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2567570"></a><h3><a name="gimp-size-entry-get-unit"></a>gimp_size_entry_get_unit ()</h3><a class="indexterm" name="id2563789"></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>
Returns the <a
@ -392,8 +548,8 @@ href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
<a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</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> :</span></td><td> The sizeentry's unit.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618724"></a><h3><a name="gimp-size-entry-set-unit"></a>gimp_size_entry_set_unit ()</h3><a class="indexterm" name="id2618732"></a><pre class="programlisting">void gimp_size_entry_set_unit (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> The sizeentry's unit.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2615961"></a><h3><a name="gimp-size-entry-set-unit"></a>gimp_size_entry_set_unit ()</h3><a class="indexterm" name="id2615969"></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><p>
@ -404,44 +560,62 @@ according to which <a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy"><span
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to change the unit for.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>unit</tt></i><EFBFBD>:</span></td><td> The new unit.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618808"></a><h3><a name="gimp-size-entry-set-pixel-digits"></a>gimp_size_entry_set_pixel_digits ()</h3><a class="indexterm" name="id2618817"></a><pre class="programlisting">void gimp_size_entry_set_pixel_digits
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616037"></a><h3><a name="gimp-size-entry-set-pixel-digits"></a>gimp_size_entry_set_pixel_digits ()</h3><a class="indexterm" name="id2616045"></a><pre class="programlisting">void gimp_size_entry_set_pixel_digits
(<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint digits);</pre><p>
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> digits);</pre><p>
Similar to <a href="GimpUnitMenu.html#gimp-unit-menu-set-pixel-digits"><tt class="function">gimp_unit_menu_set_pixel_digits()</tt></a>, this function allows
you set up a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> so that sub-pixel sizes can be entered.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
</td></tr><tr><td><span class="term"><i class="parameter"><tt>digits</tt></i><EFBFBD>:</span></td><td> the number of digits to display for a pixel size
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618892"></a><h3><a name="gimp-size-entry-grab-focus"></a>gimp_size_entry_grab_focus ()</h3><a class="indexterm" name="id2618900"></a><pre class="programlisting">void gimp_size_entry_grab_focus (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);</pre><p>
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616118"></a><h3><a name="gimp-size-entry-grab-focus"></a>gimp_size_entry_grab_focus ()</h3><a class="indexterm" name="id2616127"></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 <tt class="function">gtk_widget_grab_focus()</tt> for a <span class="type">GtkTable</span>.</p><p>
it's impossible to implement <a
href="../gtk/GtkWidget.html#gtk-widget-grab-focus"
><tt class="function">gtk_widget_grab_focus()</tt></a> for a <a
href="../gtk/GtkTable.html"
><span class="type">GtkTable</span></a>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> The sizeentry you want to grab the keyboard focus.
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2618952"></a><h3><a name="gimp-size-entry-get-help-widget"></a>gimp_size_entry_get_help_widget ()</h3><a class="indexterm" name="id2618963"></a><pre class="programlisting">GtkWidget* gimp_size_entry_get_help_widget (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
gint field);</pre><p>
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616179"></a><h3><a name="gimp-size-entry-get-help-widget"></a>gimp_size_entry_get_help_widget ()</h3><a class="indexterm" name="id2616187"></a><pre class="programlisting"><a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* gimp_size_entry_get_help_widget (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> 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
if you want to set tooltips using <a href="libgimpwidgets-GimpHelpUI.html#gimp-help-set-help-data"><tt class="function">gimp_help_set_help_data()</tt></a> you
can use this function to get a pointer to the spinbuttons.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gse</tt></i><EFBFBD>:</span></td><td> a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
</td></tr><tr><td><span class="term"><i class="parameter"><tt>field</tt></i><EFBFBD>:</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> :</span></td><td> a <span class="type">GtkWidget</span> pointer that you can attach a tooltip to.
</td></tr></tbody></table></div></div></div><div class="refsect1" lang="en"><a name="id2619059"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="id2619064"></a><h3><a name="GimpSizeEntry-refval-changed"></a>The "refval-changed" signal</h3><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data);</pre><p>
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> a <a
href="../gtk/GtkWidget.html"
><span class="type">GtkWidget</span></a> pointer that you can attach a tooltip to.
</td></tr></tbody></table></div></div></div><div class="refsect1" lang="en"><a name="id2616280"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="id2616285"></a><h3><a name="GimpSizeEntry-refval-changed"></a>The "refval-changed" signal</h3><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gimpsizeentry</tt></i><EFBFBD>:</span></td><td>the object which received the signal.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_data</tt></i><EFBFBD>:</span></td><td>user data set when the signal handler was connected.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2619123"></a><h3><a name="GimpSizeEntry-unit-changed"></a>The "unit-changed" signal</h3><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data);</pre><p>
</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_data</tt></i><EFBFBD>:</span></td><td>user data set when the signal handler was connected.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616340"></a><h3><a name="GimpSizeEntry-unit-changed"></a>The "unit-changed" signal</h3><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gimpsizeentry</tt></i><EFBFBD>:</span></td><td>the object which received the signal.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_data</tt></i><EFBFBD>:</span></td><td>user data set when the signal handler was connected.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2619180"></a><h3><a name="GimpSizeEntry-value-changed"></a>The "value-changed" signal</h3><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
gpointer user_data);</pre><p>
</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_data</tt></i><EFBFBD>:</span></td><td>user data set when the signal handler was connected.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2616395"></a><h3><a name="GimpSizeEntry-value-changed"></a>The "value-changed" signal</h3><pre class="programlisting">void user_function (<a href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>gimpsizeentry</tt></i><EFBFBD>:</span></td><td>the object which received the signal.
</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_data</tt></i><EFBFBD>:</span></td><td>user data set when the signal handler was connected.</td></tr></tbody></table></div></div></div><div class="refsect1" lang="en"><a name="id2619238"></a><h2>See Also</h2><p>
</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_data</tt></i><EFBFBD>:</span></td><td>user data set when the signal handler was connected.</td></tr></tbody></table></div></div></div><div class="refsect1" lang="en"><a name="id2616452"></a><h2>See Also</h2><p>
<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
><span class="type">GimpUnit</span></a>