Files
gimp/devel-docs/libgimpwidgets/html/libgimpwidgets-GimpWidgets.html
2010-08-11 01:21:39 -04:00

1587 lines
71 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GimpWidgets</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
<link rel="up" href="libgimpwidgets-utils.html" title="Part&#160;V.&#160;GIMP Widgets Utilities">
<link rel="prev" href="libgimpwidgets-GimpPropWidgets.html" title="GimpPropWidgets">
<link rel="next" href="libgimpwidgets-deprecated.html" title="Part&#160;VI.&#160;Deprecated API">
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="libgimpwidgets-widgets.html" title="Part&#160;I.&#160;GIMP Widgets">
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
<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&#160;II.&#160;GIMP Display Filters">
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part&#160;III.&#160;GIMP Color Selectors">
<link rel="part" href="libgimpwidgets-controller.html" title="Part&#160;IV.&#160;GIMP Controllers">
<link rel="part" href="libgimpwidgets-utils.html" title="Part&#160;V.&#160;GIMP Widgets Utilities">
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part&#160;VI.&#160;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-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="libgimpwidgets-GimpPropWidgets.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="libgimpwidgets-utils.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
<td><a accesskey="n" href="libgimpwidgets-deprecated.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="#id2597297" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2676266" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimpwidgets-GimpWidgets"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2597297"></a><span class="refentrytitle">GimpWidgets</span>
</h2>
<p>GimpWidgets &#8212; A collection of convenient widget constructors, standard callbacks and
helper functions.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
GtkWidget* <a href="libgimpwidgets-GimpWidgets.html#gimp-radio-group-new">gimp_radio_group_new</a> (gboolean in_frame,
const gchar *frame_title,
...);
GtkWidget* <a href="libgimpwidgets-GimpWidgets.html#gimp-radio-group-new2">gimp_radio_group_new2</a> (gboolean in_frame,
const gchar *frame_title,
GCallback radio_button_callback,
gpointer radio_button_callback_data,
gpointer initial,
...);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-radio-group-set-active">gimp_radio_group_set_active</a> (GtkRadioButton *radio_button,
gpointer item_data);
GtkWidget* <a href="libgimpwidgets-GimpWidgets.html#gimp-int-radio-group-new">gimp_int_radio_group_new</a> (gboolean in_frame,
const gchar *frame_title,
GCallback radio_button_callback,
gpointer radio_button_callback_data,
gint initial,
...);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-int-radio-group-set-active">gimp_int_radio_group_set_active</a> (GtkRadioButton *radio_button,
gint item_data);
GtkWidget* <a href="libgimpwidgets-GimpWidgets.html#gimp-spin-button-new">gimp_spin_button_new</a> (GtkObject **adjustment,
gdouble value,
gdouble lower,
gdouble upper,
gdouble step_increment,
gdouble page_increment,
gdouble page_size,
gdouble climb_rate,
guint digits);
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-SCALE-ENTRY-LABEL:CAPS">GIMP_SCALE_ENTRY_LABEL</a> (adj)
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-SCALE-ENTRY-SCALE:CAPS">GIMP_SCALE_ENTRY_SCALE</a> (adj)
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-SCALE-ENTRY-SCALE-ADJ:CAPS">GIMP_SCALE_ENTRY_SCALE_ADJ</a> (adj)
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-SCALE-ENTRY-SPINBUTTON:CAPS">GIMP_SCALE_ENTRY_SPINBUTTON</a> (adj)
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-SCALE-ENTRY-SPINBUTTON-ADJ:CAPS">GIMP_SCALE_ENTRY_SPINBUTTON_ADJ</a> (adj)
GtkObject* <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new">gimp_scale_entry_new</a> (GtkTable *table,
gint column,
gint row,
const gchar *text,
gint scale_width,
gint spinbutton_width,
gdouble value,
gdouble lower,
gdouble upper,
gdouble step_increment,
gdouble page_increment,
guint digits,
gboolean constrain,
gdouble unconstrained_lower,
gdouble unconstrained_upper,
const gchar *tooltip,
const gchar *help_id);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-set-sensitive">gimp_scale_entry_set_sensitive</a> (GtkObject *adjustment,
gboolean sensitive);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-set-logarithmic">gimp_scale_entry_set_logarithmic</a> (GtkObject *adjustment,
gboolean logarithmic);
gboolean <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-get-logarithmic">gimp_scale_entry_get_logarithmic</a> (GtkObject *adjustment);
GtkObject* <a href="libgimpwidgets-GimpWidgets.html#gimp-color-scale-entry-new">gimp_color_scale_entry_new</a> (GtkTable *table,
gint column,
gint row,
const gchar *text,
gint scale_width,
gint spinbutton_width,
gdouble value,
gdouble lower,
gdouble upper,
gdouble step_increment,
gdouble page_increment,
guint digits,
const gchar *tooltip,
const gchar *help_id);
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-RANDOM-SEED-SPINBUTTON:CAPS">GIMP_RANDOM_SEED_SPINBUTTON</a> (hbox)
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-RANDOM-SEED-SPINBUTTON-ADJ:CAPS">GIMP_RANDOM_SEED_SPINBUTTON_ADJ</a> (hbox)
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-RANDOM-SEED-TOGGLE:CAPS">GIMP_RANDOM_SEED_TOGGLE</a> (hbox)
GtkWidget* <a href="libgimpwidgets-GimpWidgets.html#gimp-random-seed-new">gimp_random_seed_new</a> (guint32 *seed,
gboolean *random_seed);
#define <a href="libgimpwidgets-GimpWidgets.html#GIMP-COORDINATES-CHAINBUTTON:CAPS">GIMP_COORDINATES_CHAINBUTTON</a> (sizeentry)
GtkWidget* <a href="libgimpwidgets-GimpWidgets.html#gimp-coordinates-new">gimp_coordinates_new</a> (<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> unit,
const gchar *unit_format,
gboolean menu_show_pixels,
gboolean menu_show_percent,
gint spinbutton_width,
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
gboolean chainbutton_active,
gboolean chain_constrains_ratio,
const gchar *xlabel,
gdouble x,
gdouble xres,
gdouble lower_boundary_x,
gdouble upper_boundary_x,
gdouble xsize_0,
gdouble xsize_100,
const gchar *ylabel,
gdouble y,
gdouble yres,
gdouble lower_boundary_y,
gdouble upper_boundary_y,
gdouble ysize_0,
gdouble ysize_100);
GtkWidget* <a href="libgimpwidgets-GimpWidgets.html#gimp-pixmap-button-new">gimp_pixmap_button_new</a> (gchar **xpm_data,
const gchar *text);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-toggle-button-sensitive-update">gimp_toggle_button_sensitive_update</a> (GtkToggleButton *toggle_button);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-toggle-button-update">gimp_toggle_button_update</a> (GtkWidget *widget,
gpointer data);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-radio-button-update">gimp_radio_button_update</a> (GtkWidget *widget,
gpointer data);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-int-adjustment-update">gimp_int_adjustment_update</a> (GtkAdjustment *adjustment,
gpointer data);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-uint-adjustment-update">gimp_uint_adjustment_update</a> (GtkAdjustment *adjustment,
gpointer data);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-float-adjustment-update">gimp_float_adjustment_update</a> (GtkAdjustment *adjustment,
gpointer data);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-double-adjustment-update">gimp_double_adjustment_update</a> (GtkAdjustment *adjustment,
gpointer data);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-unit-menu-update">gimp_unit_menu_update</a> (GtkWidget *widget,
gpointer data);
GtkWidget* <a href="libgimpwidgets-GimpWidgets.html#gimp-table-attach-aligned">gimp_table_attach_aligned</a> (GtkTable *table,
gint column,
gint row,
const gchar *label_text,
gfloat xalign,
gfloat yalign,
GtkWidget *widget,
gint colspan,
gboolean left_align);
void <a href="libgimpwidgets-GimpWidgets.html#gimp-label-set-attributes">gimp_label_set_attributes</a> (GtkLabel *label,
...);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2676266"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2676282"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2676292"></a><h3>
<a name="gimp-radio-group-new"></a>gimp_radio_group_new ()</h3>
<a class="indexterm" name="id2676304"></a><pre class="programlisting">GtkWidget* gimp_radio_group_new (gboolean in_frame,
const gchar *frame_title,
...);</pre>
<p>
Convenience function to create a group of radio buttons embedded into
a <span class="type">GtkFrame</span> or <span class="type">GtkVbox</span>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>in_frame</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if you want a <span class="type">GtkFrame</span> around the radio button group.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>frame_title</code></em>&#160;:</span></td>
<td> The title of the Frame or <code class="literal">NULL</code> if you don't want a title.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td> A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing the radio buttons.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <span class="type">GtkFrame</span> or <span class="type">GtkVbox</span> (depending on <em class="parameter"><code>in_frame</code></em>).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676478"></a><h3>
<a name="gimp-radio-group-new2"></a>gimp_radio_group_new2 ()</h3>
<a class="indexterm" name="id2676489"></a><pre class="programlisting">GtkWidget* gimp_radio_group_new2 (gboolean in_frame,
const gchar *frame_title,
GCallback radio_button_callback,
gpointer radio_button_callback_data,
gpointer initial,
...);</pre>
<p>
Convenience function to create a group of radio buttons embedded into
a <span class="type">GtkFrame</span> or <span class="type">GtkVbox</span>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>in_frame</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if you want a <span class="type">GtkFrame</span> around the
radio button group.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>frame_title</code></em>&#160;:</span></td>
<td> The title of the Frame or <code class="literal">NULL</code> if you don't want
a title.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>radio_button_callback</code></em>&#160;:</span></td>
<td> The callback each button's "toggled" signal will
be connected with.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>radio_button_callback_data</code></em>&#160;:</span></td>
<td>
The data which will be passed to <code class="function">g_signal_connect()</code>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>item_data</code></em> of the initially pressed radio button.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td> A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing
the radio buttons.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <span class="type">GtkFrame</span> or <span class="type">GtkVbox</span> (depending on <em class="parameter"><code>in_frame</code></em>).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676748"></a><h3>
<a name="gimp-radio-group-set-active"></a>gimp_radio_group_set_active ()</h3>
<a class="indexterm" name="id2676760"></a><pre class="programlisting">void gimp_radio_group_set_active (GtkRadioButton *radio_button,
gpointer item_data);</pre>
<p>
Calls <code class="function">gtk_toggle_button_set_active()</code> with the radio button that was
created with a matching <em class="parameter"><code>item_data</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>radio_button</code></em>&#160;:</span></td>
<td> Pointer to a <span class="type">GtkRadioButton</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>item_data</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>item_data</code></em> of the radio button you want to select.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2676862"></a><h3>
<a name="gimp-int-radio-group-new"></a>gimp_int_radio_group_new ()</h3>
<a class="indexterm" name="id2676873"></a><pre class="programlisting">GtkWidget* gimp_int_radio_group_new (gboolean in_frame,
const gchar *frame_title,
GCallback radio_button_callback,
gpointer radio_button_callback_data,
gint initial,
...);</pre>
<p>
Convenience function to create a group of radio buttons embedded into
a <span class="type">GtkFrame</span> or <span class="type">GtkVbox</span>. This function does the same thing as
<a href="libgimpwidgets-GimpWidgets.html#gimp-radio-group-new2"><code class="function">gimp_radio_group_new2()</code></a>, but it takes integers as <em class="parameter"><code>item_data</code></em> instead of
pointers, since that is a very common case (mapping an enum to a radio
group).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>in_frame</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if you want a <span class="type">GtkFrame</span> around the
radio button group.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>frame_title</code></em>&#160;:</span></td>
<td> The title of the Frame or <code class="literal">NULL</code> if you don't want
a title.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>radio_button_callback</code></em>&#160;:</span></td>
<td> The callback each button's "toggled" signal will
be connected with.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>radio_button_callback_data</code></em>&#160;:</span></td>
<td>
The data which will be passed to <code class="function">g_signal_connect()</code>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>item_data</code></em> of the initially pressed radio button.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td> A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> describing
the radio buttons.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <span class="type">GtkFrame</span> or <span class="type">GtkVbox</span> (depending on <em class="parameter"><code>in_frame</code></em>).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677148"></a><h3>
<a name="gimp-int-radio-group-set-active"></a>gimp_int_radio_group_set_active ()</h3>
<a class="indexterm" name="id2677162"></a><pre class="programlisting">void gimp_int_radio_group_set_active (GtkRadioButton *radio_button,
gint item_data);</pre>
<p>
Calls <code class="function">gtk_toggle_button_set_active()</code> with the radio button that was created
with a matching <em class="parameter"><code>item_data</code></em>. This function does the same thing as
<a href="libgimpwidgets-GimpWidgets.html#gimp-radio-group-set-active"><code class="function">gimp_radio_group_set_active()</code></a>, but takes integers as <em class="parameter"><code>item_data</code></em> instead
of pointers.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>radio_button</code></em>&#160;:</span></td>
<td> Pointer to a <span class="type">GtkRadioButton</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>item_data</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>item_data</code></em> of the radio button you want to select.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677262"></a><h3>
<a name="gimp-spin-button-new"></a>gimp_spin_button_new ()</h3>
<a class="indexterm" name="id2677272"></a><pre class="programlisting">GtkWidget* gimp_spin_button_new (GtkObject **adjustment,
gdouble value,
gdouble lower,
gdouble upper,
gdouble step_increment,
gdouble page_increment,
gdouble page_size,
gdouble climb_rate,
guint digits);</pre>
<p>
This function is a shortcut for <code class="function">gtk_adjustment_new()</code> and a
subsequent <code class="function">gtk_spin_button_new()</code>. It also calls
<code class="function">gtk_spin_button_set_numeric()</code> so that non-numeric text cannot be
entered.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>adjustment</code></em>&#160;:</span></td>
<td> Returns the spinbutton's <span class="type">GtkAdjustment</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
<td> The initial value of the spinbutton.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td> The lower boundary.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td> The uppper boundary.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>step_increment</code></em>&#160;:</span></td>
<td> The spinbutton's step increment.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>page_increment</code></em>&#160;:</span></td>
<td> The spinbutton's page increment (mouse button 2).
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>page_size</code></em>&#160;:</span></td>
<td> The spinbutton's page size.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>climb_rate</code></em>&#160;:</span></td>
<td> The spinbutton's climb rate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td> The spinbutton's number of decimal digits.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <span class="type">GtkSpinbutton</span> and it's <span class="type">GtkAdjustment</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677532"></a><h3>
<a name="GIMP-SCALE-ENTRY-LABEL:CAPS"></a>GIMP_SCALE_ENTRY_LABEL()</h3>
<a class="indexterm" name="id2677542"></a><pre class="programlisting">#define GIMP_SCALE_ENTRY_LABEL(adj)</pre>
<p>
Returns the scale_entry's <span class="type">GtkLabel</span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>adj</code></em>&#160;:</span></td>
<td>The <span class="type">GtkAdjustment</span> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677594"></a><h3>
<a name="GIMP-SCALE-ENTRY-SCALE:CAPS"></a>GIMP_SCALE_ENTRY_SCALE()</h3>
<a class="indexterm" name="id2677605"></a><pre class="programlisting">#define GIMP_SCALE_ENTRY_SCALE(adj)</pre>
<p>
Returns the scale_entry's <span class="type">GtkHScale</span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>adj</code></em>&#160;:</span></td>
<td>The <span class="type">GtkAdjustment</span> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677657"></a><h3>
<a name="GIMP-SCALE-ENTRY-SCALE-ADJ:CAPS"></a>GIMP_SCALE_ENTRY_SCALE_ADJ()</h3>
<a class="indexterm" name="id2677669"></a><pre class="programlisting">#define GIMP_SCALE_ENTRY_SCALE_ADJ(adj)</pre>
<p>
Returns the <span class="type">GtkAdjustment</span> of the scale_entry's <span class="type">GtkHScale</span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>adj</code></em>&#160;:</span></td>
<td>The <span class="type">GtkAdjustment</span> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677728"></a><h3>
<a name="GIMP-SCALE-ENTRY-SPINBUTTON:CAPS"></a>GIMP_SCALE_ENTRY_SPINBUTTON()</h3>
<a class="indexterm" name="id2677740"></a><pre class="programlisting">#define GIMP_SCALE_ENTRY_SPINBUTTON(adj)</pre>
<p>
Returns the scale_entry's <span class="type">GtkSpinButton</span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>adj</code></em>&#160;:</span></td>
<td>The <span class="type">GtkAdjustment</span> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677792"></a><h3>
<a name="GIMP-SCALE-ENTRY-SPINBUTTON-ADJ:CAPS"></a>GIMP_SCALE_ENTRY_SPINBUTTON_ADJ()</h3>
<a class="indexterm" name="id2677806"></a><pre class="programlisting">#define GIMP_SCALE_ENTRY_SPINBUTTON_ADJ(adj)</pre>
<p>
Returns the <span class="type">GtkAdjustment</span> of the scale_entry's <span class="type">GtkSpinButton</span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>adj</code></em>&#160;:</span></td>
<td>The <span class="type">GtkAdjustment</span> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2677865"></a><h3>
<a name="gimp-scale-entry-new"></a>gimp_scale_entry_new ()</h3>
<a class="indexterm" name="id2677875"></a><pre class="programlisting">GtkObject* gimp_scale_entry_new (GtkTable *table,
gint column,
gint row,
const gchar *text,
gint scale_width,
gint spinbutton_width,
gdouble value,
gdouble lower,
gdouble upper,
gdouble step_increment,
gdouble page_increment,
guint digits,
gboolean constrain,
gdouble unconstrained_lower,
gdouble unconstrained_upper,
const gchar *tooltip,
const gchar *help_id);</pre>
<p>
This function creates a <span class="type">GtkLabel</span>, a <span class="type">GtkHScale</span> and a <span class="type">GtkSpinButton</span> and
attaches them to a 3-column <span class="type">GtkTable</span>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>table</code></em>&#160;:</span></td>
<td> The <span class="type">GtkTable</span> the widgets will be attached to.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>column</code></em>&#160;:</span></td>
<td> The column to start with.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>row</code></em>&#160;:</span></td>
<td> The row to attach the widgets.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
<td> The text for the <span class="type">GtkLabel</span> which will appear
left of the <span class="type">GtkHScale</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>scale_width</code></em>&#160;:</span></td>
<td> The minimum horizontal size of the <span class="type">GtkHScale</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>spinbutton_width</code></em>&#160;:</span></td>
<td> The minimum horizontal size of the <span class="type">GtkSpinButton</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
<td> The initial value.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td> The lower boundary.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td> The upper boundary.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>step_increment</code></em>&#160;:</span></td>
<td> The step increment.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>page_increment</code></em>&#160;:</span></td>
<td> The page increment.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td> The number of decimal digits.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>constrain</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the range of possible values of the
<span class="type">GtkSpinButton</span> should be the same as of the <span class="type">GtkHScale</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>unconstrained_lower</code></em>&#160;:</span></td>
<td> The spinbutton's lower boundary
if <em class="parameter"><code>constrain</code></em> == <code class="literal">FALSE</code>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>unconstrained_upper</code></em>&#160;:</span></td>
<td> The spinbutton's upper boundary
if <em class="parameter"><code>constrain</code></em> == <code class="literal">FALSE</code>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>tooltip</code></em>&#160;:</span></td>
<td> A tooltip message for the scale and the spinbutton.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
<td> The widgets' help_id (see <a href="libgimpwidgets-GimpHelpUI.html#gimp-help-set-help-data"><code class="function">gimp_help_set_help_data()</code></a>).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The <span class="type">GtkSpinButton</span>'s <span class="type">GtkAdjustment</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678375"></a><h3>
<a name="gimp-scale-entry-set-sensitive"></a>gimp_scale_entry_set_sensitive ()</h3>
<a class="indexterm" name="id2678388"></a><pre class="programlisting">void gimp_scale_entry_set_sensitive (GtkObject *adjustment,
gboolean sensitive);</pre>
<p>
Sets the sensitivity of the scale_entry's <span class="type">GtkLabel</span>, <span class="type">GtkHScale</span> and
<span class="type">GtkSpinbutton</span>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>adjustment</code></em>&#160;:</span></td>
<td> a <span class="type">GtkAdjustment</span> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>sensitive</code></em>&#160;:</span></td>
<td> a boolean value with the same semantics as the <em class="parameter"><code>sensitive</code></em>
parameter of <code class="function">gtk_widget_set_sensitive()</code>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678500"></a><h3>
<a name="gimp-scale-entry-set-logarithmic"></a>gimp_scale_entry_set_logarithmic ()</h3>
<a class="indexterm" name="id2678514"></a><pre class="programlisting">void gimp_scale_entry_set_logarithmic (GtkObject *adjustment,
gboolean logarithmic);</pre>
<p>
Sets whether the scale_entry's scale widget will behave in a linear
or logharithmic fashion. Useful when an entry has to attend large
ranges, but smaller selections on that range require a finer
adjustment.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>adjustment</code></em>&#160;:</span></td>
<td> a <span class="type">GtkAdjustment</span> as returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>logarithmic</code></em>&#160;:</span></td>
<td> a boolean value to set or reset logarithmic behaviour
of the scale widget
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678604"></a><h3>
<a name="gimp-scale-entry-get-logarithmic"></a>gimp_scale_entry_get_logarithmic ()</h3>
<a class="indexterm" name="id2678618"></a><pre class="programlisting">gboolean gimp_scale_entry_get_logarithmic (GtkObject *adjustment);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>adjustment</code></em>&#160;:</span></td>
<td> a <span class="type">GtkAdjustment</span> as returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the the entry's scale widget will behave in
logharithmic fashion, <code class="literal">FALSE</code> for linear behaviour.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2678711"></a><h3>
<a name="gimp-color-scale-entry-new"></a>gimp_color_scale_entry_new ()</h3>
<a class="indexterm" name="id2678722"></a><pre class="programlisting">GtkObject* gimp_color_scale_entry_new (GtkTable *table,
gint column,
gint row,
const gchar *text,
gint scale_width,
gint spinbutton_width,
gdouble value,
gdouble lower,
gdouble upper,
gdouble step_increment,
gdouble page_increment,
guint digits,
const gchar *tooltip,
const gchar *help_id);</pre>
<p>
This function creates a <span class="type">GtkLabel</span>, a <a href="GimpColorScale.html" title="GimpColorScale"><span class="type">GimpColorScale</span></a> and a
<span class="type">GtkSpinButton</span> and attaches them to a 3-column <span class="type">GtkTable</span>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>table</code></em>&#160;:</span></td>
<td> The <span class="type">GtkTable</span> the widgets will be attached to.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>column</code></em>&#160;:</span></td>
<td> The column to start with.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>row</code></em>&#160;:</span></td>
<td> The row to attach the widgets.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
<td> The text for the <span class="type">GtkLabel</span> which will appear
left of the <span class="type">GtkHScale</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>scale_width</code></em>&#160;:</span></td>
<td> The minimum horizontal size of the <span class="type">GtkHScale</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>spinbutton_width</code></em>&#160;:</span></td>
<td> The minimum horizontal size of the <span class="type">GtkSpinButton</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
<td> The initial value.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
<td> The lower boundary.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
<td> The upper boundary.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>step_increment</code></em>&#160;:</span></td>
<td> The step increment.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>page_increment</code></em>&#160;:</span></td>
<td> The page increment.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td> The number of decimal digits.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>tooltip</code></em>&#160;:</span></td>
<td> A tooltip message for the scale and the spinbutton.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
<td> The widgets' help_id (see <a href="libgimpwidgets-GimpHelpUI.html#gimp-help-set-help-data"><code class="function">gimp_help_set_help_data()</code></a>).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The <span class="type">GtkSpinButton</span>'s <span class="type">GtkAdjustment</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679114"></a><h3>
<a name="GIMP-RANDOM-SEED-SPINBUTTON:CAPS"></a>GIMP_RANDOM_SEED_SPINBUTTON()</h3>
<a class="indexterm" name="id2679126"></a><pre class="programlisting">#define GIMP_RANDOM_SEED_SPINBUTTON(hbox)</pre>
<p>
Returns the random_seed's <span class="type">GtkSpinButton</span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>hbox</code></em>&#160;:</span></td>
<td>The <span class="type">GtkHBox</span> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-random-seed-new"><code class="function">gimp_random_seed_new()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679178"></a><h3>
<a name="GIMP-RANDOM-SEED-SPINBUTTON-ADJ:CAPS"></a>GIMP_RANDOM_SEED_SPINBUTTON_ADJ()</h3>
<a class="indexterm" name="id2679192"></a><pre class="programlisting">#define GIMP_RANDOM_SEED_SPINBUTTON_ADJ(hbox)</pre>
<p>
Returns the <span class="type">GtkAdjustment</span> of the random_seed's <span class="type">GtkSpinButton</span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>hbox</code></em>&#160;:</span></td>
<td>The <span class="type">GtkHBox</span> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-random-seed-new"><code class="function">gimp_random_seed_new()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679251"></a><h3>
<a name="GIMP-RANDOM-SEED-TOGGLE:CAPS"></a>GIMP_RANDOM_SEED_TOGGLE()</h3>
<a class="indexterm" name="id2679263"></a><pre class="programlisting">#define GIMP_RANDOM_SEED_TOGGLE(hbox)</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>hbox</code></em>&#160;:</span></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679295"></a><h3>
<a name="gimp-random-seed-new"></a>gimp_random_seed_new ()</h3>
<a class="indexterm" name="id2679305"></a><pre class="programlisting">GtkWidget* gimp_random_seed_new (guint32 *seed,
gboolean *random_seed);</pre>
<p>
Creates a widget that allows the user to control how the random number
generator is initialized.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>seed</code></em>&#160;:</span></td>
<td> A pointer to the variable which stores the random seed.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>random_seed</code></em>&#160;:</span></td>
<td> A pointer to a boolean indicating whether seed should be
initialised randomly or not.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <span class="type">GtkHBox</span> containing a <span class="type">GtkSpinButton</span> for the seed and
a <span class="type">GtkButton</span> for setting a random seed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679402"></a><h3>
<a name="GIMP-COORDINATES-CHAINBUTTON:CAPS"></a>GIMP_COORDINATES_CHAINBUTTON()</h3>
<a class="indexterm" name="id2679414"></a><pre class="programlisting">#define GIMP_COORDINATES_CHAINBUTTON(sizeentry)</pre>
<p>
Returns the <a href="GimpChainButton.html" title="GimpChainButton"><span class="type">GimpChainButton</span></a> which is attached to the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>sizeentry</code></em>&#160;:</span></td>
<td>The <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> returned by <a href="libgimpwidgets-GimpWidgets.html#gimp-coordinates-new"><code class="function">gimp_coordinates_new()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2679473"></a><h3>
<a name="gimp-coordinates-new"></a>gimp_coordinates_new ()</h3>
<a class="indexterm" name="id2679484"></a><pre class="programlisting">GtkWidget* gimp_coordinates_new (<a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
>GimpUnit</a> unit,
const gchar *unit_format,
gboolean menu_show_pixels,
gboolean menu_show_percent,
gint spinbutton_width,
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
gboolean chainbutton_active,
gboolean chain_constrains_ratio,
const gchar *xlabel,
gdouble x,
gdouble xres,
gdouble lower_boundary_x,
gdouble upper_boundary_x,
gdouble xsize_0,
gdouble xsize_100,
const gchar *ylabel,
gdouble y,
gdouble yres,
gdouble lower_boundary_y,
gdouble upper_boundary_y,
gdouble ysize_0,
gdouble ysize_100);</pre>
<p>
Convenience function that creates a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> with two fields for x/y
coordinates/sizes with a <a href="GimpChainButton.html" title="GimpChainButton"><span class="type">GimpChainButton</span></a> attached to constrain either the
two fields' values or the ratio between them.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
<td> The initial unit of the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>unit_format</code></em>&#160;:</span></td>
<td> A printf-like unit-format string as is used with
<a href="GimpUnitMenu.html#gimp-unit-menu-new"><code class="function">gimp_unit_menu_new()</code></a>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>menu_show_pixels</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> should contain an item
for GIMP_UNIT_PIXEL.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>menu_show_percent</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> should contain an item
for GIMP_UNIT_PERCENT.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>spinbutton_width</code></em>&#160;:</span></td>
<td> The horizontal size of the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>'s
<span class="type">GtkSpinButton</span>'s.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>update_policy</code></em>&#160;:</span></td>
<td> The update policy for the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>chainbutton_active</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the attached <a href="GimpChainButton.html" title="GimpChainButton"><span class="type">GimpChainButton</span></a> should be
active.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>chain_constrains_ratio</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the chainbutton should constrain the
fields' aspect ratio. If <code class="literal">FALSE</code>, the values will
be constrained.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>xlabel</code></em>&#160;:</span></td>
<td> The label for the X coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></td>
<td> The initial value of the X coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>xres</code></em>&#160;:</span></td>
<td> The horizontal resolution in DPI.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>lower_boundary_x</code></em>&#160;:</span></td>
<td> The lower boundary of the X coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>upper_boundary_x</code></em>&#160;:</span></td>
<td> The upper boundary of the X coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>xsize_0</code></em>&#160;:</span></td>
<td> The X value which will be treated as 0%.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>xsize_100</code></em>&#160;:</span></td>
<td> The X value which will be treated as 100%.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>ylabel</code></em>&#160;:</span></td>
<td> The label for the Y coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></td>
<td> The initial value of the Y coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>yres</code></em>&#160;:</span></td>
<td> The vertical resolution in DPI.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>lower_boundary_y</code></em>&#160;:</span></td>
<td> The lower boundary of the Y coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>upper_boundary_y</code></em>&#160;:</span></td>
<td> The upper boundary of the Y coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>ysize_0</code></em>&#160;:</span></td>
<td> The Y value which will be treated as 0%.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>ysize_100</code></em>&#160;:</span></td>
<td> The Y value which will be treated as 100%.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680132"></a><h3>
<a name="gimp-pixmap-button-new"></a>gimp_pixmap_button_new ()</h3>
<a class="indexterm" name="id2680148"></a><pre class="programlisting">GtkWidget* gimp_pixmap_button_new (gchar **xpm_data,
const gchar *text);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gimp_pixmap_button_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Convenience function that creates a <span class="type">GtkButton</span> with a <a href="GimpPixmap.html" title="GimpPixmap"><span class="type">GimpPixmap</span></a>
and an optional <span class="type">GtkLabel</span>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>xpm_data</code></em>&#160;:</span></td>
<td> The XPM data which will be passed to <a href="GimpPixmap.html#gimp-pixmap-new"><code class="function">gimp_pixmap_new()</code></a>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
<td> An optional text which will appear right of the pixmap.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The new <span class="type">GtkButton</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680283"></a><h3>
<a name="gimp-toggle-button-sensitive-update"></a>gimp_toggle_button_sensitive_update ()</h3>
<a class="indexterm" name="id2680298"></a><pre class="programlisting">void gimp_toggle_button_sensitive_update (GtkToggleButton *toggle_button);</pre>
<p>
If you attached a pointer to a <span class="type">GtkWidget</span> with <code class="function">g_object_set_data()</code> and
the "set_sensitive" key to the <span class="type">GtkToggleButton</span>, the sensitive state of
the attached widget will be set according to the toggle button's
"active" state.
</p>
<p>
You can attach an arbitrary list of widgets by attaching another
"set_sensitive" data pointer to the first widget (and so on...).
</p>
<p>
This function can also set the sensitive state according to the toggle
button's inverse "active" state by attaching widgets with the
"inverse_sensitive" key.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><em class="parameter"><code>toggle_button</code></em>&#160;:</span></td>
<td> The <span class="type">GtkToggleButton</span> the "set_sensitive" and
"inverse_sensitive" lists are attached to.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680396"></a><h3>
<a name="gimp-toggle-button-update"></a>gimp_toggle_button_update ()</h3>
<a class="indexterm" name="id2680410"></a><pre class="programlisting">void gimp_toggle_button_update (GtkWidget *widget,
gpointer data);</pre>
<p>
Note that this function calls <a href="libgimpwidgets-GimpWidgets.html#gimp-toggle-button-sensitive-update"><code class="function">gimp_toggle_button_sensitive_update()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
<td> A <span class="type">GtkToggleButton</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
<td> A pointer to a <span class="type">gint</span> variable which will store the value of
<code class="function">gtk_toggle_button_get_active()</code>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680517"></a><h3>
<a name="gimp-radio-button-update"></a>gimp_radio_button_update ()</h3>
<a class="indexterm" name="id2680531"></a><pre class="programlisting">void gimp_radio_button_update (GtkWidget *widget,
gpointer data);</pre>
<p>
Note that this function calls <a href="libgimpwidgets-GimpWidgets.html#gimp-toggle-button-sensitive-update"><code class="function">gimp_toggle_button_sensitive_update()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
<td> A <span class="type">GtkRadioButton</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
<td> A pointer to a <span class="type">gint</span> variable which will store the value of
GPOINTER_TO_INT (g_object_get_data (<em class="parameter"><code>widget</code></em>, "gimp-item-data")).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680635"></a><h3>
<a name="gimp-int-adjustment-update"></a>gimp_int_adjustment_update ()</h3>
<a class="indexterm" name="id2680649"></a><pre class="programlisting">void gimp_int_adjustment_update (GtkAdjustment *adjustment,
gpointer data);</pre>
<p>
Note that the <span class="type">GtkAdjustment</span>'s value (which is a <span class="type">gdouble</span>) will be
rounded with <a
href="../libgimpmath/libgimpmath-GimpMath.html#RINT:CAPS"
><code class="function">RINT()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>adjustment</code></em>&#160;:</span></td>
<td> A <span class="type">GtkAdjustment</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
<td> A pointer to a <span class="type">gint</span> variable which will store the
<em class="parameter"><code>adjustment</code></em>'s value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680766"></a><h3>
<a name="gimp-uint-adjustment-update"></a>gimp_uint_adjustment_update ()</h3>
<a class="indexterm" name="id2680780"></a><pre class="programlisting">void gimp_uint_adjustment_update (GtkAdjustment *adjustment,
gpointer data);</pre>
<p>
Note that the <span class="type">GtkAdjustment</span>'s value (which is a <span class="type">gdouble</span>) will be rounded
with (<span class="type">guint</span>) (value + 0.5).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>adjustment</code></em>&#160;:</span></td>
<td> A <span class="type">GtkAdjustment</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
<td> A pointer to a <span class="type">guint</span> variable which will store the
<em class="parameter"><code>adjustment</code></em>'s value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2680895"></a><h3>
<a name="gimp-float-adjustment-update"></a>gimp_float_adjustment_update ()</h3>
<a class="indexterm" name="id2680909"></a><pre class="programlisting">void gimp_float_adjustment_update (GtkAdjustment *adjustment,
gpointer data);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>adjustment</code></em>&#160;:</span></td>
<td> A <span class="type">GtkAdjustment</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
<td> A pointer to a <span class="type">gfloat</span> varaiable which will store the
<em class="parameter"><code>adjustment</code></em>'s value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2681002"></a><h3>
<a name="gimp-double-adjustment-update"></a>gimp_double_adjustment_update ()</h3>
<a class="indexterm" name="id2681017"></a><pre class="programlisting">void gimp_double_adjustment_update (GtkAdjustment *adjustment,
gpointer data);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>adjustment</code></em>&#160;:</span></td>
<td> A <span class="type">GtkAdjustment</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
<td> A pointer to a <span class="type">gdouble</span> variable which will store the
<em class="parameter"><code>adjustment</code></em>'s value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2681110"></a><h3>
<a name="gimp-unit-menu-update"></a>gimp_unit_menu_update ()</h3>
<a class="indexterm" name="id2681124"></a><pre class="programlisting">void gimp_unit_menu_update (GtkWidget *widget,
gpointer data);</pre>
<p>
This callback can set the number of decimal digits of an arbitrary number
of <span class="type">GtkSpinButton</span>'s. To use this functionality, attach the spinbuttons
as list of data pointers attached with <code class="function">g_object_set_data()</code> with the
"set_digits" key.
</p>
<p>
See <a href="libgimpwidgets-GimpWidgets.html#gimp-toggle-button-sensitive-update"><code class="function">gimp_toggle_button_sensitive_update()</code></a> for a description of how
to set up the list.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
<td> A <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
<td> A pointer to a <a
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
><span class="type">GimpUnit</span></a> variable which will store the unit menu's
value.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2681245"></a><h3>
<a name="gimp-table-attach-aligned"></a>gimp_table_attach_aligned ()</h3>
<a class="indexterm" name="id2681259"></a><pre class="programlisting">GtkWidget* gimp_table_attach_aligned (GtkTable *table,
gint column,
gint row,
const gchar *label_text,
gfloat xalign,
gfloat yalign,
GtkWidget *widget,
gint colspan,
gboolean left_align);</pre>
<p>
Note that the <em class="parameter"><code>label_text</code></em> can be <code class="literal">NULL</code> and that the widget will be
attached starting at (<em class="parameter"><code>column</code></em> + 1) in this case, too.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>table</code></em>&#160;:</span></td>
<td> The <span class="type">GtkTable</span> the widgets will be attached to.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>column</code></em>&#160;:</span></td>
<td> The column to start with.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>row</code></em>&#160;:</span></td>
<td> The row to attach the widgets.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>label_text</code></em>&#160;:</span></td>
<td> The text for the <span class="type">GtkLabel</span> which will be attached left of
the widget.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>xalign</code></em>&#160;:</span></td>
<td> The horizontal alignment of the <span class="type">GtkLabel</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>yalign</code></em>&#160;:</span></td>
<td> The vertival alignment of the <span class="type">GtkLabel</span>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>widget</code></em>&#160;:</span></td>
<td> The <span class="type">GtkWidget</span> to attach right of the label.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>colspan</code></em>&#160;:</span></td>
<td> The number of columns the widget will use.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>left_align</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the widget should be left-aligned.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The created <span class="type">GtkLabel</span>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2681568"></a><h3>
<a name="gimp-label-set-attributes"></a>gimp_label_set_attributes ()</h3>
<a class="indexterm" name="id2681585"></a><pre class="programlisting">void gimp_label_set_attributes (GtkLabel *label,
...);</pre>
<p>
Sets Pango attributes on a <span class="type">GtkLabel</span> in a more convenient way than
<code class="function">gtk_label_set_attributes()</code>.
</p>
<p>
This function is useful if you want to change the font attributes
of a <span class="type">GtkLabel</span>. This is an alternative to using PangoMarkup which
is slow to parse and akward to handle in an i18n-friendly way.
</p>
<p>
The attributes are set on the complete label, from start to end. If
you need to set attributes on part of the label, you will have to
use the PangoAttributes API directly.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
<td> a <span class="type">GtkLabel</span>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td> a list of PangoAttrType and value pairs terminated by -1.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since GIMP 2.2
</p>
</div>
</div>
</div>
</body>
</html>