Files
gimp/devel-docs/libgimpwidgets/html/GimpSizeEntry.html
2021-07-18 14:31:43 -04:00

1200 lines
61 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GimpSizeEntry: GIMP Widgets Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GIMP Widgets Library Reference Manual">
<link rel="up" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
<link rel="prev" href="GimpScrolledPreview.html" title="GimpScrolledPreview">
<link rel="next" href="GimpStringComboBox.html" title="GimpStringComboBox">
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
<a href="#GimpSizeEntry.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
<a href="#GimpSizeEntry.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
<a href="#GimpSizeEntry.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_signals">  <span class="dim">|</span> 
<a href="#GimpSizeEntry.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="libgimpwidgets-widgets.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GimpScrolledPreview.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GimpStringComboBox.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GimpSizeEntry"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GimpSizeEntry.top_of_page"></a>GimpSizeEntry</span></h2>
<p>GimpSizeEntry — Widget for entering pixel values and resolutions.</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GimpSizeEntry.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">GtkWidget</span> *
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()">gimp_size_entry_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-add-field" title="gimp_size_entry_add_field ()">gimp_size_entry_add_field</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GtkWidget</span> *
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-attach-label" title="gimp_size_entry_attach_label ()">gimp_size_entry_attach_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-resolution" title="gimp_size_entry_set_resolution ()">gimp_size_entry_set_resolution</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-size" title="gimp_size_entry_set_size ()">gimp_size_entry_set_size</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-value-boundaries" title="gimp_size_entry_set_value_boundaries ()">gimp_size_entry_set_value_boundaries</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-get-value" title="gimp_size_entry_get_value ()">gimp_size_entry_get_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-value" title="gimp_size_entry_set_value ()">gimp_size_entry_set_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-refval-boundaries" title="gimp_size_entry_set_refval_boundaries ()">gimp_size_entry_set_refval_boundaries</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-refval-digits" title="gimp_size_entry_set_refval_digits ()">gimp_size_entry_set_refval_digits</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-get-refval" title="gimp_size_entry_get_refval ()">gimp_size_entry_get_refval</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-refval" title="gimp_size_entry_set_refval ()">gimp_size_entry_set_refval</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../html/libgimpbase-gimpunit.html#GimpUnit"><span class="returnvalue">GimpUnit</span></a>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-get-unit" title="gimp_size_entry_get_unit ()">gimp_size_entry_get_unit</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-unit" title="gimp_size_entry_set_unit ()">gimp_size_entry_set_unit</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-pixel-digits" title="gimp_size_entry_set_pixel_digits ()">gimp_size_entry_set_pixel_digits</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-show-unit-menu" title="gimp_size_entry_show_unit_menu ()">gimp_size_entry_show_unit_menu</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-grab-focus" title="gimp_size_entry_grab_focus ()">gimp_size_entry_grab_focus</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-activates-default" title="gimp_size_entry_set_activates_default ()">gimp_size_entry_set_activates_default</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GtkWidget</span> *
</td>
<td class="function_name">
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-get-help-widget" title="gimp_size_entry_get_help_widget ()">gimp_size_entry_get_help_widget</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GimpSizeEntry.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signal_proto_type">
<col width="300px" class="signal_proto_name">
<col width="200px" class="signal_proto_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GimpSizeEntry.html#GimpSizeEntry-refval-changed" title="The “refval-changed” signal">refval-changed</a></td>
<td class="signal_flags">Run First</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GimpSizeEntry.html#GimpSizeEntry-unit-changed" title="The “unit-changed” signal">unit-changed</a></td>
<td class="signal_flags">Run First</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GimpSizeEntry.html#GimpSizeEntry-value-changed" title="The “value-changed” signal">value-changed</a></td>
<td class="signal_flags">Run First</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GimpSizeEntry.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GimpSizeEntry.html#GimpSizeEntry-struct" title="GimpSizeEntry">GimpSizeEntry</a></td>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GimpSizeEntry.html#GimpSizeEntryField" title="GimpSizeEntryField">GimpSizeEntryField</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GimpSizeEntry.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<span class="lineart">╰──</span> GtkObject
<span class="lineart">╰──</span> GtkWidget
<span class="lineart">╰──</span> GtkContainer
<span class="lineart">╰──</span> GtkTable
<span class="lineart">╰──</span> GimpSizeEntry
</pre>
</div>
<div class="refsect1">
<a name="GimpSizeEntry.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GimpSizeEntry implements
AtkImplementorIface and GtkBuildable.</p>
</div>
<div class="refsect1">
<a name="GimpSizeEntry.description"></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
each field automatic mappings are performed between the field's
"reference value" and its "value".</p>
<p>There is a <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a> right of the entry fields which lets
you specify the <a href="../html/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 <em class="parameter"><code>show_refval</code></em>
as
<span class="type">FALSE</span> in <a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a> there will be only one
<span class="type">GtkSpinButton</span> and the <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</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 on which <a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> you specify in
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a>. The "value" is either the size in pixels
mapped to the size in a real-world-unit (see <a href="../html/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">
<a name="GimpSizeEntry.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gimp-size-entry-new"></a><h3>gimp_size_entry_new ()</h3>
<pre class="programlisting"><span class="returnvalue">GtkWidget</span> *
gimp_size_entry_new (<em class="parameter"><code><span class="type">gint</span> number_of_fields</code></em>,
<em class="parameter"><code><a href="../html/libgimpbase-gimpunit.html#GimpUnit"><span class="type">GimpUnit</span></a> unit</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *unit_format</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> menu_show_pixels</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> menu_show_percent</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> show_refval</code></em>,
<em class="parameter"><code><span class="type">gint</span> spinbutton_width</code></em>,
<em class="parameter"><code><a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> update_policy</code></em>);</pre>
<p>Creates a new <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.</p>
<p>To have all automatic calculations performed correctly, set up the
widget in the following order:</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p>gimp_size_entry_new()</p></li>
<li class="listitem"><p>(for each additional input field) <a class="link" href="GimpSizeEntry.html#gimp-size-entry-add-field" title="gimp_size_entry_add_field ()"><code class="function">gimp_size_entry_add_field()</code></a></p></li>
<li class="listitem"><p>gimp_size_entry_set_unit()</p></li>
</ol></div>
<p>For each input field:</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p>gimp_size_entry_set_resolution()</p></li>
<li class="listitem"><p>gimp_size_entry_set_refval_boundaries()
(or <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-value-boundaries" title="gimp_size_entry_set_value_boundaries ()"><code class="function">gimp_size_entry_set_value_boundaries()</code></a>)</p></li>
<li class="listitem"><p>gimp_size_entry_set_size()</p></li>
<li class="listitem"><p>gimp_size_entry_set_refval() (or <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-value" title="gimp_size_entry_set_value ()"><code class="function">gimp_size_entry_set_value()</code></a>)</p></li>
</ol></div>
<p>The <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> is derived from <span class="type">GtkTable</span> and will have
an empty border of one cell width on each side plus an empty column left
of the <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a> to allow the caller to add labels or a
<a class="link" href="GimpChainButton.html" title="GimpChainButton"><span class="type">GimpChainButton</span></a>.</p>
<div class="refsect3">
<a name="gimp-size-entry-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>number_of_fields</p></td>
<td class="parameter_description"><p>The number of input fields.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unit</p></td>
<td class="parameter_description"><p>The initial unit.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unit_format</p></td>
<td class="parameter_description"><p>A printf-like unit-format string as is used with
<a class="link" href="GimpUnitMenu.html#gimp-unit-menu-new" title="gimp_unit_menu_new ()"><code class="function">gimp_unit_menu_new()</code></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>menu_show_pixels</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the unit menu should 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).</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>menu_show_percent</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the unit menu should contain an item for
GIMP_UNIT_PERCENT.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>show_refval</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if you want an extra "reference value"
spinbutton per input field.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>spinbutton_width</p></td>
<td class="parameter_description"><p>The minimal horizontal size of the <span class="type">GtkSpinButton</span>'s.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>update_policy</p></td>
<td class="parameter_description"><p>How the automatic pixel &lt;-&gt; real-world-unit
calculations should be done.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-size-entry-new.returns"></a><h4>Returns</h4>
<p> A Pointer to the new <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-add-field"></a><h3>gimp_size_entry_add_field ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_add_field (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">GtkSpinButton</span> *value_spinbutton</code></em>,
<em class="parameter"><code><span class="type">GtkSpinButton</span> *refval_spinbutton</code></em>);</pre>
<p>Adds an input field to the <a class="link" 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 <em class="parameter"><code>show_refval</code></em>
as <code class="literal">TRUE</code> in <a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a> you have to pass an additional
<span class="type">GtkSpinButton</span> to hold the reference value. If <em class="parameter"><code>show_refval</code></em>
was <code class="literal">FALSE</code>,
<em class="parameter"><code>refval_spinbutton</code></em>
will be ignored.</p>
<div class="refsect3">
<a name="gimp-size-entry-add-field.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to add a field to.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value_spinbutton</p></td>
<td class="parameter_description"><p>The spinbutton to display the field's value.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>refval_spinbutton</p></td>
<td class="parameter_description"><p>The spinbutton to display the field's reference value.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-attach-label"></a><h3>gimp_size_entry_attach_label ()</h3>
<pre class="programlisting"><span class="returnvalue">GtkWidget</span> *
gimp_size_entry_attach_label (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
<em class="parameter"><code><span class="type">gint</span> row</code></em>,
<em class="parameter"><code><span class="type">gint</span> column</code></em>,
<em class="parameter"><code><span class="type">gfloat</span> alignment</code></em>);</pre>
<p>Attaches a <span class="type">GtkLabel</span> to the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> (which is a <span class="type">GtkTable</span>).</p>
<div class="refsect3">
<a name="gimp-size-entry-attach-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to add a label to.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>text</p></td>
<td class="parameter_description"><p>The text of the label.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>row</p></td>
<td class="parameter_description"><p>The row where the label will be attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column</p></td>
<td class="parameter_description"><p>The column where the label will be attached.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>alignment</p></td>
<td class="parameter_description"><p>The horizontal alignment of the label.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-size-entry-attach-label.returns"></a><h4>Returns</h4>
<p> A pointer to the new <span class="type">GtkLabel</span> widget.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-resolution"></a><h3>gimp_size_entry_set_resolution ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_resolution (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> resolution</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> keep_size</code></em>);</pre>
<p>Sets the resolution (in dpi) for field # <em class="parameter"><code>field</code></em>
of the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.</p>
<p>The <em class="parameter"><code>resolution</code></em>
passed will be clamped to fit in
[<a href="../html/libgimpbase-gimplimits.html#GIMP-MIN-RESOLUTION:CAPS"><span class="type">GIMP_MIN_RESOLUTION</span></a>..<a href="../html/libgimpbase-gimplimits.html#GIMP-MAX-RESOLUTION:CAPS"><span class="type">GIMP_MAX_RESOLUTION</span></a>].</p>
<p>This function does nothing if the <a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> specified in
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a> doesn't equal to <a class="link" href="GimpSizeEntry.html#GIMP-SIZE-ENTRY-UPDATE-SIZE:CAPS"><span class="type">GIMP_SIZE_ENTRY_UPDATE_SIZE</span></a>.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-resolution.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to set a resolution for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to set the resolution for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>resolution</p></td>
<td class="parameter_description"><p>The new resolution (in dpi) for the chosen <em class="parameter"><code>field</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>keep_size</p></td>
<td class="parameter_description"><p><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.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-size"></a><h3>gimp_size_entry_set_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_size (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> lower</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> upper</code></em>);</pre>
<p>Sets the pixel values for field # <em class="parameter"><code>field</code></em>
of the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
which will be treated as 0% and 100%.</p>
<p>These values will be used if you specified <em class="parameter"><code>menu_show_percent</code></em>
as <code class="literal">TRUE</code>
in <a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a> and the user has selected GIMP_UNIT_PERCENT in
the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a>.</p>
<p>This function does nothing if the <a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> specified in
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a> doesn't equal to GIMP_SIZE_ENTRY_UPDATE_SIZE.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-size.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to set a size for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to set the size for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>lower</p></td>
<td class="parameter_description"><p>The reference value which will be treated as 0%.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>upper</p></td>
<td class="parameter_description"><p>The reference value which will be treated as 100%.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-value-boundaries"></a><h3>gimp_size_entry_set_value_boundaries ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_value_boundaries (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> lower</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> upper</code></em>);</pre>
<p>Limits the range of possible values which can be entered in field # <em class="parameter"><code>field</code></em>
of the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.</p>
<p>The current value of the <em class="parameter"><code>field</code></em>
will be clamped to fit in the <em class="parameter"><code>field</code></em>
's
new boundaries.</p>
<p>NOTE: In most cases you won't be interested in this function because the
<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s purpose is to shield the programmer from unit
calculations. Use <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-refval-boundaries" title="gimp_size_entry_set_refval_boundaries ()"><code class="function">gimp_size_entry_set_refval_boundaries()</code></a> instead.
Whatever you do, don't mix these calls. A size entry should either
be clamped by the value or the reference value.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-value-boundaries.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to set value boundaries for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to set value boundaries for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>lower</p></td>
<td class="parameter_description"><p>The new lower boundary of the value of the chosen <em class="parameter"><code>field</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>upper</p></td>
<td class="parameter_description"><p>The new upper boundary of the value of the chosen <em class="parameter"><code>field</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-get-value"></a><h3>gimp_size_entry_get_value ()</h3>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
gimp_size_entry_get_value (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>);</pre>
<p>Returns the value of field # <em class="parameter"><code>field</code></em>
of the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.</p>
<p>The <em class="parameter"><code>value</code></em>
returned is a distance or resolution
in the <a href="../html/libgimpbase-gimpunit.html#GimpUnit"><span class="type">GimpUnit</span></a> the user has selected in the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s
<a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a>.</p>
<p>NOTE: In most cases you won't be interested in this value because the
<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s purpose is to shield the programmer from unit
calculations. Use <a class="link" href="GimpSizeEntry.html#gimp-size-entry-get-refval" title="gimp_size_entry_get_refval ()"><code class="function">gimp_size_entry_get_refval()</code></a> instead.</p>
<div class="refsect3">
<a name="gimp-size-entry-get-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to know a value of.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to know the value of.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-size-entry-get-value.returns"></a><h4>Returns</h4>
<p> The value of the chosen <em class="parameter"><code>field</code></em>
.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-value"></a><h3>gimp_size_entry_set_value ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_value (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> value</code></em>);</pre>
<p>Sets the value for field # <em class="parameter"><code>field</code></em>
of the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.</p>
<p>The <em class="parameter"><code>value</code></em>
passed is treated to be a distance or resolution
in the <a href="../html/libgimpbase-gimpunit.html#GimpUnit"><span class="type">GimpUnit</span></a> the user has selected in the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s
<a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a>.</p>
<p>NOTE: In most cases you won't be interested in this value because the
<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s purpose is to shield the programmer from unit
calculations. Use <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-refval" title="gimp_size_entry_set_refval ()"><code class="function">gimp_size_entry_set_refval()</code></a> instead.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to set a value for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to set a value for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>The new value for <em class="parameter"><code>field</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-refval-boundaries"></a><h3>gimp_size_entry_set_refval_boundaries ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_refval_boundaries (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> lower</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> upper</code></em>);</pre>
<p>Limits the range of possible reference values which can be entered in
field # <em class="parameter"><code>field</code></em>
of the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.</p>
<p>The current reference value of the <em class="parameter"><code>field</code></em>
will be clamped to fit in the
<em class="parameter"><code>field</code></em>
's new boundaries.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-refval-boundaries.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to set the reference value boundaries for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to set the reference value
boundaries for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>lower</p></td>
<td class="parameter_description"><p>The new lower boundary of the reference value of the chosen <em class="parameter"><code>field</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>upper</p></td>
<td class="parameter_description"><p>The new upper boundary of the reference value of the chosen <em class="parameter"><code>field</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-refval-digits"></a><h3>gimp_size_entry_set_refval_digits ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_refval_digits (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>,
<em class="parameter"><code><span class="type">gint</span> digits</code></em>);</pre>
<p>Sets the decimal digits of field # <em class="parameter"><code>field</code></em>
of the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> to
<em class="parameter"><code>digits</code></em>
.</p>
<p>If you don't specify this value explicitly, the reference value's number
of digits will equal to 0 for <a class="link" href="GimpSizeEntry.html#GIMP-SIZE-ENTRY-UPDATE-SIZE:CAPS"><span class="type">GIMP_SIZE_ENTRY_UPDATE_SIZE</span></a> and to 2 for
<a class="link" href="GimpSizeEntry.html#GIMP-SIZE-ENTRY-UPDATE-RESOLUTION:CAPS"><span class="type">GIMP_SIZE_ENTRY_UPDATE_RESOLUTION</span></a>.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-refval-digits.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to set the reference value digits for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to set the reference value for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>digits</p></td>
<td class="parameter_description"><p>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.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-get-refval"></a><h3>gimp_size_entry_get_refval ()</h3>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
gimp_size_entry_get_refval (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>);</pre>
<p>Returns the reference value for field # <em class="parameter"><code>field</code></em>
of the <a class="link" 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
in dpi, depending on which <a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> you chose in
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a>.</p>
<div class="refsect3">
<a name="gimp-size-entry-get-refval.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to know a reference value of.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to know the reference value of.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-size-entry-get-refval.returns"></a><h4>Returns</h4>
<p> The reference value of the chosen <em class="parameter"><code>field</code></em>
.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-refval"></a><h3>gimp_size_entry_set_refval ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_refval (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> refval</code></em>);</pre>
<p>Sets the reference value for field # <em class="parameter"><code>field</code></em>
of the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.</p>
<p>The <em class="parameter"><code>refval</code></em>
passed is either a distance in pixels or a resolution in dpi,
depending on which <a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> you chose in
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a>.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-refval.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to set a reference value for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>The index of the field you want to set the reference value for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>refval</p></td>
<td class="parameter_description"><p>The new reference value for <em class="parameter"><code>field</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-get-unit"></a><h3>gimp_size_entry_get_unit ()</h3>
<pre class="programlisting"><a href="../html/libgimpbase-gimpunit.html#GimpUnit"><span class="returnvalue">GimpUnit</span></a>
gimp_size_entry_get_unit (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>);</pre>
<p>Returns the <a href="../html/libgimpbase-gimpunit.html#GimpUnit"><span class="type">GimpUnit</span></a> the user has selected in the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s
<a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a>.</p>
<div class="refsect3">
<a name="gimp-size-entry-get-unit.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to know the unit of.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-size-entry-get-unit.returns"></a><h4>Returns</h4>
<p> The sizeentry's unit.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-unit"></a><h3>gimp_size_entry_set_unit ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_unit (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><a href="../html/libgimpbase-gimpunit.html#GimpUnit"><span class="type">GimpUnit</span></a> unit</code></em>);</pre>
<p>Sets the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s unit. The reference value for all fields will
stay the same but the value in units or pixels per unit will change
according to which <a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> you chose in
<a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()"><code class="function">gimp_size_entry_new()</code></a>.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-unit.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to change the unit for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>unit</p></td>
<td class="parameter_description"><p>The new unit.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-pixel-digits"></a><h3>gimp_size_entry_set_pixel_digits ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_pixel_digits (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> digits</code></em>);</pre>
<p>This function allows you set up a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> so that sub-pixel
sizes can be entered.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-pixel-digits.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>digits</p></td>
<td class="parameter_description"><p>the number of digits to display for a pixel size</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-show-unit-menu"></a><h3>gimp_size_entry_show_unit_menu ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_show_unit_menu (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> show</code></em>);</pre>
<p>Controls whether a unit menu is shown in the size entry. If
<em class="parameter"><code>show</code></em>
is <span class="type">TRUE</span>, the menu is shown; otherwise it is hidden.</p>
<div class="refsect3">
<a name="gimp-size-entry-show-unit-menu.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>show</p></td>
<td class="parameter_description"><p>Boolean</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-grab-focus"></a><h3>gimp_size_entry_grab_focus ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_grab_focus (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>);</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>
<div class="refsect3">
<a name="gimp-size-entry-grab-focus.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>The sizeentry you want to grab the keyboard focus.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-set-activates-default"></a><h3>gimp_size_entry_set_activates_default ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gimp_size_entry_set_activates_default (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
<p>Iterates over all entries in the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> and calls
<code class="function">gtk_entry_set_activates_default()</code> on them.</p>
<div class="refsect3">
<a name="gimp-size-entry-set-activates-default.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>A <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>setting</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> to activate window's default widget on Enter keypress</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-size-entry-get-help-widget"></a><h3>gimp_size_entry_get_help_widget ()</h3>
<pre class="programlisting"><span class="returnvalue">GtkWidget</span> *
gimp_size_entry_get_help_widget (<em class="parameter"><code><a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gse</code></em>,
<em class="parameter"><code><span class="type">gint</span> field</code></em>);</pre>
<p>You shouldn't fiddle with the internals of a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> but
if you want to set tooltips using <a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-set-help-data" title="gimp_help_set_help_data ()"><code class="function">gimp_help_set_help_data()</code></a> you
can use this function to get a pointer to the spinbuttons.</p>
<div class="refsect3">
<a name="gimp-size-entry-get-help-widget.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gse</p></td>
<td class="parameter_description"><p>a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>field</p></td>
<td class="parameter_description"><p>the index of the widget you want to get a pointer to</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-size-entry-get-help-widget.returns"></a><h4>Returns</h4>
<p> a <span class="type">GtkWidget</span> pointer that you can attach a tooltip to.</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="GimpSizeEntry.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GimpSizeEntry-struct"></a><h3>GimpSizeEntry</h3>
<pre class="programlisting">typedef struct _GimpSizeEntry GimpSizeEntry;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GimpSizeEntryField"></a><h3>GimpSizeEntryField</h3>
<pre class="programlisting">typedef struct _GimpSizeEntryField GimpSizeEntryField;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GimpSizeEntryUpdatePolicy"></a><h3>enum GimpSizeEntryUpdatePolicy</h3>
<p>Update policies for <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.</p>
<div class="refsect3">
<a name="GimpSizeEntryUpdatePolicy.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GIMP-SIZE-ENTRY-UPDATE-NONE:CAPS"></a>GIMP_SIZE_ENTRY_UPDATE_NONE</p></td>
<td class="enum_member_description">
<p>the size entry's meaning is up to the user</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GIMP-SIZE-ENTRY-UPDATE-SIZE:CAPS"></a>GIMP_SIZE_ENTRY_UPDATE_SIZE</p></td>
<td class="enum_member_description">
<p>the size entry displays values</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GIMP-SIZE-ENTRY-UPDATE-RESOLUTION:CAPS"></a>GIMP_SIZE_ENTRY_UPDATE_RESOLUTION</p></td>
<td class="enum_member_description">
<p>the size entry displays resolutions</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GimpSizeEntry.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GimpSizeEntry-refval-changed"></a><h3>The <code class="literal">“refval-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gimpsizeentry,
<span class="type">gpointer</span> user_data)</pre>
<p>Flags: Run First</p>
</div>
<hr>
<div class="refsect2">
<a name="GimpSizeEntry-unit-changed"></a><h3>The <code class="literal">“unit-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gimpsizeentry,
<span class="type">gpointer</span> user_data)</pre>
<p>Flags: Run First</p>
</div>
<hr>
<div class="refsect2">
<a name="GimpSizeEntry-value-changed"></a><h3>The <code class="literal">“value-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> *gimpsizeentry,
<span class="type">gpointer</span> user_data)</pre>
<p>Flags: Run First</p>
</div>
</div>
<div class="refsect1">
<a name="GimpSizeEntry.see-also"></a><h2>See Also</h2>
<p><a href="../html/libgimpbase-gimpunit.html#GimpUnit"><span class="type">GimpUnit</span></a>, <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a>, <a class="link" href="libgimpwidgets-GimpWidgets.html#gimp-coordinates-new" title="gimp_coordinates_new ()"><code class="function">gimp_coordinates_new()</code></a></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>