1587 lines
71 KiB
HTML
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 V. GIMP Widgets Utilities">
|
|
<link rel="prev" href="libgimpwidgets-GimpPropWidgets.html" title="GimpPropWidgets">
|
|
<link rel="next" href="libgimpwidgets-deprecated.html" title="Part VI. 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 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-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>
|
|
 | 
|
|
<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 — 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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</span></td>
|
|
<td> The initial value of the spinbutton.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
|
|
<td> The lower boundary.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
|
|
<td> The uppper boundary.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>step_increment</code></em> :</span></td>
|
|
<td> The spinbutton's step increment.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>page_increment</code></em> :</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> :</span></td>
|
|
<td> The spinbutton's page size.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>climb_rate</code></em> :</span></td>
|
|
<td> The spinbutton's climb rate.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
|
|
<td> The spinbutton's number of decimal digits.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</span></td>
|
|
<td> The column to start with.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>row</code></em> :</span></td>
|
|
<td> The row to attach the widgets.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>text</code></em> :</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> :</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> :</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> :</span></td>
|
|
<td> The initial value.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
|
|
<td> The lower boundary.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
|
|
<td> The upper boundary.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>step_increment</code></em> :</span></td>
|
|
<td> The step increment.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>page_increment</code></em> :</span></td>
|
|
<td> The page increment.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
|
|
<td> The number of decimal digits.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>constrain</code></em> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</span></td>
|
|
<td> The column to start with.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>row</code></em> :</span></td>
|
|
<td> The row to attach the widgets.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>text</code></em> :</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> :</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> :</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> :</span></td>
|
|
<td> The initial value.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
|
|
<td> The lower boundary.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
|
|
<td> The upper boundary.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>step_increment</code></em> :</span></td>
|
|
<td> The step increment.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>page_increment</code></em> :</span></td>
|
|
<td> The page increment.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
|
|
<td> The number of decimal digits.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>tooltip</code></em> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</span></td>
|
|
<td> The label for the X coordinate.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>x</code></em> :</span></td>
|
|
<td> The initial value of the X coordinate.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>xres</code></em> :</span></td>
|
|
<td> The horizontal resolution in DPI.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>lower_boundary_x</code></em> :</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> :</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> :</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> :</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> :</span></td>
|
|
<td> The label for the Y coordinate.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>y</code></em> :</span></td>
|
|
<td> The initial value of the Y coordinate.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>yres</code></em> :</span></td>
|
|
<td> The vertical resolution in DPI.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>lower_boundary_y</code></em> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</span></td>
|
|
<td> A <span class="type">GtkToggleButton</span>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>data</code></em> :</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> :</span></td>
|
|
<td> A <span class="type">GtkRadioButton</span>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>data</code></em> :</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> :</span></td>
|
|
<td> A <span class="type">GtkAdjustment</span>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>data</code></em> :</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> :</span></td>
|
|
<td> A <span class="type">GtkAdjustment</span>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>data</code></em> :</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> :</span></td>
|
|
<td> A <span class="type">GtkAdjustment</span>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>data</code></em> :</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> :</span></td>
|
|
<td> A <span class="type">GtkAdjustment</span>.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>data</code></em> :</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> :</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> :</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> :</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> :</span></td>
|
|
<td> The column to start with.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>row</code></em> :</span></td>
|
|
<td> The row to attach the widgets.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>label_text</code></em> :</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> :</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> :</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> :</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> :</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> :</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> :</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> :</span></td>
|
|
<td> a <span class="type">GtkLabel</span>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="term"><em class="parameter"><code>...</code></em> :</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>
|