<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>GimpPropWidgets: GIMP Widgets Library Reference Manual</title> <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"> <link rel="home" href="index.html" title="GIMP Widgets Library Reference Manual"> <link rel="up" href="libgimpwidgets-utils.html" title="Part VI. 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.33.1 (XML mode)"> <link rel="stylesheet" href="style.css" type="text/css"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> <td width="100%" align="left" class="shortcuts"> <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> <a href="#libgimpwidgets-GimpPropWidgets.description" class="shortcut">Description</a></span> </td> <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> <td><a accesskey="u" href="libgimpwidgets-utils.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> <td><a accesskey="p" href="libgimpwidgets-GimpEnumWidgets.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> <td><a accesskey="n" href="libgimpwidgets-GimpWidgets.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> </tr></table> <div class="refentry"> <a name="libgimpwidgets-GimpPropWidgets"></a><div class="titlepage"></div> <div class="refnamediv"><table width="100%"><tr> <td valign="top"> <h2><span class="refentrytitle"><a name="libgimpwidgets-GimpPropWidgets.top_of_page"></a>GimpPropWidgets</span></h2> <p>GimpPropWidgets — Editable views on <span class="type">GObject</span> properties.</p> </td> <td class="gallery_image" valign="top" align="right"></td> </tr></table></div> <div class="refsect1"> <a name="libgimpwidgets-GimpPropWidgets.functions"></a><h2>Functions</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="functions_proto_type"> <col class="functions_proto_name"> </colgroup> <tbody> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-boolean-combo-box-new" title="gimp_prop_boolean_combo_box_new ()">gimp_prop_boolean_combo_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-boolean-radio-frame-new" title="gimp_prop_boolean_radio_frame_new ()">gimp_prop_boolean_radio_frame_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-check-button-new" title="gimp_prop_check_button_new ()">gimp_prop_check_button_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-color-area-new" title="gimp_prop_color_area_new ()">gimp_prop_color_area_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">gboolean</span> </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-connect" title="gimp_prop_coordinates_connect ()">gimp_prop_coordinates_connect</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-new" title="gimp_prop_coordinates_new ()">gimp_prop_coordinates_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new" title="gimp_prop_entry_new ()">gimp_prop_entry_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-pointer-combo-box-new" title="gimp_prop_pointer_combo_box_new ()">gimp_prop_pointer_combo_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-check-button-new" title="gimp_prop_enum_check_button_new ()">gimp_prop_enum_check_button_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-combo-box-new" title="gimp_prop_enum_combo_box_new ()">gimp_prop_enum_combo_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-label-new" title="gimp_prop_enum_label_new ()">gimp_prop_enum_label_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-box-new" title="gimp_prop_enum_radio_box_new ()">gimp_prop_enum_radio_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-frame-new" title="gimp_prop_enum_radio_frame_new ()">gimp_prop_enum_radio_frame_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-stock-box-new" title="gimp_prop_enum_stock_box_new ()">gimp_prop_enum_stock_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-icon-box-new" title="gimp_prop_enum_icon_box_new ()">gimp_prop_enum_icon_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-expander-new" title="gimp_prop_expander_new ()">gimp_prop_expander_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-file-chooser-button-new" title="gimp_prop_file_chooser_button_new ()">gimp_prop_file_chooser_button_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-file-chooser-button-new-with-dialog" title="gimp_prop_file_chooser_button_new_with_dialog ()">gimp_prop_file_chooser_button_new_with_dialog</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-hscale-new" title="gimp_prop_hscale_new ()">gimp_prop_hscale_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-icon-image-new" title="gimp_prop_icon_image_new ()">gimp_prop_icon_image_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-int-combo-box-new" title="gimp_prop_int_combo_box_new ()">gimp_prop_int_combo_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-label-new" title="gimp_prop_label_new ()">gimp_prop_label_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-memsize-entry-new" title="gimp_prop_memsize_entry_new ()">gimp_prop_memsize_entry_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkObject</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-opacity-entry-new" title="gimp_prop_opacity_entry_new ()">gimp_prop_opacity_entry_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-path-editor-new" title="gimp_prop_path_editor_new ()">gimp_prop_path_editor_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkObject</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-scale-entry-new" title="gimp_prop_scale_entry_new ()">gimp_prop_scale_entry_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-size-entry-new" title="gimp_prop_size_entry_new ()">gimp_prop_size_entry_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-spin-button-new" title="gimp_prop_spin_button_new ()">gimp_prop_spin_button_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-stock-image-new" title="gimp_prop_stock_image_new ()">gimp_prop_stock_image_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-string-combo-box-new" title="gimp_prop_string_combo_box_new ()">gimp_prop_string_combo_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkTextBuffer</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-text-buffer-new" title="gimp_prop_text_buffer_new ()">gimp_prop_text_buffer_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-unit-combo-box-new" title="gimp_prop_unit_combo_box_new ()">gimp_prop_unit_combo_box_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">GtkWidget</span> * </td> <td class="function_name"> <a class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-unit-menu-new" title="gimp_prop_unit_menu_new ()">gimp_prop_unit_menu_new</a> <span class="c_punctuation">()</span> </td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="libgimpwidgets-GimpPropWidgets.description"></a><h2>Description</h2> <p>Editable views on <span class="type">GObject</span> properties.</p> </div> <div class="refsect1"> <a name="libgimpwidgets-GimpPropWidgets.functions_details"></a><h2>Functions</h2> <div class="refsect2"> <a name="gimp-prop-boolean-combo-box-new"></a><h3>gimp_prop_boolean_combo_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_boolean_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *true_text</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *false_text</code></em>);</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> <div class="refsect3"> <a name="gimp-prop-boolean-combo-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of boolean property controlled by combo box.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>true_text</p></td> <td class="parameter_description"><p>Label used for entry corresponding to <code class="literal">TRUE</code> value.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>false_text</p></td> <td class="parameter_description"><p>Label used for entry corresponding to <code class="literal">FALSE</code> value.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-boolean-combo-box-new.returns"></a><h4>Returns</h4> <p> The newly created <span class="type">GtkComboBox</span> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-boolean-radio-frame-new"></a><h3>gimp_prop_boolean_radio_frame_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_boolean_radio_frame_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *true_text</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *false_text</code></em>);</pre> <p>Creates a pair of radio buttons which function to set and display the specified boolean property. If <em class="parameter"><code>title</code></em> is <span class="type">NULL</span>, the <em class="parameter"><code>property_name</code></em> 's nick will be used as label of the returned frame.</p> <div class="refsect3"> <a name="gimp-prop-boolean-radio-frame-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of boolean property controlled by the radio buttons.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>title</p></td> <td class="parameter_description"><p>Label for the frame.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>true_text</p></td> <td class="parameter_description"><p>Label for the button corresponding to <code class="literal">TRUE</code>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>false_text</p></td> <td class="parameter_description"><p>Label for the button corresponding to <code class="literal">FALSE</code>.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-boolean-radio-frame-new.returns"></a><h4>Returns</h4> <p> A <a class="link" href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-check-button-new"></a><h3>gimp_prop_check_button_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_check_button_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre> <p>Creates a <span class="type">GtkCheckButton</span> that displays and sets the specified boolean property. If <em class="parameter"><code>label</code></em> is <span class="type">NULL</span>, the <em class="parameter"><code>property_name</code></em> 's nick will be used as label of the returned button.</p> <div class="refsect3"> <a name="gimp-prop-check-button-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of boolean property controlled by checkbutton.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>label</p></td> <td class="parameter_description"><p>Label to give checkbutton (including mnemonic).</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-check-button-new.returns"></a><h4>Returns</h4> <p> The newly created <span class="type">GtkCheckButton</span> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-color-area-new"></a><h3>gimp_prop_color_area_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_color_area_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">gint</span> width</code></em>, <em class="parameter"><code><span class="type">gint</span> height</code></em>, <em class="parameter"><code><a class="link" href="GimpColorArea.html#GimpColorAreaType" title="enum GimpColorAreaType"><span class="type">GimpColorAreaType</span></a> type</code></em>);</pre> <p>Creates a <a class="link" href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> to set and display the value of an RGB property.</p> <div class="refsect3"> <a name="gimp-prop-color-area-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of RGB property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>width</p></td> <td class="parameter_description"><p>Width of color area.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>height</p></td> <td class="parameter_description"><p>Height of color area.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>type</p></td> <td class="parameter_description"><p>How transparency is represented.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-color-area-new.returns"></a><h4>Returns</h4> <p> A new <a class="link" href="GimpColorArea.html" title="GimpColorArea"><span class="type">GimpColorArea</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-coordinates-connect"></a><h3>gimp_prop_coordinates_connect ()</h3> <pre class="programlisting"><span class="returnvalue">gboolean</span> gimp_prop_coordinates_connect (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *x_property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *y_property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *unit_property_name</code></em>, <em class="parameter"><code><span class="type">GtkWidget</span> *sizeentry</code></em>, <em class="parameter"><code><span class="type">GtkWidget</span> *chainbutton</code></em>, <em class="parameter"><code><span class="type">gdouble</span> xresolution</code></em>, <em class="parameter"><code><span class="type">gdouble</span> yresolution</code></em>);</pre> </div> <hr> <div class="refsect2"> <a name="gimp-prop-coordinates-new"></a><h3>gimp_prop_coordinates_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_coordinates_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *x_property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *y_property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *unit_property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *unit_format</code></em>, <em class="parameter"><code><a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> update_policy</code></em>, <em class="parameter"><code><span class="type">gdouble</span> xresolution</code></em>, <em class="parameter"><code><span class="type">gdouble</span> yresolution</code></em>, <em class="parameter"><code><span class="type">gboolean</span> has_chainbutton</code></em>);</pre> <p>Creates a <a class="link" 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> <div class="refsect3"> <a name="gimp-prop-coordinates-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>x_property_name</p></td> <td class="parameter_description"><p>Name of int or double property for X coordinate.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>y_property_name</p></td> <td class="parameter_description"><p>Name of int or double property for Y coordinate.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>unit_property_name</p></td> <td class="parameter_description"><p>Name of unit property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>unit_format</p></td> <td class="parameter_description"><p>A printf-like unit-format string as is used with <a class="link" href="GimpUnitMenu.html#gimp-unit-menu-new" title="gimp_unit_menu_new ()"><code class="function">gimp_unit_menu_new()</code></a>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>update_policy</p></td> <td class="parameter_description"><p>How the automatic pixel <-> real-world-unit calculations should be done.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>xresolution</p></td> <td class="parameter_description"><p>The resolution (in dpi) for the X coordinate.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>yresolution</p></td> <td class="parameter_description"><p>The resolution (in dpi) for the Y coordinate.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>has_chainbutton</p></td> <td class="parameter_description"><p>Whether to add a chainbutton to the size entry.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-coordinates-new.returns"></a><h4>Returns</h4> <p> A new <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-entry-new"></a><h3>gimp_prop_entry_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">gint</span> max_len</code></em>);</pre> <p>Creates a <span class="type">GtkEntry</span> to set and display the value of the specified string property.</p> <div class="refsect3"> <a name="gimp-prop-entry-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of string property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>max_len</p></td> <td class="parameter_description"><p>Maximum allowed length of string.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-entry-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkEntry</span> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-pointer-combo-box-new"></a><h3>gimp_prop_pointer_combo_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_pointer_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> *store</code></em>);</pre> <p>Creates a <a class="link" 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 class="link" href="GimpIntStore.html#gimp-int-store-new" title="gimp_int_store_new ()"><code class="function">gimp_int_store_new()</code></a>. Values are GType/gpointer data, and therefore must be stored in the "user-data" column, instead of the usual "value" column.</p> <div class="refsect3"> <a name="gimp-prop-pointer-combo-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of GType/gpointer property controlled by combo box.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>store</p></td> <td class="parameter_description"><p><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> holding list of labels, values, etc.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-pointer-combo-box-new.returns"></a><h4>Returns</h4> <p> The newly created <a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-enum-check-button-new"></a><h3>gimp_prop_enum_check_button_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_enum_check_button_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>, <em class="parameter"><code><span class="type">gint</span> false_value</code></em>, <em class="parameter"><code><span class="type">gint</span> true_value</code></em>);</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. If <em class="parameter"><code>label</code></em> is <span class="type">NULL</span>, the <em class="parameter"><code>property_name</code></em> 's nick will be used as label of the returned button.</p> <div class="refsect3"> <a name="gimp-prop-enum-check-button-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of enum property controlled by checkbutton.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>label</p></td> <td class="parameter_description"><p>Label to give checkbutton (including mnemonic).</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>false_value</p></td> <td class="parameter_description"><p>Enum value corresponding to unchecked state.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>true_value</p></td> <td class="parameter_description"><p>Enum value corresponding to checked state.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-enum-check-button-new.returns"></a><h4>Returns</h4> <p> The newly created <span class="type">GtkCheckButton</span> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-enum-combo-box-new"></a><h3>gimp_prop_enum_combo_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_enum_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">gint</span> minimum</code></em>, <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</pre> <p>Creates a <a class="link" 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> <div class="refsect3"> <a name="gimp-prop-enum-combo-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of enum property controlled by combo box.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum</p></td> <td class="parameter_description"><p>Smallest allowed value of enum.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>maximum</p></td> <td class="parameter_description"><p>Largest allowed value of enum.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-enum-combo-box-new.returns"></a><h4>Returns</h4> <p> The newly created <a class="link" href="GimpEnumComboBox.html" title="GimpEnumComboBox"><span class="type">GimpEnumComboBox</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-enum-label-new"></a><h3>gimp_prop_enum_label_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_enum_label_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre> <div class="refsect3"> <a name="gimp-prop-enum-label-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of enum property to be displayed.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-enum-label-new.returns"></a><h4>Returns</h4> <p> The newly created <a class="link" href="GimpEnumLabel.html" title="GimpEnumLabel"><span class="type">GimpEnumLabel</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-enum-radio-box-new"></a><h3>gimp_prop_enum_radio_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_enum_radio_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">gint</span> minimum</code></em>, <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</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 class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-enum-radio-frame-new" title="gimp_prop_enum_radio_frame_new ()"><code class="function">gimp_prop_enum_radio_frame_new()</code></a> instead of this function.</p> <div class="refsect3"> <a name="gimp-prop-enum-radio-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum</p></td> <td class="parameter_description"><p>Smallest value of enum to be included.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>maximum</p></td> <td class="parameter_description"><p>Largest value of enum to be included.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-enum-radio-box-new.returns"></a><h4>Returns</h4> <p> A <span class="type">GtkVBox</span> containing the radio buttons.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-enum-radio-frame-new"></a><h3>gimp_prop_enum_radio_frame_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_enum_radio_frame_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>, <em class="parameter"><code><span class="type">gint</span> minimum</code></em>, <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</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 <em class="parameter"><code>title</code></em> is <span class="type">NULL</span>, the <em class="parameter"><code>property_name</code></em> 's nick will be used as label of the returned frame.</p> <div class="refsect3"> <a name="gimp-prop-enum-radio-frame-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>title</p></td> <td class="parameter_description"><p>Label for the frame holding the buttons</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum</p></td> <td class="parameter_description"><p>Smallest value of enum to be included.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>maximum</p></td> <td class="parameter_description"><p>Largest value of enum to be included.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-enum-radio-frame-new.returns"></a><h4>Returns</h4> <p> A <a class="link" href="GimpFrame.html" title="GimpFrame"><span class="type">GimpFrame</span></a> containing the radio buttons.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-enum-stock-box-new"></a><h3>gimp_prop_enum_stock_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_enum_stock_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *stock_prefix</code></em>, <em class="parameter"><code><span class="type">gint</span> minimum</code></em>, <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</pre> <div class="warning"><p><code class="literal">gimp_prop_enum_stock_box_new</code> has been deprecated since version 2.10 and should not be used in newly-written code.</p></div> <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 class="link" href="libgimpwidgets-GimpEnumWidgets.html#gimp-enum-stock-box-new" title="gimp_enum_stock_box_new ()"><code class="function">gimp_enum_stock_box_new()</code></a> for more information.</p> <div class="refsect3"> <a name="gimp-prop-enum-stock-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>stock_prefix</p></td> <td class="parameter_description"><p>The prefix of the group of stock ids to use.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum</p></td> <td class="parameter_description"><p>Smallest value of enum to be included.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>maximum</p></td> <td class="parameter_description"><p>Largest value of enum to be included.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-enum-stock-box-new.returns"></a><h4>Returns</h4> <p> A <span class="type">libgimpwidgets-gimpenumstockbox</span> containing the radio buttons.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-enum-icon-box-new"></a><h3>gimp_prop_enum_icon_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_enum_icon_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *icon_prefix</code></em>, <em class="parameter"><code><span class="type">gint</span> minimum</code></em>, <em class="parameter"><code><span class="type">gint</span> maximum</code></em>);</pre> <p>Creates a horizontal box of radio buttons with named icons, which function to set and display the value of the specified Enum property. The icon name for each icon is created by appending the enum_value's nick to the given <em class="parameter"><code>icon_prefix</code></em> . See <a class="link" href="libgimpwidgets-GimpEnumWidgets.html#gimp-enum-icon-box-new" title="gimp_enum_icon_box_new ()"><code class="function">gimp_enum_icon_box_new()</code></a> for more information.</p> <div class="refsect3"> <a name="gimp-prop-enum-icon-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of enum property controlled by the radio buttons.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>icon_prefix</p></td> <td class="parameter_description"><p>The prefix of the group of icon names to use.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>minimum</p></td> <td class="parameter_description"><p>Smallest value of enum to be included.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>maximum</p></td> <td class="parameter_description"><p>Largest value of enum to be included.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-enum-icon-box-new.returns"></a><h4>Returns</h4> <p> A <span class="type">libgimpwidgets-gimpenumiconbox</span> containing the radio buttons.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-expander-new"></a><h3>gimp_prop_expander_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_expander_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</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. If <em class="parameter"><code>label</code></em> is <span class="type">NULL</span>, the <em class="parameter"><code>property_name</code></em> 's nick will be used as label of the returned widget.</p> <div class="refsect3"> <a name="gimp-prop-expander-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of boolean property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>label</p></td> <td class="parameter_description"><p>Label for expander.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-expander-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkExpander</span> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-file-chooser-button-new"></a><h3>gimp_prop_file_chooser_button_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_file_chooser_button_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>, <em class="parameter"><code><span class="type">GtkFileChooserAction</span> action</code></em>);</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> <div class="refsect3"> <a name="gimp-prop-file-chooser-button-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>name of path property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>title</p></td> <td class="parameter_description"><p>the title of the browse dialog.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>action</p></td> <td class="parameter_description"><p>the open mode for the widget.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-file-chooser-button-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkFileChooserButton</span>.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-file-chooser-button-new-with-dialog"></a><h3>gimp_prop_file_chooser_button_new_with_dialog ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_file_chooser_button_new_with_dialog (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">GtkWidget</span> *dialog</code></em>);</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> <div class="refsect3"> <a name="gimp-prop-file-chooser-button-new-with-dialog.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>name of path property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>dialog</p></td> <td class="parameter_description"><p>the <span class="type">GtkFileChooserDialog</span> widget to use.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-file-chooser-button-new-with-dialog.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkFileChooserButton</span>.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-hscale-new"></a><h3>gimp_prop_hscale_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_hscale_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">gdouble</span> step_increment</code></em>, <em class="parameter"><code><span class="type">gdouble</span> page_increment</code></em>, <em class="parameter"><code><span class="type">gint</span> digits</code></em>);</pre> <p>Creates a horizontal scale to control the value of the specified integer or double property.</p> <div class="refsect3"> <a name="gimp-prop-hscale-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of integer or double property controlled by the scale.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>step_increment</p></td> <td class="parameter_description"><p>Step size.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>page_increment</p></td> <td class="parameter_description"><p>Page size.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>digits</p></td> <td class="parameter_description"><p>Number of digits after decimal point to display.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-hscale-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkScale</span>.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-icon-image-new"></a><h3>gimp_prop_icon_image_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_icon_image_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">GtkIconSize</span> icon_size</code></em>);</pre> <p>Creates a widget to display a icon image representing the value of the specified string property, which should encode an icon name. See <code class="function">gtk_image_new_from_icon_name()</code> for more information.</p> <div class="refsect3"> <a name="gimp-prop-icon-image-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of string property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>icon_size</p></td> <td class="parameter_description"><p>Size of desired icon image.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-icon-image-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkImage</span> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-int-combo-box-new"></a><h3>gimp_prop_int_combo_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_int_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> *store</code></em>);</pre> <p>Creates a <a class="link" 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 class="link" href="GimpIntStore.html#gimp-int-store-new" title="gimp_int_store_new ()"><code class="function">gimp_int_store_new()</code></a>.</p> <div class="refsect3"> <a name="gimp-prop-int-combo-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of int property controlled by combo box.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>store</p></td> <td class="parameter_description"><p><a class="link" href="GimpIntStore.html" title="GimpIntStore"><span class="type">GimpIntStore</span></a> holding list of labels, values, etc.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-int-combo-box-new.returns"></a><h4>Returns</h4> <p> The newly created <a class="link" href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-label-new"></a><h3>gimp_prop_label_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_label_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</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 class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new" title="gimp_prop_entry_new ()"><code class="function">gimp_prop_entry_new()</code></a> instead.</p> <div class="refsect3"> <a name="gimp-prop-label-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of string property.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-label-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkLabel</span> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-memsize-entry-new"></a><h3>gimp_prop_memsize_entry_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_memsize_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre> <p>Creates a <a class="link" 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 class="link" href="GimpMemsizeEntry.html#gimp-memsize-entry-new" title="gimp_memsize_entry_new ()"><code class="function">gimp_memsize_entry_new()</code></a> for more information.</p> <div class="refsect3"> <a name="gimp-prop-memsize-entry-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of memsize property.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-memsize-entry-new.returns"></a><h4>Returns</h4> <p> A new <a class="link" href="GimpMemsizeEntry.html" title="GimpMemSizeEntry"><span class="type">GimpMemsizeEntry</span></a>.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-opacity-entry-new"></a><h3>gimp_prop_opacity_entry_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkObject</span> * gimp_prop_opacity_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">GtkTable</span> *table</code></em>, <em class="parameter"><code><span class="type">gint</span> column</code></em>, <em class="parameter"><code><span class="type">gint</span> row</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre> <p>Creates a <span class="type">libgimpwidgets-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 class="link" href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new" title="gimp_scale_entry_new ()"><code class="function">gimp_scale_entry_new()</code></a> for more information.</p> <div class="refsect3"> <a name="gimp-prop-opacity-entry-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of double property controlled by the spin button.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>table</p></td> <td class="parameter_description"><p>The <span class="type">GtkTable</span> the widgets will be attached to.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>column</p></td> <td class="parameter_description"><p>The column to start with.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>row</p></td> <td class="parameter_description"><p>The row to attach the widgets.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>label</p></td> <td class="parameter_description"><p>The text for the <span class="type">GtkLabel</span> which will appear left of the <span class="type">GtkHScale</span>.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-opacity-entry-new.returns"></a><h4>Returns</h4> <p> The <span class="type">GtkSpinButton</span>'s <span class="type">GtkAdjustment</span>.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-path-editor-new"></a><h3>gimp_prop_path_editor_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_path_editor_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *path_property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *writable_property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *filesel_title</code></em>);</pre> </div> <hr> <div class="refsect2"> <a name="gimp-prop-scale-entry-new"></a><h3>gimp_prop_scale_entry_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkObject</span> * gimp_prop_scale_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">GtkTable</span> *table</code></em>, <em class="parameter"><code><span class="type">gint</span> column</code></em>, <em class="parameter"><code><span class="type">gint</span> row</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>, <em class="parameter"><code><span class="type">gdouble</span> step_increment</code></em>, <em class="parameter"><code><span class="type">gdouble</span> page_increment</code></em>, <em class="parameter"><code><span class="type">gint</span> digits</code></em>, <em class="parameter"><code><span class="type">gboolean</span> limit_scale</code></em>, <em class="parameter"><code><span class="type">gdouble</span> lower_limit</code></em>, <em class="parameter"><code><span class="type">gdouble</span> upper_limit</code></em>);</pre> <p>Creates a <span class="type">libgimpwidgets-gimpscaleentry</span> (slider and spin button) to set and display the value of the specified double property. See <a class="link" href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new" title="gimp_scale_entry_new ()"><code class="function">gimp_scale_entry_new()</code></a> for more information. If <em class="parameter"><code>label</code></em> is <span class="type">NULL</span>, the <em class="parameter"><code>property_name</code></em> 's nick will be used as label of the returned object.</p> <p>Note that the <em class="parameter"><code>scale_limits</code></em> boolean is the inverse of <a class="link" href="libgimpwidgets-GimpWidgets.html#gimp-scale-entry-new" title="gimp_scale_entry_new ()"><code class="function">gimp_scale_entry_new()</code></a>'s "constrain" parameter.</p> <div class="refsect3"> <a name="gimp-prop-scale-entry-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of double property controlled by the spin button.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>table</p></td> <td class="parameter_description"><p>The <span class="type">GtkTable</span> the widgets will be attached to.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>column</p></td> <td class="parameter_description"><p>The column to start with.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>row</p></td> <td class="parameter_description"><p>The row to attach the widgets.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>label</p></td> <td class="parameter_description"><p>The text for the <span class="type">GtkLabel</span> which will appear left of the <span class="type">GtkHScale</span>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>step_increment</p></td> <td class="parameter_description"><p>Step size.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>page_increment</p></td> <td class="parameter_description"><p>Page size.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>digits</p></td> <td class="parameter_description"><p>Number of digits after decimal point to display.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>limit_scale</p></td> <td class="parameter_description"><p><code class="literal">FALSE</code> if the range of possible values of the GtkHScale should be the same as of the GtkSpinButton.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>lower_limit</p></td> <td class="parameter_description"><p>The scale's lower boundary if <em class="parameter"><code>scale_limits</code></em> is <code class="literal">TRUE</code>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>upper_limit</p></td> <td class="parameter_description"><p>The scale's upper boundary if <em class="parameter"><code>scale_limits</code></em> is <code class="literal">TRUE</code>.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-scale-entry-new.returns"></a><h4>Returns</h4> <p> The <span class="type">GtkSpinButton</span>'s <span class="type">GtkAdjustment</span>.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-size-entry-new"></a><h3>gimp_prop_size_entry_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_size_entry_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">gboolean</span> property_is_pixel</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *unit_property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *unit_format</code></em>, <em class="parameter"><code><a class="link" href="GimpSizeEntry.html#GimpSizeEntryUpdatePolicy" title="enum GimpSizeEntryUpdatePolicy"><span class="type">GimpSizeEntryUpdatePolicy</span></a> update_policy</code></em>, <em class="parameter"><code><span class="type">gdouble</span> resolution</code></em>);</pre> <p>Creates a <a class="link" 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 class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-coordinates-new" title="gimp_prop_coordinates_new ()"><code class="function">gimp_prop_coordinates_new()</code></a> to create a size entry holding two values.</p> <div class="refsect3"> <a name="gimp-prop-size-entry-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of int or double property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_is_pixel</p></td> <td class="parameter_description"><p>When <code class="literal">TRUE</code>, the property value is in pixels, and in the selected unit otherwise.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>unit_property_name</p></td> <td class="parameter_description"><p>Name of unit property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>unit_format</p></td> <td class="parameter_description"><p>A printf-like unit-format string as is used with <a class="link" href="GimpUnitMenu.html#gimp-unit-menu-new" title="gimp_unit_menu_new ()"><code class="function">gimp_unit_menu_new()</code></a>.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>update_policy</p></td> <td class="parameter_description"><p>How the automatic pixel <-> real-world-unit calculations should be done.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>resolution</p></td> <td class="parameter_description"><p>The resolution (in dpi) for the field.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-size-entry-new.returns"></a><h4>Returns</h4> <p> A new <a class="link" href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-spin-button-new"></a><h3>gimp_prop_spin_button_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_spin_button_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">gdouble</span> step_increment</code></em>, <em class="parameter"><code><span class="type">gdouble</span> page_increment</code></em>, <em class="parameter"><code><span class="type">gint</span> digits</code></em>);</pre> <p>Creates a spin button to set and display the value of the specified double property.</p> <div class="refsect3"> <a name="gimp-prop-spin-button-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of double property controlled by the spin button.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>step_increment</p></td> <td class="parameter_description"><p>Step size.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>page_increment</p></td> <td class="parameter_description"><p>Page size.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>digits</p></td> <td class="parameter_description"><p>Number of digits after decimal point to display.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-spin-button-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">libgimpwidgets-gimpspinbutton</span>.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-stock-image-new"></a><h3>gimp_prop_stock_image_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_stock_image_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">GtkIconSize</span> icon_size</code></em>);</pre> <div class="warning"><p><code class="literal">gimp_prop_stock_image_new</code> has been deprecated since version 2.10 and should not be used in newly-written code.</p></div> <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> <div class="refsect3"> <a name="gimp-prop-stock-image-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of string property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>icon_size</p></td> <td class="parameter_description"><p>Size of desired stock image.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-stock-image-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkImage</span> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-string-combo-box-new"></a><h3>gimp_prop_string_combo_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_string_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">GtkTreeModel</span> *model</code></em>, <em class="parameter"><code><span class="type">gint</span> id_column</code></em>, <em class="parameter"><code><span class="type">gint</span> label_column</code></em>);</pre> <p>Creates a <a class="link" 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> <div class="refsect3"> <a name="gimp-prop-string-combo-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of int property controlled by combo box.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>model</p></td> <td class="parameter_description"><p><span class="type">GtkTreeStore</span> holding list of values</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>id_column</p></td> <td class="parameter_description"><p>column in <em class="parameter"><code>store</code></em> that holds string IDs</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>label_column</p></td> <td class="parameter_description"><p>column in <em class="parameter"><code>store</code></em> that holds labels to use in the combo-box</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-string-combo-box-new.returns"></a><h4>Returns</h4> <p> The newly created <a class="link" href="GimpStringComboBox.html" title="GimpStringComboBox"><span class="type">GimpStringComboBox</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-text-buffer-new"></a><h3>gimp_prop_text_buffer_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkTextBuffer</span> * gimp_prop_text_buffer_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code><span class="type">gint</span> max_len</code></em>);</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 class="link" href="libgimpwidgets-GimpPropWidgets.html#gimp-prop-entry-new" title="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> <div class="refsect3"> <a name="gimp-prop-text-buffer-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of string property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>max_len</p></td> <td class="parameter_description"><p>Maximum allowed length of text (in characters).</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-text-buffer-new.returns"></a><h4>Returns</h4> <p> A new <span class="type">GtkTextBuffer</span>.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-unit-combo-box-new"></a><h3>gimp_prop_unit_combo_box_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_unit_combo_box_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre> <p>Creates a <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a> to set and display the value of a Unit property. See <a class="link" href="GimpUnitComboBox.html#gimp-unit-combo-box-new" title="gimp_unit_combo_box_new ()"><code class="function">gimp_unit_combo_box_new()</code></a> for more information.</p> <div class="refsect3"> <a name="gimp-prop-unit-combo-box-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of Unit property.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-unit-combo-box-new.returns"></a><h4>Returns</h4> <p> A new <a class="link" href="GimpUnitComboBox.html" title="GimpUnitComboBox"><span class="type">GimpUnitComboBox</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p> </div> <hr> <div class="refsect2"> <a name="gimp-prop-unit-menu-new"></a><h3>gimp_prop_unit_menu_new ()</h3> <pre class="programlisting"><span class="returnvalue">GtkWidget</span> * gimp_prop_unit_menu_new (<em class="parameter"><code><span class="type">GObject</span> *config</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>, <em class="parameter"><code>const <span class="type">gchar</span> *unit_format</code></em>);</pre> <div class="warning"><p><code class="literal">gimp_prop_unit_menu_new</code> has been deprecated since version 2.10 and should not be used in newly-written code.</p></div> <p>Creates a <a class="link" href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> to set and display the value of a Unit property. See <a class="link" href="GimpUnitMenu.html#gimp-unit-menu-new" title="gimp_unit_menu_new ()"><code class="function">gimp_unit_menu_new()</code></a> for more information.</p> <div class="refsect3"> <a name="gimp-prop-unit-menu-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>config</p></td> <td class="parameter_description"><p>Object to which property is attached.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>property_name</p></td> <td class="parameter_description"><p>Name of Unit property.</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>unit_format</p></td> <td class="parameter_description"><p>A printf-like format string which is used to create the unit strings.</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gimp-prop-unit-menu-new.returns"></a><h4>Returns</h4> <p> A new <a class="link" href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a> widget.</p> </div> <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p> </div> </div> </div> <div class="footer"> <hr>Generated by GTK-Doc V1.33.1</div> </body> </html>