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

1709 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>GimpPropWidgets</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-GimpEnumWidgets.html" title="GimpEnumWidgets">
<link rel="next" href="libgimpwidgets-GimpWidgets.html" title="GimpWidgets">
<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-GimpEnumWidgets.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-GimpWidgets.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="#id2592528" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2669321" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimpwidgets-GimpPropWidgets"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2592528"></a><span class="refentrytitle">GimpPropWidgets</span>
</h2>
<p>GimpPropWidgets</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-boolean-combo-box-new">gimp_prop_boolean_combo_box_new</a> (GObject *config,
const gchar *property_name,
const gchar *true_text,
const gchar *false_text);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-boolean-radio-frame-new">gimp_prop_boolean_radio_frame_new</a> (GObject *config,
const gchar *property_name,
const gchar *title,
const gchar *true_text,
const gchar *false_text);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-check-button-new">gimp_prop_check_button_new</a> (GObject *config,
const gchar *property_name,
const gchar *label);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-color-area-new">gimp_prop_color_area_new</a> (GObject *config,
const gchar *property_name,
gint width,
gint height,
<a href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> type);
gboolean <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-connect">gimp_prop_coordinates_connect</a> (GObject *config,
const gchar *x_property_name,
const gchar *y_property_name,
const gchar *unit_property_name,
GtkWidget *sizeentry,
GtkWidget *chainbutton,
gdouble xresolution,
gdouble yresolution);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-new">gimp_prop_coordinates_new</a> (GObject *config,
const gchar *x_property_name,
const gchar *y_property_name,
const gchar *unit_property_name,
const gchar *unit_format,
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
gdouble xresolution,
gdouble yresolution,
gboolean has_chainbutton);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new">gimp_prop_entry_new</a> (GObject *config,
const gchar *property_name,
gint max_len);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-check-button-new">gimp_prop_enum_check_button_new</a> (GObject *config,
const gchar *property_name,
const gchar *label,
gint false_value,
gint true_value);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-combo-box-new">gimp_prop_enum_combo_box_new</a> (GObject *config,
const gchar *property_name,
gint minimum,
gint maximum);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-label-new">gimp_prop_enum_label_new</a> (GObject *config,
const gchar *property_name);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-box-new">gimp_prop_enum_radio_box_new</a> (GObject *config,
const gchar *property_name,
gint minimum,
gint maximum);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-frame-new">gimp_prop_enum_radio_frame_new</a> (GObject *config,
const gchar *property_name,
const gchar *title,
gint minimum,
gint maximum);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-stock-box-new">gimp_prop_enum_stock_box_new</a> (GObject *config,
const gchar *property_name,
const gchar *stock_prefix,
gint minimum,
gint maximum);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-expander-new">gimp_prop_expander_new</a> (GObject *config,
const gchar *property_name,
const gchar *label);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-file-chooser-button-new">gimp_prop_file_chooser_button_new</a> (GObject *config,
const gchar *property_name,
const gchar *title,
GtkFileChooserAction action);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-file-chooser-button-new-with-dialog">gimp_prop_file_chooser_button_new_with_dialog</a>
(GObject *config,
const gchar *property_name,
GtkWidget *dialog);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-hscale-new">gimp_prop_hscale_new</a> (GObject *config,
const gchar *property_name,
gdouble step_increment,
gdouble page_increment,
gint digits);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-int-combo-box-new">gimp_prop_int_combo_box_new</a> (GObject *config,
const gchar *property_name,
<a href="GimpIntStore.html" title="GimpIntStore">GimpIntStore</a> *store);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-label-new">gimp_prop_label_new</a> (GObject *config,
const gchar *property_name);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-memsize-entry-new">gimp_prop_memsize_entry_new</a> (GObject *config,
const gchar *property_name);
GtkObject* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-opacity-entry-new">gimp_prop_opacity_entry_new</a> (GObject *config,
const gchar *property_name,
GtkTable *table,
gint column,
gint row,
const gchar *label);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-path-editor-new">gimp_prop_path_editor_new</a> (GObject *config,
const gchar *path_property_name,
const gchar *writable_property_name,
const gchar *filesel_title);
GtkObject* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-scale-entry-new">gimp_prop_scale_entry_new</a> (GObject *config,
const gchar *property_name,
GtkTable *table,
gint column,
gint row,
const gchar *label,
gdouble step_increment,
gdouble page_increment,
gint digits,
gboolean limit_scale,
gdouble lower_limit,
gdouble upper_limit);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-size-entry-new">gimp_prop_size_entry_new</a> (GObject *config,
const gchar *property_name,
const gchar *unit_property_name,
const gchar *unit_format,
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
gdouble resolution);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-spin-button-new">gimp_prop_spin_button_new</a> (GObject *config,
const gchar *property_name,
gdouble step_increment,
gdouble page_increment,
gint digits);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-stock-image-new">gimp_prop_stock_image_new</a> (GObject *config,
const gchar *property_name,
GtkIconSize icon_size);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-string-combo-box-new">gimp_prop_string_combo_box_new</a> (GObject *config,
const gchar *property_name,
GtkTreeModel *model,
gint id_column,
gint label_column);
GtkTextBuffer* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-text-buffer-new">gimp_prop_text_buffer_new</a> (GObject *config,
const gchar *property_name,
gint max_len);
GtkWidget* <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-unit-menu-new">gimp_prop_unit_menu_new</a> (GObject *config,
const gchar *property_name,
const gchar *unit_format);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2669321"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2669337"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2669348"></a><h3>
<a name="gimp-prop-boolean-combo-box-new"></a>gimp_prop_boolean_combo_box_new ()</h3>
<a class="indexterm" name="id2669361"></a><pre class="programlisting">GtkWidget* gimp_prop_boolean_combo_box_new (GObject *config,
const gchar *property_name,
const gchar *true_text,
const gchar *false_text);</pre>
<p>
Creates a <span class="type">GtkComboBox</span> widget to display and set the specified
boolean property. The combo box will have two entries, one
displaying the <em class="parameter"><code>true_text</code></em> label, the other displaying the
<em class="parameter"><code>false_text</code></em> label.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of boolean property controlled by combo box.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>true_text</code></em>&#160;:</span></td>
<td> Label used for entry corresponding to <code class="literal">TRUE</code> value.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>false_text</code></em>&#160;:</span></td>
<td> Label used for entry corresponding to <code class="literal">FALSE</code> value.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created <span class="type">GtkComboBox</span> widget, optionally
wrapped into a <span class="type">GtkEventBox</span>..
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2669542"></a><h3>
<a name="gimp-prop-boolean-radio-frame-new"></a>gimp_prop_boolean_radio_frame_new ()</h3>
<a class="indexterm" name="id2669555"></a><pre class="programlisting">GtkWidget* gimp_prop_boolean_radio_frame_new (GObject *config,
const gchar *property_name,
const gchar *title,
const gchar *true_text,
const gchar *false_text);</pre>
<p>
Creates a pair of radio buttons which function to set and display
the specified boolean property.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of boolean property controlled by the radio buttons.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
<td> Label for the frame.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>true_text</code></em>&#160;:</span></td>
<td> Label for the button corresponding to <code class="literal">TRUE</code>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>false_text</code></em>&#160;:</span></td>
<td> Label for the button corresponding to <code class="literal">FALSE</code>.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <a href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2669731"></a><h3>
<a name="gimp-prop-check-button-new"></a>gimp_prop_check_button_new ()</h3>
<a class="indexterm" name="id2669743"></a><pre class="programlisting">GtkWidget* gimp_prop_check_button_new (GObject *config,
const gchar *property_name,
const gchar *label);</pre>
<p>
Creates a <span class="type">GtkCheckButton</span> that displays and sets the specified
boolean property.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of boolean property controlled by checkbutton.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
<td> Label to give checkbutton (including mnemonic).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created <span class="type">GtkCheckButton</span> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2669864"></a><h3>
<a name="gimp-prop-color-area-new"></a>gimp_prop_color_area_new ()</h3>
<a class="indexterm" name="id2669875"></a><pre class="programlisting">GtkWidget* gimp_prop_color_area_new (GObject *config,
const gchar *property_name,
gint width,
gint height,
<a href="GimpColorArea.html#GimpColorAreaType">GimpColorAreaType</a> type);</pre>
<p>
Creates a <a href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> to set and display the value of an RGB
property.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of RGB property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></td>
<td> Width of color area.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></td>
<td> Height of color area.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></td>
<td> How transparency is represented.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <a href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2670037"></a><h3>
<a name="gimp-prop-coordinates-connect"></a>gimp_prop_coordinates_connect ()</h3>
<a class="indexterm" name="id2670050"></a><pre class="programlisting">gboolean gimp_prop_coordinates_connect (GObject *config,
const gchar *x_property_name,
const gchar *y_property_name,
const gchar *unit_property_name,
GtkWidget *sizeentry,
GtkWidget *chainbutton,
gdouble xresolution,
gdouble yresolution);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x_property_name</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y_property_name</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>unit_property_name</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>sizeentry</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>chainbutton</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>xresolution</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>yresolution</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2670258"></a><h3>
<a name="gimp-prop-coordinates-new"></a>gimp_prop_coordinates_new ()</h3>
<a class="indexterm" name="id2670269"></a><pre class="programlisting">GtkWidget* gimp_prop_coordinates_new (GObject *config,
const gchar *x_property_name,
const gchar *y_property_name,
const gchar *unit_property_name,
const gchar *unit_format,
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
gdouble xresolution,
gdouble yresolution,
gboolean has_chainbutton);</pre>
<p>
Creates a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> to set and display two double or int
properties, which will usually represent X and Y coordinates, and
their associated unit property.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>x_property_name</code></em>&#160;:</span></td>
<td> Name of int or double property for X coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>y_property_name</code></em>&#160;:</span></td>
<td> Name of int or double property for Y coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>unit_property_name</code></em>&#160;:</span></td>
<td> Name of unit property.
</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>update_policy</code></em>&#160;:</span></td>
<td> How the automatic pixel &lt;-&gt; real-world-unit
calculations should be done.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>xresolution</code></em>&#160;:</span></td>
<td> The resolution (in dpi) for the X coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>yresolution</code></em>&#160;:</span></td>
<td> The resolution (in dpi) for the Y coordinate.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>has_chainbutton</code></em>&#160;:</span></td>
<td> Whether to add a chainbutton to the size entry.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2670510"></a><h3>
<a name="gimp-prop-entry-new"></a>gimp_prop_entry_new ()</h3>
<a class="indexterm" name="id2670521"></a><pre class="programlisting">GtkWidget* gimp_prop_entry_new (GObject *config,
const gchar *property_name,
gint max_len);</pre>
<p>
Creates a <span class="type">GtkEntry</span> to set and display the value of the specified
string property.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of string property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>max_len</code></em>&#160;:</span></td>
<td> Maximum allowed length of string.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GtkEntry</span> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2670628"></a><h3>
<a name="gimp-prop-enum-check-button-new"></a>gimp_prop_enum_check_button_new ()</h3>
<a class="indexterm" name="id2670640"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_check_button_new (GObject *config,
const gchar *property_name,
const gchar *label,
gint false_value,
gint true_value);</pre>
<p>
Creates a <span class="type">GtkCheckButton</span> that displays and sets the specified
property of type Enum. Note that this widget only allows two values
for the enum, one corresponding to the "checked" state and the
other to the "unchecked" state.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of enum property controlled by checkbutton.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
<td> Label to give checkbutton (including mnemonic).
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>false_value</code></em>&#160;:</span></td>
<td> Enum value corresponding to unchecked state.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>true_value</code></em>&#160;:</span></td>
<td> Enum value corresonding to checked state.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created <span class="type">GtkCheckButton</span> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2670792"></a><h3>
<a name="gimp-prop-enum-combo-box-new"></a>gimp_prop_enum_combo_box_new ()</h3>
<a class="indexterm" name="id2670804"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_combo_box_new (GObject *config,
const gchar *property_name,
gint minimum,
gint maximum);</pre>
<p>
Creates a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget to display and set the specified
enum property. The <em class="parameter"><code>mimimum_value</code></em> and <em class="parameter"><code>maximum_value</code></em> give the
possibility of restricting the allowed range to a subset of the
enum. If the two values are equal (e.g., 0, 0), then the full
range of the Enum is used.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of enum property controlled by combo box.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>minimum</code></em>&#160;:</span></td>
<td> Smallest allowed value of enum.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>maximum</code></em>&#160;:</span></td>
<td> Largest allowed value of enum.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created <a href="GimpEnumComboBox.html" title="GimpEnumComboBox"><span class="type">GimpEnumComboBox</span></a> widget, optionally
wrapped into a <span class="type">GtkEventBox</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2670953"></a><h3>
<a name="gimp-prop-enum-label-new"></a>gimp_prop_enum_label_new ()</h3>
<a class="indexterm" name="id2670964"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_label_new (GObject *config,
const gchar *property_name);</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>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of enum property to be displayed.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created <a href="GimpEnumLabel.html" title="GimpEnumLabel"><span class="type">GimpEnumLabel</span></a> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2671044"></a><h3>
<a name="gimp-prop-enum-radio-box-new"></a>gimp_prop_enum_radio_box_new ()</h3>
<a class="indexterm" name="id2671057"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_radio_box_new (GObject *config,
const gchar *property_name,
gint minimum,
gint maximum);</pre>
<p>
Creates a group of radio buttons which function to set and display
the specified enum property. The <em class="parameter"><code>minimum</code></em> and <em class="parameter"><code>maximum</code></em> arguments
allow only a subset of the enum to be used. If the two arguments
are equal (e.g., 0, 0), then the full range of the enum will be used.
If you want to assign a label to the group of radio buttons, use
<a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-frame-new"><code class="function">gimp_prop_enum_radio_frame_new()</code></a> instead of this function.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of enum property controlled by the radio buttons.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>minimum</code></em>&#160;:</span></td>
<td> Smallest value of enum to be included.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>maximum</code></em>&#160;:</span></td>
<td> Largest value of enum to be included.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <span class="type">GtkVBox</span> containing the radio buttons.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2671205"></a><h3>
<a name="gimp-prop-enum-radio-frame-new"></a>gimp_prop_enum_radio_frame_new ()</h3>
<a class="indexterm" name="id2671217"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_radio_frame_new (GObject *config,
const gchar *property_name,
const gchar *title,
gint minimum,
gint maximum);</pre>
<p>
Creates a group of radio buttons which function to set and display
the specified enum property. The <em class="parameter"><code>minimum</code></em> and <em class="parameter"><code>maximum</code></em> arguments
allow only a subset of the enum to be used. If the two arguments
are equal (e.g., 0, 0), then the full range of the enum will be used.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of enum property controlled by the radio buttons.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
<td> Label for the frame holding the buttons
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>minimum</code></em>&#160;:</span></td>
<td> Smallest value of enum to be included.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>maximum</code></em>&#160;:</span></td>
<td> Largest value of enum to be included.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <a href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2671375"></a><h3>
<a name="gimp-prop-enum-stock-box-new"></a>gimp_prop_enum_stock_box_new ()</h3>
<a class="indexterm" name="id2671387"></a><pre class="programlisting">GtkWidget* gimp_prop_enum_stock_box_new (GObject *config,
const gchar *property_name,
const gchar *stock_prefix,
gint minimum,
gint maximum);</pre>
<p>
Creates a horizontal box of radio buttons with stock icons, which
function to set and display the value of the specified Enum
property. The stock_id for each icon is created by appending the
enum_value's nick to the given <em class="parameter"><code>stock_prefix</code></em>. See
<a href="libgimpwidgets-GimpEnumWidgets.html#gimp-enum-stock-box-new"><code class="function">gimp_enum_stock_box_new()</code></a> for more information.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of enum property controlled by the radio buttons.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>stock_prefix</code></em>&#160;:</span></td>
<td> The prefix of the group of stock ids to use.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>minimum</code></em>&#160;:</span></td>
<td> Smallest value of enum to be included.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>maximum</code></em>&#160;:</span></td>
<td> Largest value of enum to be included.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <span class="type">GimpEnumStockBox</span> containing the radio buttons.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2671548"></a><h3>
<a name="gimp-prop-expander-new"></a>gimp_prop_expander_new ()</h3>
<a class="indexterm" name="id2671558"></a><pre class="programlisting">GtkWidget* gimp_prop_expander_new (GObject *config,
const gchar *property_name,
const gchar *label);</pre>
<p>
Creates a <span class="type">GtkExpander</span> controlled by the specified boolean property.
A value of <code class="literal">TRUE</code> for the property corresponds to the expanded state
for the widget.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of boolean property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
<td> Label for expander.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GtkExpander</span> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2671675"></a><h3>
<a name="gimp-prop-file-chooser-button-new"></a>gimp_prop_file_chooser_button_new ()</h3>
<a class="indexterm" name="id2671688"></a><pre class="programlisting">GtkWidget* gimp_prop_file_chooser_button_new (GObject *config,
const gchar *property_name,
const gchar *title,
GtkFileChooserAction action);</pre>
<p>
Creates a <span class="type">GtkFileChooserButton</span> to edit the specified path property.
</p>
<p>
Note that <span class="type">GtkFileChooserButton</span> implements the <span class="type">GtkFileChooser</span>
interface; you can use the <span class="type">GtkFileChooser</span> API with it.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> name of path property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
<td> the title of the browse dialog.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>action</code></em>&#160;:</span></td>
<td> the open mode for the widget.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GtkFileChooserButton</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2671837"></a><h3>
<a name="gimp-prop-file-chooser-button-new-with-dialog"></a>gimp_prop_file_chooser_button_new_with_dialog ()</h3>
<a class="indexterm" name="id2671851"></a><pre class="programlisting">GtkWidget* gimp_prop_file_chooser_button_new_with_dialog
(GObject *config,
const gchar *property_name,
GtkWidget *dialog);</pre>
<p>
Creates a <span class="type">GtkFileChooserButton</span> to edit the specified path property.
</p>
<p>
The button uses <em class="parameter"><code>dialog</code></em> as it's file-picking window. Note that <em class="parameter"><code>dialog</code></em>
must be a <span class="type">GtkFileChooserDialog</span> (or subclass) and must not have
<code class="literal">GTK_DIALOG_DESTROY_WITH_PARENT</code> set.
</p>
<p>
Note that <span class="type">GtkFileChooserButton</span> implements the <span class="type">GtkFileChooser</span>
interface; you can use the <span class="type">GtkFileChooser</span> API with it.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> name of path property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></td>
<td> the <span class="type">GtkFileChooserDialog</span> widget to use.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GtkFileChooserButton</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2672019"></a><h3>
<a name="gimp-prop-hscale-new"></a>gimp_prop_hscale_new ()</h3>
<a class="indexterm" name="id2672029"></a><pre class="programlisting">GtkWidget* gimp_prop_hscale_new (GObject *config,
const gchar *property_name,
gdouble step_increment,
gdouble page_increment,
gint digits);</pre>
<p>
Creates a horizontal scale to control the value of the specified
integer or double property.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of integer or double property controlled by the scale.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>step_increment</code></em>&#160;:</span></td>
<td> Step size.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>page_increment</code></em>&#160;:</span></td>
<td> Page size.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td> Number of digits after decimal point to display.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GtkScale</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2672170"></a><h3>
<a name="gimp-prop-int-combo-box-new"></a>gimp_prop_int_combo_box_new ()</h3>
<a class="indexterm" name="id2672182"></a><pre class="programlisting">GtkWidget* gimp_prop_int_combo_box_new (GObject *config,
const gchar *property_name,
<a href="GimpIntStore.html" title="GimpIntStore">GimpIntStore</a> *store);</pre>
<p>
Creates a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget to display and set the specified
property. The contents of the widget are determined by <em class="parameter"><code>store</code></em>,
which should be created using <a href="GimpIntStore.html#gimp-int-store-new"><code class="function">gimp_int_store_new()</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>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of int property controlled by combo box.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>store</code></em>&#160;:</span></td>
<td> <a href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> holding list of labels, values, etc.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget, optionally
wrapped into a <span class="type">GtkEventBox</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2672318"></a><h3>
<a name="gimp-prop-label-new"></a>gimp_prop_label_new ()</h3>
<a class="indexterm" name="id2672328"></a><pre class="programlisting">GtkWidget* gimp_prop_label_new (GObject *config,
const gchar *property_name);</pre>
<p>
Creates a <span class="type">GtkLabel</span> to display the value of the specified property.
The property should be a string property or at least transformable
to a string. If the user should be able to edit the string, use
<a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new"><code class="function">gimp_prop_entry_new()</code></a> instead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of string property.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GtkLabel</span> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2672426"></a><h3>
<a name="gimp-prop-memsize-entry-new"></a>gimp_prop_memsize_entry_new ()</h3>
<a class="indexterm" name="id2672437"></a><pre class="programlisting">GtkWidget* gimp_prop_memsize_entry_new (GObject *config,
const gchar *property_name);</pre>
<p>
Creates a <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a> (spin button and option menu) to set
and display the value of the specified memsize property. See
<a href="GimpMemsizeEntry.html#gimp-memsize-entry-new"><code class="function">gimp_memsize_entry_new()</code></a> for more information.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of memsize property.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2672533"></a><h3>
<a name="gimp-prop-opacity-entry-new"></a>gimp_prop_opacity_entry_new ()</h3>
<a class="indexterm" name="id2672544"></a><pre class="programlisting">GtkObject* gimp_prop_opacity_entry_new (GObject *config,
const gchar *property_name,
GtkTable *table,
gint column,
gint row,
const gchar *label);</pre>
<p>
Creates a <span class="type">GimpScaleEntry</span> (slider and spin button) to set and
display the value of the specified double property, which should
represent an "opacity" variable with range 0 to 100. See
<a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a> for more information.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of double property controlled by the spin button.
</td>
</tr>
<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</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"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The <span class="type">GtkSpinButton</span>'s <span class="type">GtkAdjustment</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2672747"></a><h3>
<a name="gimp-prop-path-editor-new"></a>gimp_prop_path_editor_new ()</h3>
<a class="indexterm" name="id2672758"></a><pre class="programlisting">GtkWidget* gimp_prop_path_editor_new (GObject *config,
const gchar *path_property_name,
const gchar *writable_property_name,
const gchar *filesel_title);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>path_property_name</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>writable_property_name</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>filesel_title</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2672867"></a><h3>
<a name="gimp-prop-scale-entry-new"></a>gimp_prop_scale_entry_new ()</h3>
<a class="indexterm" name="id2672878"></a><pre class="programlisting">GtkObject* gimp_prop_scale_entry_new (GObject *config,
const gchar *property_name,
GtkTable *table,
gint column,
gint row,
const gchar *label,
gdouble step_increment,
gdouble page_increment,
gint digits,
gboolean limit_scale,
gdouble lower_limit,
gdouble upper_limit);</pre>
<p>
Creates a <span class="type">GimpScaleEntry</span> (slider and spin button) to set and
display the value of the specified double property. See
<a href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new"><code class="function">gimp_scale_entry_new()</code></a> for more information.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of double property controlled by the spin button.
</td>
</tr>
<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</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>step_increment</code></em>&#160;:</span></td>
<td> Step size.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>page_increment</code></em>&#160;:</span></td>
<td> Page size.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td> Number of digits after decimal point to display.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>limit_scale</code></em>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if the range of possible values of the
GtkSpinButton should be the same as of the GtkHScale.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>lower_limit</code></em>&#160;:</span></td>
<td> The spinbutton's lower boundary if <em class="parameter"><code>limit_scale</code></em> is <code class="literal">FALSE</code>.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>upper_limit</code></em>&#160;:</span></td>
<td> The spinbutton's upper boundary if <em class="parameter"><code>limit_scale</code></em> is <code class="literal">FALSE</code>.
</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>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2673258"></a><h3>
<a name="gimp-prop-size-entry-new"></a>gimp_prop_size_entry_new ()</h3>
<a class="indexterm" name="id2673271"></a><pre class="programlisting">GtkWidget* gimp_prop_size_entry_new (GObject *config,
const gchar *property_name,
const gchar *unit_property_name,
const gchar *unit_format,
<a href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</a> update_policy,
gdouble resolution);</pre>
<p>
Creates a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> to set and display the specified double or
int property, and its associated unit property. Note that this
function is only suitable for creating a size entry holding a
single value. Use <a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-new"><code class="function">gimp_prop_coordinates_new()</code></a> to create a size
entry holding two values.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of int or double property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>unit_property_name</code></em>&#160;:</span></td>
<td> Name of unit property.
</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>update_policy</code></em>&#160;:</span></td>
<td> How the automatic pixel &lt;-&gt; real-world-unit
calculations should be done.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>resolution</code></em>&#160;:</span></td>
<td> The resolution (in dpi) for the field.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2673483"></a><h3>
<a name="gimp-prop-spin-button-new"></a>gimp_prop_spin_button_new ()</h3>
<a class="indexterm" name="id2673498"></a><pre class="programlisting">GtkWidget* gimp_prop_spin_button_new (GObject *config,
const gchar *property_name,
gdouble step_increment,
gdouble page_increment,
gint digits);</pre>
<p>
Creates a spin button to set and display the value of the
specified double property.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of double property controlled by the spin button.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>step_increment</code></em>&#160;:</span></td>
<td> Step size.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>page_increment</code></em>&#160;:</span></td>
<td> Page size.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
<td> Number of digits after decimal point to display.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GimpSpinButton</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2673655"></a><h3>
<a name="gimp-prop-stock-image-new"></a>gimp_prop_stock_image_new ()</h3>
<a class="indexterm" name="id2673670"></a><pre class="programlisting">GtkWidget* gimp_prop_stock_image_new (GObject *config,
const gchar *property_name,
GtkIconSize icon_size);</pre>
<p>
Creates a widget to display a stock image representing the value of the
specified string property, which should encode a Stock ID.
See <code class="function">gtk_image_new_from_stock()</code> for more information.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of string property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>icon_size</code></em>&#160;:</span></td>
<td> Size of desired stock image.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GtkImage</span> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2673793"></a><h3>
<a name="gimp-prop-string-combo-box-new"></a>gimp_prop_string_combo_box_new ()</h3>
<a class="indexterm" name="id2673808"></a><pre class="programlisting">GtkWidget* gimp_prop_string_combo_box_new (GObject *config,
const gchar *property_name,
GtkTreeModel *model,
gint id_column,
gint label_column);</pre>
<p>
Creates a <a href="GimpStringComboBox.html" title="GimpStringComboBox"><span class="type">GimpStringComboBox</span></a> widget to display and set the
specified property. The contents of the widget are determined by
<em class="parameter"><code>store</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>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of int property controlled by combo box.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>model</code></em>&#160;:</span></td>
<td> <span class="type">GtkTreeStore</span> holding list of values
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>id_column</code></em>&#160;:</span></td>
<td> column in <em class="parameter"><code>store</code></em> that holds string IDs
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>label_column</code></em>&#160;:</span></td>
<td> column in <em class="parameter"><code>store</code></em> that holds labels to use in the combo-box
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The newly created <a href="GimpStringComboBox.html" title="GimpStringComboBox"><span class="type">GimpStringComboBox</span></a> widget, optionally
wrapped into a <span class="type">GtkEventBox</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2674006"></a><h3>
<a name="gimp-prop-text-buffer-new"></a>gimp_prop_text_buffer_new ()</h3>
<a class="indexterm" name="id2674021"></a><pre class="programlisting">GtkTextBuffer* gimp_prop_text_buffer_new (GObject *config,
const gchar *property_name,
gint max_len);</pre>
<p>
Creates a <span class="type">GtkTextBuffer</span> to set and display the value of the
specified string property. Unless the string is expected to
contain multiple lines or a large amount of text, use
<a href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new"><code class="function">gimp_prop_entry_new()</code></a> instead. See <span class="type">GtkTextView</span> for information on
how to insert a text buffer into a visible widget.
</p>
<p>
If <em class="parameter"><code>max_len</code></em> is 0 or negative, the text buffer allows an unlimited
number of characters to 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>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of string property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>max_len</code></em>&#160;:</span></td>
<td> Maximum allowed length of text (in characters).
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <span class="type">GtkTextBuffer</span>.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2674172"></a><h3>
<a name="gimp-prop-unit-menu-new"></a>gimp_prop_unit_menu_new ()</h3>
<a class="indexterm" name="id2674186"></a><pre class="programlisting">GtkWidget* gimp_prop_unit_menu_new (GObject *config,
const gchar *property_name,
const gchar *unit_format);</pre>
<p>
Creates a <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> to set and display the value of a Unit
property. See <a href="GimpUnitMenu.html#gimp-unit-menu-new"><code class="function">gimp_unit_menu_new()</code></a> for more information.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>config</code></em>&#160;:</span></td>
<td> Object to which property is attached.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>property_name</code></em>&#160;:</span></td>
<td> Name of Unit property.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>unit_format</code></em>&#160;:</span></td>
<td> A printf-like format string which is used to create
the unit strings.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A new <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> widget.
Since GIMP 2.4
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>