1336 lines
63 KiB
HTML
1336 lines
63 KiB
HTML
<!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</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
||
<link rel="start" 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.10 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
|
||
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
|
||
<link rel="chapter" href="libgimpwidgets-gallery.html" title="Widget Gallery">
|
||
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
|
||
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part II. GIMP Display Filters">
|
||
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part III. GIMP Color Selectors">
|
||
<link rel="part" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
|
||
<link rel="part" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
|
||
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
|
||
<link rel="index" href="libgimpwidgets-index.html" title="Index">
|
||
<link rel="index" href="libgimpwidgets-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
|
||
<link rel="index" href="libgimpwidgets-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
|
||
<link rel="index" href="libgimpwidgets-index-new-in-2-6.html" title="Index of new symbols in GIMP 2.6">
|
||
<link rel="index" href="libgimpwidgets-index-deprecated.html" title="Index of deprecated symbols">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
||
<tr valign="middle">
|
||
<td><a accesskey="p" href="GimpScrolledPreview.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="u" href="libgimpwidgets-widgets.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="GimpStringComboBox.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
||
</tr>
|
||
<tr><td colspan="5" class="shortcuts"><nobr><a href="#GimpSizeEntry.synopsis" class="shortcut">Top</a>
|
||
|
|
||
<a href="#GimpSizeEntry.description" class="shortcut">Description</a>
|
||
|
|
||
<a href="#GimpSizeEntry.object-hierarchy" class="shortcut">Object Hierarchy</a>
|
||
|
|
||
<a href="#GimpSizeEntry.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
|
||
|
|
||
<a href="#GimpSizeEntry.signals" class="shortcut">Signals</a></nobr></td></tr>
|
||
</table>
|
||
<div class="refentry" lang="en">
|
||
<a name="GimpSizeEntry"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="GimpSizeEntry.top_of_page"></a>GimpSizeEntry</span></h2>
|
||
<p>GimpSizeEntry — Widget for entering pixel values and resolutions.</p>
|
||
</td>
|
||
<td valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsynopsisdiv">
|
||
<a name="GimpSizeEntry.synopsis"></a><h2>Synopsis</h2>
|
||
<pre class="synopsis">
|
||
<a class="link" href="GimpSizeEntry.html#GimpSizeEntry-struct" title="GimpSizeEntry">GimpSizeEntry</a>;
|
||
<a class="link" href="GimpSizeEntry.html#GimpSizeEntryField" title="GimpSizeEntryField">GimpSizeEntryField</a>;
|
||
enum <a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a>;
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
|
||
>GtkWidget</a>* <a class="link" href="GimpSizeEntry.html#gimp-size-entry-new" title="gimp_size_entry_new ()">gimp_size_entry_new</a> (<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> number_of_fields,
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
|
||
>GimpUnit</a> unit,
|
||
const <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *unit_format,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> menu_show_pixels,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> menu_show_percent,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> show_refval,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> spinbutton_width,
|
||
<a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy);
|
||
void <a class="link" href="GimpSizeEntry.html#gimp-size-entry-add-field" title="gimp_size_entry_add_field ()">gimp_size_entry_add_field</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
>GtkSpinButton</a> *value_spinbutton,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
>GtkSpinButton</a> *refval_spinbutton);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
|
||
>GtkWidget</a>* <a class="link" href="GimpSizeEntry.html#gimp-size-entry-attach-label" title="gimp_size_entry_attach_label ()">gimp_size_entry_attach_label</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
const <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *text,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> row,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> column,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
|
||
>gfloat</a> alignment);
|
||
void <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-resolution" title="gimp_size_entry_set_resolution ()">gimp_size_entry_set_resolution</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> resolution,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> keep_size);
|
||
void <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-size" title="gimp_size_entry_set_size ()">gimp_size_entry_set_size</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> lower,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> upper);
|
||
void <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>
|
||
(<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> lower,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> upper);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> <a class="link" href="GimpSizeEntry.html#gimp-size-entry-get-value" title="gimp_size_entry_get_value ()">gimp_size_entry_get_value</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field);
|
||
void <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-value" title="gimp_size_entry_set_value ()">gimp_size_entry_set_value</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> value);
|
||
void <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>
|
||
(<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> lower,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> upper);
|
||
void <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> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> digits);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> <a class="link" href="GimpSizeEntry.html#gimp-size-entry-get-refval" title="gimp_size_entry_get_refval ()">gimp_size_entry_get_refval</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field);
|
||
void <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-refval" title="gimp_size_entry_set_refval ()">gimp_size_entry_set_refval</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> refval);
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
|
||
>GimpUnit</a> <a class="link" href="GimpSizeEntry.html#gimp-size-entry-get-unit" title="gimp_size_entry_get_unit ()">gimp_size_entry_get_unit</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);
|
||
void <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-unit" title="gimp_size_entry_set_unit ()">gimp_size_entry_set_unit</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
|
||
>GimpUnit</a> unit);
|
||
void <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> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> digits);
|
||
void <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> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> show);
|
||
void <a class="link" href="GimpSizeEntry.html#gimp-size-entry-grab-focus" title="gimp_size_entry_grab_focus ()">gimp_size_entry_grab_focus</a> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);
|
||
void <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>
|
||
(<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> setting);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
|
||
>GtkWidget</a>* <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> (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field);
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<a name="GimpSizeEntry.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="synopsis">
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
|
||
>GObject</a>
|
||
+----<a
|
||
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
|
||
>GInitiallyUnowned</a>
|
||
+----<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
|
||
>GtkObject</a>
|
||
+----<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
|
||
>GtkWidget</a>
|
||
+----<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
|
||
>GtkContainer</a>
|
||
+----<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkTable.html"
|
||
>GtkTable</a>
|
||
+----GimpSizeEntry
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<a name="GimpSizeEntry.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
|
||
<p>
|
||
GimpSizeEntry implements
|
||
AtkImplementorIface and <a
|
||
href="/usr/share/gtk-doc/html/gtk/gtk-gtkbuildable.html#GtkBuildable"
|
||
>GtkBuildable</a>.</p>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<a name="GimpSizeEntry.signals"></a><h2>Signals</h2>
|
||
<pre class="synopsis">
|
||
"<a class="link" href="GimpSizeEntry.html#GimpSizeEntry-refval-changed" title='The "refval-changed" signal'>refval-changed</a>" : Run First
|
||
"<a class="link" href="GimpSizeEntry.html#GimpSizeEntry-unit-changed" title='The "unit-changed" signal'>unit-changed</a>" : Run First
|
||
"<a class="link" href="GimpSizeEntry.html#GimpSizeEntry-value-changed" title='The "value-changed" signal'>value-changed</a>" : Run First
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<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 it's "value".
|
||
</p>
|
||
<p>
|
||
There is a <a class="link" href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> right of the entry fields which lets you
|
||
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 <a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
><span class="type">GtkSpinButton</span></a>'s to enter
|
||
"value" and "reference value". If you specify <em class="parameter"><code>show_refval</code></em> as <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
|
||
><span class="type">FALSE</span></a>
|
||
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 <a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
><span class="type">GtkSpinButton</span></a> and the
|
||
<a class="link" 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
|
||
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="../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="GimpSizeEntry.details"></a><h2>Details</h2>
|
||
<div class="refsect2" lang="en">
|
||
<a name="GimpSizeEntry-struct"></a><h3>GimpSizeEntry</h3>
|
||
<pre class="programlisting">typedef struct _GimpSizeEntry GimpSizeEntry;</pre>
|
||
<p>
|
||
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="GimpSizeEntryField"></a><h3>GimpSizeEntryField</h3>
|
||
<pre class="programlisting">typedef struct _GimpSizeEntryField GimpSizeEntryField;</pre>
|
||
<p>
|
||
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="GimpSizeEntryUpdatePolicy"></a><h3>enum GimpSizeEntryUpdatePolicy</h3>
|
||
<pre class="programlisting">typedef enum
|
||
{
|
||
GIMP_SIZE_ENTRY_UPDATE_NONE = 0,
|
||
GIMP_SIZE_ENTRY_UPDATE_SIZE = 1,
|
||
GIMP_SIZE_ENTRY_UPDATE_RESOLUTION = 2
|
||
} GimpSizeEntryUpdatePolicy;
|
||
</pre>
|
||
<p>
|
||
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-new"></a><h3>gimp_size_entry_new ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
|
||
>GtkWidget</a>* gimp_size_entry_new (<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> number_of_fields,
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
|
||
>GimpUnit</a> unit,
|
||
const <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *unit_format,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> menu_show_pixels,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> menu_show_percent,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> show_refval,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> spinbutton_width,
|
||
<a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy);</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>
|
||
<p>
|
||
1. <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>
|
||
<p>
|
||
2. (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>
|
||
<p>
|
||
3. <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-unit" title="gimp_size_entry_set_unit ()"><code class="function">gimp_size_entry_set_unit()</code></a>
|
||
</p>
|
||
<p>
|
||
For each input field:
|
||
</p>
|
||
<p>
|
||
4. <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-resolution" title="gimp_size_entry_set_resolution ()"><code class="function">gimp_size_entry_set_resolution()</code></a>
|
||
</p>
|
||
<p>
|
||
5. <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>
|
||
(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>
|
||
<p>
|
||
6. <a class="link" href="GimpSizeEntry.html#gimp-size-entry-set-size" title="gimp_size_entry_set_size ()"><code class="function">gimp_size_entry_set_size()</code></a>
|
||
</p>
|
||
<p>
|
||
7. <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> (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>
|
||
<p>
|
||
The <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> is derived from <a
|
||
href="/usr/share/gtk-doc/html/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 class="link" href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>number_of_fields</code></em> :</span></p></td>
|
||
<td> The number of input fields.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>unit</code></em> :</span></p></td>
|
||
<td> The initial unit.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>unit_format</code></em> :</span></p></td>
|
||
<td> 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>.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>menu_show_pixels</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
|
||
><code class="literal">TRUE</code></a> if the unit menu shold contain an item for
|
||
GIMP_UNIT_PIXEL (ignored if the <em class="parameter"><code>update_policy</code></em> is not
|
||
GIMP_SIZE_ENTRY_UPDATE_NONE).
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>menu_show_percent</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
|
||
><code class="literal">TRUE</code></a> if the unit menu shold contain an item for
|
||
GIMP_UNIT_PERCENT.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>show_refval</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
|
||
><code class="literal">TRUE</code></a> if you want an extra "reference value"
|
||
spinbutton per input field.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>spinbutton_width</code></em> :</span></p></td>
|
||
<td> The minimal horizontal size of the <a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
><span class="type">GtkSpinButton</span></a>'s.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>update_policy</code></em> :</span></p></td>
|
||
<td> How the automatic pixel <-> real-world-unit
|
||
calculations should be done.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> A Pointer to the new <a class="link" 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="gimp-size-entry-add-field"></a><h3>gimp_size_entry_add_field ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_add_field (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
>GtkSpinButton</a> *value_spinbutton,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
>GtkSpinButton</a> *refval_spinbutton);</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 <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
|
||
><code class="literal">TRUE</code></a> 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
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
><span class="type">GtkSpinButton</span></a> to hold the reference value. If <em class="parameter"><code>show_refval</code></em> was <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
|
||
><code class="literal">FALSE</code></a>,
|
||
<em class="parameter"><code>refval_spinbutton</code></em> will be ignored.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to add a field to.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>value_spinbutton</code></em> :</span></p></td>
|
||
<td> The spinbutton to display the field's value.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>refval_spinbutton</code></em> :</span></p></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="gimp-size-entry-attach-label"></a><h3>gimp_size_entry_attach_label ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
|
||
>GtkWidget</a>* gimp_size_entry_attach_label (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
const <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
|
||
>gchar</a> *text,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> row,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> column,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
|
||
>gfloat</a> alignment);</pre>
|
||
<p>
|
||
Attaches a <a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkLabel.html"
|
||
><span class="type">GtkLabel</span></a> to the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> (which is a <a
|
||
href="/usr/share/gtk-doc/html/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><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to add a label to.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
||
<td> The text of the label.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>row</code></em> :</span></p></td>
|
||
<td> The row where the label will be attached.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>column</code></em> :</span></p></td>
|
||
<td> The column where the label will be attached.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>alignment</code></em> :</span></p></td>
|
||
<td> The horizontal alignment of the label.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> A pointer to the new <a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkLabel.html"
|
||
><span class="type">GtkLabel</span></a> widget.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-set-resolution"></a><h3>gimp_size_entry_set_resolution ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_resolution (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> resolution,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> keep_size);</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="../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"
|
||
><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 <span class="type">GIMP_SIZE_ENTRY_UPDATE_SIZE</span>.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to set a resolution for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to set the resolution for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>resolution</code></em> :</span></p></td>
|
||
<td> The new resolution (in dpi) for the chosen <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>keep_size</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
|
||
><code class="literal">TRUE</code></a> if the <em class="parameter"><code>field</code></em>'s size in pixels should stay the same.
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
|
||
><code class="literal">FALSE</code></a> if the <em class="parameter"><code>field</code></em>'s size in units should stay the same.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-set-size"></a><h3>gimp_size_entry_set_size ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_size (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> lower,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> upper);</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 <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
|
||
><code class="literal">TRUE</code></a>
|
||
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="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to set a size for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to set the size for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>lower</code></em> :</span></p></td>
|
||
<td> The reference value which will be treated as 0%.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>upper</code></em> :</span></p></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="gimp-size-entry-set-value-boundaries"></a><h3>gimp_size_entry_set_value_boundaries ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_value_boundaries
|
||
(<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> lower,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> upper);</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to set value boundaries for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to set value boundaries for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>lower</code></em> :</span></p></td>
|
||
<td> The new lower boundary of the value of the chosen <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>upper</code></em> :</span></p></td>
|
||
<td> The new upper boundary of the value of the chosen <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-get-value"></a><h3>gimp_size_entry_get_value ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> gimp_size_entry_get_value (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field);</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="../libgimpbase/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="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to know a value of.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to know the value of.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> The value of the chosen <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-set-value"></a><h3>gimp_size_entry_set_value ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_value (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> value);</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="../libgimpbase/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="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to set a value for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to set a value for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
||
<td> The new value for <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-set-refval-boundaries"></a><h3>gimp_size_entry_set_refval_boundaries ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_refval_boundaries
|
||
(<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> lower,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> upper);</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to set the reference value boundaries for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to set the reference value
|
||
boundaries for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>lower</code></em> :</span></p></td>
|
||
<td> The new lower boundary of the reference value of the chosen <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>upper</code></em> :</span></p></td>
|
||
<td> The new upper boundary of the reference value of the chosen <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-set-refval-digits"></a><h3>gimp_size_entry_set_refval_digits ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_refval_digits (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> digits);</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 <span class="type">GIMP_SIZE_ENTRY_UPDATE_SIZE</span> and to 2 for
|
||
<span class="type">GIMP_SIZE_ENTRY_UPDATE_RESOLUTION</span>.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to set the reference value digits for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to set the reference value for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>digits</code></em> :</span></p></td>
|
||
<td> The new number of decimal digits for the <a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkSpinButton.html"
|
||
><span class="type">GtkSpinButton</span></a> which
|
||
displays <em class="parameter"><code>field</code></em>'s reference value.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-get-refval"></a><h3>gimp_size_entry_get_refval ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> gimp_size_entry_get_refval (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field);</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to know a reference value of.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to know the reference value of.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> The reference value of the chosen <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-set-refval"></a><h3>gimp_size_entry_set_refval ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_refval (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
|
||
>gdouble</a> refval);</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to set a reference value for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> The index of the field you want to set the reference value for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>refval</code></em> :</span></p></td>
|
||
<td> The new reference value for <em class="parameter"><code>field</code></em>.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-get-unit"></a><h3>gimp_size_entry_get_unit ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
|
||
>GimpUnit</a> gimp_size_entry_get_unit (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse);</pre>
|
||
<p>
|
||
Returns the <a
|
||
href="../libgimpbase/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="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><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to know the unit of.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> The sizeentry's unit.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-set-unit"></a><h3>gimp_size_entry_set_unit ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_unit (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
|
||
>GimpUnit</a> unit);</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> The sizeentry you want to change the unit for.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>unit</code></em> :</span></p></td>
|
||
<td> The new unit.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-set-pixel-digits"></a><h3>gimp_size_entry_set_pixel_digits ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_pixel_digits (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> digits);</pre>
|
||
<p>
|
||
Similar to <a class="link" href="GimpUnitMenu.html#gimp-unit-menu-set-pixel-digits" title="gimp_unit_menu_set_pixel_digits ()"><code class="function">gimp_unit_menu_set_pixel_digits()</code></a>, 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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>digits</code></em> :</span></p></td>
|
||
<td> the number of digits to display for a pixel size
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-show-unit-menu"></a><h3>gimp_size_entry_show_unit_menu ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_show_unit_menu (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> show);</pre>
|
||
<p>
|
||
Controls whether a unit menu is shown in the size entry. If
|
||
<em class="parameter"><code>show</code></em> is <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
|
||
><span class="type">TRUE</span></a>, the menu is shown; otherwise it is hidden.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>show</code></em> :</span></p></td>
|
||
<td> Boolean
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
<p class="since">Since GIMP 2.4
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-grab-focus"></a><h3>gimp_size_entry_grab_focus ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_grab_focus (<a class="link" 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 <a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-grab-focus"
|
||
><code class="function">gtk_widget_grab_focus()</code></a> for a <a
|
||
href="/usr/share/gtk-doc/html/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><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></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="gimp-size-entry-set-activates-default"></a><h3>gimp_size_entry_set_activates_default ()</h3>
|
||
<pre class="programlisting">void gimp_size_entry_set_activates_default
|
||
(<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
|
||
>gboolean</a> setting);</pre>
|
||
<p>
|
||
Iterates over all entries in the <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> and calls
|
||
<a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkEntry.html#gtk-entry-set-activates-default"
|
||
><code class="function">gtk_entry_set_activates_default()</code></a> on them.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> A <span class="type">GimpSizeEntr</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
|
||
><code class="literal">TRUE</code></a> to activate window's default widget on Enter keypress
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
<p class="since">Since GIMP 2.4
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="gimp-size-entry-get-help-widget"></a><h3>gimp_size_entry_get_help_widget ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
|
||
>GtkWidget</a>* gimp_size_entry_get_help_widget (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gse,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
|
||
>gint</a> field);</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>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gse</code></em> :</span></p></td>
|
||
<td> a <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
|
||
<td> the index of the widget you want to get a pointer to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/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="GimpSizeEntry.signal-details"></a><h2>Signal Details</h2>
|
||
<div class="refsect2" lang="en">
|
||
<a name="GimpSizeEntry-refval-changed"></a><h3>The <code class="literal">"refval-changed"</code> signal</h3>
|
||
<pre class="programlisting">void user_function (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
|
||
>gpointer</a> user_data) : Run First</pre>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gimpsizeentry</code></em> :</span></p></td>
|
||
<td>the object which received the signal.
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
||
<td>user data set when the signal handler was connected.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="GimpSizeEntry-unit-changed"></a><h3>The <code class="literal">"unit-changed"</code> signal</h3>
|
||
<pre class="programlisting">void user_function (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
|
||
>gpointer</a> user_data) : Run First</pre>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gimpsizeentry</code></em> :</span></p></td>
|
||
<td>the object which received the signal.
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
||
<td>user data set when the signal handler was connected.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="GimpSizeEntry-value-changed"></a><h3>The <code class="literal">"value-changed"</code> signal</h3>
|
||
<pre class="programlisting">void user_function (<a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry">GimpSizeEntry</a> *gimpsizeentry,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
|
||
>gpointer</a> user_data) : Run First</pre>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>gimpsizeentry</code></em> :</span></p></td>
|
||
<td>the object which received the signal.
|
||
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
||
<td>user data set when the signal handler was connected.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<a name="GimpSizeEntry.see-also"></a><h2>See Also</h2>
|
||
<p>
|
||
<a
|
||
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
|
||
><span class="type">GimpUnit</span></a>
|
||
</p>
|
||
<p>
|
||
<a class="link" href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a>
|
||
</p>
|
||
<p>
|
||
<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.10</div>
|
||
</body>
|
||
</html>
|