1147 lines
78 KiB
XML
1147 lines
78 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
|
|
|
|
<refentry id="libgimpwidgets-GimpPropWidgets">
|
|
<refmeta>
|
|
<refentrytitle role="top_of_page">GimpPropWidgets</refentrytitle>
|
|
<manvolnum>3</manvolnum>
|
|
<refmiscinfo>LIBGIMPWIDGETS Library</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>GimpPropWidgets</refname>
|
|
<refpurpose></refpurpose>
|
|
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv role="synopsis">
|
|
<title role="synopsis.title">Synopsis</title>
|
|
|
|
<synopsis>
|
|
|
|
|
|
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-boolean-combo-box-new">gimp_prop_boolean_combo_box_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *true_text,
|
|
const <link linkend="gchar">gchar</link> *false_text);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-boolean-radio-frame-new">gimp_prop_boolean_radio_frame_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *title,
|
|
const <link linkend="gchar">gchar</link> *true_text,
|
|
const <link linkend="gchar">gchar</link> *false_text);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-check-button-new">gimp_prop_check_button_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *label);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-color-area-new">gimp_prop_color_area_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> width,
|
|
<link linkend="gint">gint</link> height,
|
|
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type);
|
|
<link linkend="gboolean">gboolean</link> <link linkend="gimp-prop-coordinates-connect">gimp_prop_coordinates_connect</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *x_property_name,
|
|
const <link linkend="gchar">gchar</link> *y_property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_property_name,
|
|
<link linkend="GtkWidget">GtkWidget</link> *sizeentry,
|
|
<link linkend="GtkWidget">GtkWidget</link> *chainbutton,
|
|
<link linkend="gdouble">gdouble</link> xresolution,
|
|
<link linkend="gdouble">gdouble</link> yresolution);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-coordinates-new">gimp_prop_coordinates_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *x_property_name,
|
|
const <link linkend="gchar">gchar</link> *y_property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_format,
|
|
<link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy,
|
|
<link linkend="gdouble">gdouble</link> xresolution,
|
|
<link linkend="gdouble">gdouble</link> yresolution,
|
|
<link linkend="gboolean">gboolean</link> has_chainbutton);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-entry-new">gimp_prop_entry_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> max_len);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-enum-check-button-new">gimp_prop_enum_check_button_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *label,
|
|
<link linkend="gint">gint</link> false_value,
|
|
<link linkend="gint">gint</link> true_value);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-enum-combo-box-new">gimp_prop_enum_combo_box_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> minimum,
|
|
<link linkend="gint">gint</link> maximum);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-enum-label-new">gimp_prop_enum_label_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-enum-radio-box-new">gimp_prop_enum_radio_box_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> minimum,
|
|
<link linkend="gint">gint</link> maximum);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-enum-radio-frame-new">gimp_prop_enum_radio_frame_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *title,
|
|
<link linkend="gint">gint</link> minimum,
|
|
<link linkend="gint">gint</link> maximum);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-enum-stock-box-new">gimp_prop_enum_stock_box_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *stock_prefix,
|
|
<link linkend="gint">gint</link> minimum,
|
|
<link linkend="gint">gint</link> maximum);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-expander-new">gimp_prop_expander_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *label);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-file-chooser-button-new">gimp_prop_file_chooser_button_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *title,
|
|
<link linkend="GtkFileChooserAction">GtkFileChooserAction</link> action);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-file-chooser-button-new-with-dialog">gimp_prop_file_chooser_button_new_with_dialog</link>
|
|
(<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkWidget">GtkWidget</link> *dialog);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-hscale-new">gimp_prop_hscale_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gdouble">gdouble</link> step_increment,
|
|
<link linkend="gdouble">gdouble</link> page_increment,
|
|
<link linkend="gint">gint</link> digits);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-int-combo-box-new">gimp_prop_int_combo_box_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GimpIntStore">GimpIntStore</link> *store);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-label-new">gimp_prop_label_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-memsize-entry-new">gimp_prop_memsize_entry_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name);
|
|
<link linkend="GtkObject">GtkObject</link>* <link linkend="gimp-prop-opacity-entry-new">gimp_prop_opacity_entry_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkTable">GtkTable</link> *table,
|
|
<link linkend="gint">gint</link> column,
|
|
<link linkend="gint">gint</link> row,
|
|
const <link linkend="gchar">gchar</link> *label);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-path-editor-new">gimp_prop_path_editor_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *path_property_name,
|
|
const <link linkend="gchar">gchar</link> *writable_property_name,
|
|
const <link linkend="gchar">gchar</link> *filesel_title);
|
|
<link linkend="GtkObject">GtkObject</link>* <link linkend="gimp-prop-scale-entry-new">gimp_prop_scale_entry_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkTable">GtkTable</link> *table,
|
|
<link linkend="gint">gint</link> column,
|
|
<link linkend="gint">gint</link> row,
|
|
const <link linkend="gchar">gchar</link> *label,
|
|
<link linkend="gdouble">gdouble</link> step_increment,
|
|
<link linkend="gdouble">gdouble</link> page_increment,
|
|
<link linkend="gint">gint</link> digits,
|
|
<link linkend="gboolean">gboolean</link> limit_scale,
|
|
<link linkend="gdouble">gdouble</link> lower_limit,
|
|
<link linkend="gdouble">gdouble</link> upper_limit);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-size-entry-new">gimp_prop_size_entry_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gboolean">gboolean</link> property_is_pixel,
|
|
const <link linkend="gchar">gchar</link> *unit_property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_format,
|
|
<link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy,
|
|
<link linkend="gdouble">gdouble</link> resolution);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-spin-button-new">gimp_prop_spin_button_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gdouble">gdouble</link> step_increment,
|
|
<link linkend="gdouble">gdouble</link> page_increment,
|
|
<link linkend="gint">gint</link> digits);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-stock-image-new">gimp_prop_stock_image_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkIconSize">GtkIconSize</link> icon_size);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-string-combo-box-new">gimp_prop_string_combo_box_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkTreeModel">GtkTreeModel</link> *model,
|
|
<link linkend="gint">gint</link> id_column,
|
|
<link linkend="gint">gint</link> label_column);
|
|
<link linkend="GtkTextBuffer">GtkTextBuffer</link>* <link linkend="gimp-prop-text-buffer-new">gimp_prop_text_buffer_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> max_len);
|
|
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gimp-prop-unit-menu-new">gimp_prop_unit_menu_new</link> (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_format);
|
|
</synopsis>
|
|
</refsynopsisdiv>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<refsect1 role="desc">
|
|
<title role="desc.title">Description</title>
|
|
<para>
|
|
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="details">
|
|
<title role="details.title">Details</title>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-boolean-combo-box-new" role="function"/>gimp_prop_boolean_combo_box_new ()</title>
|
|
<indexterm><primary>gimp_prop_boolean_combo_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_boolean_combo_box_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *true_text,
|
|
const <link linkend="gchar">gchar</link> *false_text);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkComboBox"><type>GtkComboBox</type></link> widget to display and set the specified
|
|
boolean property. The combo box will have two entries, one
|
|
displaying the <parameter>true_text</parameter> label, the other displaying the
|
|
<parameter>false_text</parameter> label.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of boolean property controlled by combo box.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>true_text</parameter> :</term>
|
|
<listitem><simpara> Label used for entry corresponding to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> value.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>false_text</parameter> :</term>
|
|
<listitem><simpara> Label used for entry corresponding to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> value.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The newly created <link linkend="GtkComboBox"><type>GtkComboBox</type></link> widget, optionally
|
|
wrapped into a <link linkend="GtkEventBox"><type>GtkEventBox</type></link>..
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-boolean-radio-frame-new" role="function"/>gimp_prop_boolean_radio_frame_new ()</title>
|
|
<indexterm><primary>gimp_prop_boolean_radio_frame_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_boolean_radio_frame_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *title,
|
|
const <link linkend="gchar">gchar</link> *true_text,
|
|
const <link linkend="gchar">gchar</link> *false_text);</programlisting>
|
|
<para>
|
|
Creates a pair of radio buttons which function to set and display
|
|
the specified boolean property.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of boolean property controlled by the radio buttons.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>title</parameter> :</term>
|
|
<listitem><simpara> Label for the frame.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>true_text</parameter> :</term>
|
|
<listitem><simpara> Label for the button corresponding to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>false_text</parameter> :</term>
|
|
<listitem><simpara> Label for the button corresponding to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GimpFrame"><type>GimpFrame</type></link> containing the radio buttons.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-check-button-new" role="function"/>gimp_prop_check_button_new ()</title>
|
|
<indexterm><primary>gimp_prop_check_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_check_button_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *label);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkCheckButton"><type>GtkCheckButton</type></link> that displays and sets the specified
|
|
boolean property.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of boolean property controlled by checkbutton.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>label</parameter> :</term>
|
|
<listitem><simpara> Label to give checkbutton (including mnemonic).
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The newly created <link linkend="GtkCheckButton"><type>GtkCheckButton</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-color-area-new" role="function"/>gimp_prop_color_area_new ()</title>
|
|
<indexterm><primary>gimp_prop_color_area_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_color_area_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> width,
|
|
<link linkend="gint">gint</link> height,
|
|
<link linkend="GimpColorAreaType">GimpColorAreaType</link> type);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpColorArea"><type>GimpColorArea</type></link> to set and display the value of an RGB
|
|
property.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of RGB property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>width</parameter> :</term>
|
|
<listitem><simpara> Width of color area.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>height</parameter> :</term>
|
|
<listitem><simpara> Height of color area.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>type</parameter> :</term>
|
|
<listitem><simpara> How transparency is represented.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GimpColorArea"><type>GimpColorArea</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-coordinates-connect" role="function"/>gimp_prop_coordinates_connect ()</title>
|
|
<indexterm><primary>gimp_prop_coordinates_connect</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_prop_coordinates_connect (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *x_property_name,
|
|
const <link linkend="gchar">gchar</link> *y_property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_property_name,
|
|
<link linkend="GtkWidget">GtkWidget</link> *sizeentry,
|
|
<link linkend="GtkWidget">GtkWidget</link> *chainbutton,
|
|
<link linkend="gdouble">gdouble</link> xresolution,
|
|
<link linkend="gdouble">gdouble</link> yresolution);</programlisting>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>x_property_name</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>y_property_name</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>unit_property_name</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>sizeentry</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>chainbutton</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>xresolution</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>yresolution</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
|
|
|
|
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-coordinates-new" role="function"/>gimp_prop_coordinates_new ()</title>
|
|
<indexterm><primary>gimp_prop_coordinates_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_coordinates_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *x_property_name,
|
|
const <link linkend="gchar">gchar</link> *y_property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_format,
|
|
<link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy,
|
|
<link linkend="gdouble">gdouble</link> xresolution,
|
|
<link linkend="gdouble">gdouble</link> yresolution,
|
|
<link linkend="gboolean">gboolean</link> has_chainbutton);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> to set and display two double or int
|
|
properties, which will usually represent X and Y coordinates, and
|
|
their associated unit property.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>x_property_name</parameter> :</term>
|
|
<listitem><simpara> Name of int or double property for X coordinate.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>y_property_name</parameter> :</term>
|
|
<listitem><simpara> Name of int or double property for Y coordinate.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>unit_property_name</parameter> :</term>
|
|
<listitem><simpara> Name of unit property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>unit_format</parameter> :</term>
|
|
<listitem><simpara> A printf-like unit-format string as is used with
|
|
<link linkend="gimp-unit-menu-new"><function>gimp_unit_menu_new()</function></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>update_policy</parameter> :</term>
|
|
<listitem><simpara> How the automatic pixel <-> real-world-unit
|
|
calculations should be done.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>xresolution</parameter> :</term>
|
|
<listitem><simpara> The resolution (in dpi) for the X coordinate.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>yresolution</parameter> :</term>
|
|
<listitem><simpara> The resolution (in dpi) for the Y coordinate.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>has_chainbutton</parameter> :</term>
|
|
<listitem><simpara> Whether to add a chainbutton to the size entry.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-entry-new" role="function"/>gimp_prop_entry_new ()</title>
|
|
<indexterm><primary>gimp_prop_entry_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_entry_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> max_len);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkEntry"><type>GtkEntry</type></link> to set and display the value of the specified
|
|
string property.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of string property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>max_len</parameter> :</term>
|
|
<listitem><simpara> Maximum allowed length of string.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GtkEntry"><type>GtkEntry</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-enum-check-button-new" role="function"/>gimp_prop_enum_check_button_new ()</title>
|
|
<indexterm><primary>gimp_prop_enum_check_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_enum_check_button_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *label,
|
|
<link linkend="gint">gint</link> false_value,
|
|
<link linkend="gint">gint</link> true_value);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkCheckButton"><type>GtkCheckButton</type></link> 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.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of enum property controlled by checkbutton.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>label</parameter> :</term>
|
|
<listitem><simpara> Label to give checkbutton (including mnemonic).
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>false_value</parameter> :</term>
|
|
<listitem><simpara> Enum value corresponding to unchecked state.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>true_value</parameter> :</term>
|
|
<listitem><simpara> Enum value corresonding to checked state.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The newly created <link linkend="GtkCheckButton"><type>GtkCheckButton</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-enum-combo-box-new" role="function"/>gimp_prop_enum_combo_box_new ()</title>
|
|
<indexterm><primary>gimp_prop_enum_combo_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_enum_combo_box_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> minimum,
|
|
<link linkend="gint">gint</link> maximum);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link> widget to display and set the specified
|
|
enum property. The <parameter>mimimum_value</parameter> and <parameter>maximum_value</parameter> 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.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of enum property controlled by combo box.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>minimum</parameter> :</term>
|
|
<listitem><simpara> Smallest allowed value of enum.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>maximum</parameter> :</term>
|
|
<listitem><simpara> Largest allowed value of enum.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The newly created <link linkend="GimpEnumComboBox"><type>GimpEnumComboBox</type></link> widget, optionally
|
|
wrapped into a <link linkend="GtkEventBox"><type>GtkEventBox</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-enum-label-new" role="function"/>gimp_prop_enum_label_new ()</title>
|
|
<indexterm><primary>gimp_prop_enum_label_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_enum_label_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name);</programlisting>
|
|
<para>
|
|
</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of enum property to be displayed.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The newly created <link linkend="GimpEnumLabel"><type>GimpEnumLabel</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-enum-radio-box-new" role="function"/>gimp_prop_enum_radio_box_new ()</title>
|
|
<indexterm><primary>gimp_prop_enum_radio_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_enum_radio_box_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> minimum,
|
|
<link linkend="gint">gint</link> maximum);</programlisting>
|
|
<para>
|
|
Creates a group of radio buttons which function to set and display
|
|
the specified enum property. The <parameter>minimum</parameter> and <parameter>maximum</parameter> 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
|
|
<link linkend="gimp-prop-enum-radio-frame-new"><function>gimp_prop_enum_radio_frame_new()</function></link> instead of this function.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of enum property controlled by the radio buttons.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>minimum</parameter> :</term>
|
|
<listitem><simpara> Smallest value of enum to be included.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>maximum</parameter> :</term>
|
|
<listitem><simpara> Largest value of enum to be included.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GtkVBox"><type>GtkVBox</type></link> containing the radio buttons.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-enum-radio-frame-new" role="function"/>gimp_prop_enum_radio_frame_new ()</title>
|
|
<indexterm><primary>gimp_prop_enum_radio_frame_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_enum_radio_frame_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *title,
|
|
<link linkend="gint">gint</link> minimum,
|
|
<link linkend="gint">gint</link> maximum);</programlisting>
|
|
<para>
|
|
Creates a group of radio buttons which function to set and display
|
|
the specified enum property. The <parameter>minimum</parameter> and <parameter>maximum</parameter> 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.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of enum property controlled by the radio buttons.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>title</parameter> :</term>
|
|
<listitem><simpara> Label for the frame holding the buttons
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>minimum</parameter> :</term>
|
|
<listitem><simpara> Smallest value of enum to be included.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>maximum</parameter> :</term>
|
|
<listitem><simpara> Largest value of enum to be included.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GimpFrame"><type>GimpFrame</type></link> containing the radio buttons.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-enum-stock-box-new" role="function"/>gimp_prop_enum_stock_box_new ()</title>
|
|
<indexterm><primary>gimp_prop_enum_stock_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_enum_stock_box_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *stock_prefix,
|
|
<link linkend="gint">gint</link> minimum,
|
|
<link linkend="gint">gint</link> maximum);</programlisting>
|
|
<para>
|
|
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 <parameter>stock_prefix</parameter>. See
|
|
<link linkend="gimp-enum-stock-box-new"><function>gimp_enum_stock_box_new()</function></link> for more information.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of enum property controlled by the radio buttons.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>stock_prefix</parameter> :</term>
|
|
<listitem><simpara> The prefix of the group of stock ids to use.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>minimum</parameter> :</term>
|
|
<listitem><simpara> Smallest value of enum to be included.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>maximum</parameter> :</term>
|
|
<listitem><simpara> Largest value of enum to be included.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A <link linkend="GimpEnumStockBox"><type>GimpEnumStockBox</type></link> containing the radio buttons.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-expander-new" role="function"/>gimp_prop_expander_new ()</title>
|
|
<indexterm><primary>gimp_prop_expander_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_expander_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *label);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkExpander"><type>GtkExpander</type></link> controlled by the specified boolean property.
|
|
A value of <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> for the property corresponds to the expanded state
|
|
for the widget.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of boolean property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>label</parameter> :</term>
|
|
<listitem><simpara> Label for expander.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GtkExpander"><type>GtkExpander</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-file-chooser-button-new" role="function"/>gimp_prop_file_chooser_button_new ()</title>
|
|
<indexterm><primary>gimp_prop_file_chooser_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_file_chooser_button_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *title,
|
|
<link linkend="GtkFileChooserAction">GtkFileChooserAction</link> action);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkFileChooserButton"><type>GtkFileChooserButton</type></link> to edit the specified path property.
|
|
</para>
|
|
<para>
|
|
Note that <link linkend="GtkFileChooserButton"><type>GtkFileChooserButton</type></link> implements the <link linkend="GtkFileChooser"><type>GtkFileChooser</type></link>
|
|
interface; you can use the <link linkend="GtkFileChooser"><type>GtkFileChooser</type></link> API with it.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> name of path property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>title</parameter> :</term>
|
|
<listitem><simpara> the title of the browse dialog.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>action</parameter> :</term>
|
|
<listitem><simpara> the open mode for the widget.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GtkFileChooserButton"><type>GtkFileChooserButton</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-file-chooser-button-new-with-dialog" role="function"/>gimp_prop_file_chooser_button_new_with_dialog ()</title>
|
|
<indexterm><primary>gimp_prop_file_chooser_button_new_with_dialog</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_file_chooser_button_new_with_dialog
|
|
(<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkWidget">GtkWidget</link> *dialog);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkFileChooserButton"><type>GtkFileChooserButton</type></link> to edit the specified path property.
|
|
</para>
|
|
<para>
|
|
The button uses <parameter>dialog</parameter> as it's file-picking window. Note that <parameter>dialog</parameter>
|
|
must be a <link linkend="GtkFileChooserDialog"><type>GtkFileChooserDialog</type></link> (or subclass) and must not have
|
|
<link linkend="GTK-DIALOG-DESTROY-WITH-PARENT:CAPS"><literal>GTK_DIALOG_DESTROY_WITH_PARENT</literal></link> set.
|
|
</para>
|
|
<para>
|
|
Note that <link linkend="GtkFileChooserButton"><type>GtkFileChooserButton</type></link> implements the <link linkend="GtkFileChooser"><type>GtkFileChooser</type></link>
|
|
interface; you can use the <link linkend="GtkFileChooser"><type>GtkFileChooser</type></link> API with it.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> name of path property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>dialog</parameter> :</term>
|
|
<listitem><simpara> the <link linkend="GtkFileChooserDialog"><type>GtkFileChooserDialog</type></link> widget to use.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GtkFileChooserButton"><type>GtkFileChooserButton</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-hscale-new" role="function"/>gimp_prop_hscale_new ()</title>
|
|
<indexterm><primary>gimp_prop_hscale_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_hscale_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gdouble">gdouble</link> step_increment,
|
|
<link linkend="gdouble">gdouble</link> page_increment,
|
|
<link linkend="gint">gint</link> digits);</programlisting>
|
|
<para>
|
|
Creates a horizontal scale to control the value of the specified
|
|
integer or double property.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of integer or double property controlled by the scale.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>step_increment</parameter> :</term>
|
|
<listitem><simpara> Step size.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>page_increment</parameter> :</term>
|
|
<listitem><simpara> Page size.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>digits</parameter> :</term>
|
|
<listitem><simpara> Number of digits after decimal point to display.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GtkScale"><type>GtkScale</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-int-combo-box-new" role="function"/>gimp_prop_int_combo_box_new ()</title>
|
|
<indexterm><primary>gimp_prop_int_combo_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_int_combo_box_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GimpIntStore">GimpIntStore</link> *store);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link> widget to display and set the specified
|
|
property. The contents of the widget are determined by <parameter>store</parameter>,
|
|
which should be created using <link linkend="gimp-int-store-new"><function>gimp_int_store_new()</function></link>.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of int property controlled by combo box.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>store</parameter> :</term>
|
|
<listitem><simpara> <link linkend="GimpIntStore"><type>GimpIntStore</type></link> holding list of labels, values, etc.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The newly created <link linkend="GimpIntComboBox"><type>GimpIntComboBox</type></link> widget, optionally
|
|
wrapped into a <link linkend="GtkEventBox"><type>GtkEventBox</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-label-new" role="function"/>gimp_prop_label_new ()</title>
|
|
<indexterm><primary>gimp_prop_label_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_label_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkLabel"><type>GtkLabel</type></link> 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
|
|
<link linkend="gimp-prop-entry-new"><function>gimp_prop_entry_new()</function></link> instead.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of string property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GtkLabel"><type>GtkLabel</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-memsize-entry-new" role="function"/>gimp_prop_memsize_entry_new ()</title>
|
|
<indexterm><primary>gimp_prop_memsize_entry_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_memsize_entry_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpMemsizeEntry"><type>GimpMemsizeEntry</type></link> (spin button and option menu) to set
|
|
and display the value of the specified memsize property. See
|
|
<link linkend="gimp-memsize-entry-new"><function>gimp_memsize_entry_new()</function></link> for more information.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of memsize property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GimpMemsizeEntry"><type>GimpMemsizeEntry</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-opacity-entry-new" role="function"/>gimp_prop_opacity_entry_new ()</title>
|
|
<indexterm><primary>gimp_prop_opacity_entry_new</primary></indexterm><programlisting><link linkend="GtkObject">GtkObject</link>* gimp_prop_opacity_entry_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkTable">GtkTable</link> *table,
|
|
<link linkend="gint">gint</link> column,
|
|
<link linkend="gint">gint</link> row,
|
|
const <link linkend="gchar">gchar</link> *label);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpScaleEntry"><type>GimpScaleEntry</type></link> (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
|
|
<link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link> for more information.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of double property controlled by the spin button.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>table</parameter> :</term>
|
|
<listitem><simpara> The <link linkend="GtkTable"><type>GtkTable</type></link> the widgets will be attached to.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>column</parameter> :</term>
|
|
<listitem><simpara> The column to start with.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>row</parameter> :</term>
|
|
<listitem><simpara> The row to attach the widgets.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>label</parameter> :</term>
|
|
<listitem><simpara> The text for the <link linkend="GtkLabel"><type>GtkLabel</type></link> which will appear left of the
|
|
<link linkend="GtkHScale"><type>GtkHScale</type></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>'s <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-path-editor-new" role="function"/>gimp_prop_path_editor_new ()</title>
|
|
<indexterm><primary>gimp_prop_path_editor_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_path_editor_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *path_property_name,
|
|
const <link linkend="gchar">gchar</link> *writable_property_name,
|
|
const <link linkend="gchar">gchar</link> *filesel_title);</programlisting>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>path_property_name</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>writable_property_name</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>filesel_title</parameter> :</term>
|
|
<listitem><simpara>
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
|
|
|
|
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-scale-entry-new" role="function"/>gimp_prop_scale_entry_new ()</title>
|
|
<indexterm><primary>gimp_prop_scale_entry_new</primary></indexterm><programlisting><link linkend="GtkObject">GtkObject</link>* gimp_prop_scale_entry_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkTable">GtkTable</link> *table,
|
|
<link linkend="gint">gint</link> column,
|
|
<link linkend="gint">gint</link> row,
|
|
const <link linkend="gchar">gchar</link> *label,
|
|
<link linkend="gdouble">gdouble</link> step_increment,
|
|
<link linkend="gdouble">gdouble</link> page_increment,
|
|
<link linkend="gint">gint</link> digits,
|
|
<link linkend="gboolean">gboolean</link> limit_scale,
|
|
<link linkend="gdouble">gdouble</link> lower_limit,
|
|
<link linkend="gdouble">gdouble</link> upper_limit);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpScaleEntry"><type>GimpScaleEntry</type></link> (slider and spin button) to set and
|
|
display the value of the specified double property. See
|
|
<link linkend="gimp-scale-entry-new"><function>gimp_scale_entry_new()</function></link> for more information.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of double property controlled by the spin button.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>table</parameter> :</term>
|
|
<listitem><simpara> The <link linkend="GtkTable"><type>GtkTable</type></link> the widgets will be attached to.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>column</parameter> :</term>
|
|
<listitem><simpara> The column to start with.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>row</parameter> :</term>
|
|
<listitem><simpara> The row to attach the widgets.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>label</parameter> :</term>
|
|
<listitem><simpara> The text for the <link linkend="GtkLabel"><type>GtkLabel</type></link> which will appear left of
|
|
the <link linkend="GtkHScale"><type>GtkHScale</type></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>step_increment</parameter> :</term>
|
|
<listitem><simpara> Step size.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>page_increment</parameter> :</term>
|
|
<listitem><simpara> Page size.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>digits</parameter> :</term>
|
|
<listitem><simpara> Number of digits after decimal point to display.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>limit_scale</parameter> :</term>
|
|
<listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the range of possible values of the
|
|
GtkSpinButton should be the same as of the GtkHScale.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>lower_limit</parameter> :</term>
|
|
<listitem><simpara> The spinbutton's lower boundary if <parameter>limit_scale</parameter> is <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>upper_limit</parameter> :</term>
|
|
<listitem><simpara> The spinbutton's upper boundary if <parameter>limit_scale</parameter> is <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The <link linkend="GtkSpinButton"><type>GtkSpinButton</type></link>'s <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-size-entry-new" role="function"/>gimp_prop_size_entry_new ()</title>
|
|
<indexterm><primary>gimp_prop_size_entry_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_size_entry_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gboolean">gboolean</link> property_is_pixel,
|
|
const <link linkend="gchar">gchar</link> *unit_property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_format,
|
|
<link linkend="GimpSizeEntryUpdatePolicy">GimpSizeEntryUpdatePolicy</link> update_policy,
|
|
<link linkend="gdouble">gdouble</link> resolution);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> 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 <link linkend="gimp-prop-coordinates-new"><function>gimp_prop_coordinates_new()</function></link> to create a size
|
|
entry holding two values.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of int or double property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_is_pixel</parameter> :</term>
|
|
<listitem><simpara> When <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, the property value is in pixels,
|
|
and in the selected unit otherwise.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>unit_property_name</parameter> :</term>
|
|
<listitem><simpara> Name of unit property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>unit_format</parameter> :</term>
|
|
<listitem><simpara> A printf-like unit-format string as is used with
|
|
<link linkend="gimp-unit-menu-new"><function>gimp_unit_menu_new()</function></link>.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>update_policy</parameter> :</term>
|
|
<listitem><simpara> How the automatic pixel <-> real-world-unit
|
|
calculations should be done.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>resolution</parameter> :</term>
|
|
<listitem><simpara> The resolution (in dpi) for the field.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GimpSizeEntry"><type>GimpSizeEntry</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-spin-button-new" role="function"/>gimp_prop_spin_button_new ()</title>
|
|
<indexterm><primary>gimp_prop_spin_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_spin_button_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gdouble">gdouble</link> step_increment,
|
|
<link linkend="gdouble">gdouble</link> page_increment,
|
|
<link linkend="gint">gint</link> digits);</programlisting>
|
|
<para>
|
|
Creates a spin button to set and display the value of the
|
|
specified double property.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of double property controlled by the spin button.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>step_increment</parameter> :</term>
|
|
<listitem><simpara> Step size.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>page_increment</parameter> :</term>
|
|
<listitem><simpara> Page size.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>digits</parameter> :</term>
|
|
<listitem><simpara> Number of digits after decimal point to display.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GimpSpinButton"><type>GimpSpinButton</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-stock-image-new" role="function"/>gimp_prop_stock_image_new ()</title>
|
|
<indexterm><primary>gimp_prop_stock_image_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_stock_image_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkIconSize">GtkIconSize</link> icon_size);</programlisting>
|
|
<para>
|
|
Creates a widget to display a stock image representing the value of the
|
|
specified string property, which should encode a Stock ID.
|
|
See <link linkend="gtk-image-new-from-stock"><function>gtk_image_new_from_stock()</function></link> for more information.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of string property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>icon_size</parameter> :</term>
|
|
<listitem><simpara> Size of desired stock image.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GtkImage"><type>GtkImage</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-string-combo-box-new" role="function"/>gimp_prop_string_combo_box_new ()</title>
|
|
<indexterm><primary>gimp_prop_string_combo_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_string_combo_box_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="GtkTreeModel">GtkTreeModel</link> *model,
|
|
<link linkend="gint">gint</link> id_column,
|
|
<link linkend="gint">gint</link> label_column);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpStringComboBox"><type>GimpStringComboBox</type></link> widget to display and set the
|
|
specified property. The contents of the widget are determined by
|
|
<parameter>store</parameter>.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of int property controlled by combo box.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>model</parameter> :</term>
|
|
<listitem><simpara> <link linkend="GtkTreeStore"><type>GtkTreeStore</type></link> holding list of values
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>id_column</parameter> :</term>
|
|
<listitem><simpara> column in <parameter>store</parameter> that holds string IDs
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>label_column</parameter> :</term>
|
|
<listitem><simpara> column in <parameter>store</parameter> that holds labels to use in the combo-box
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The newly created <link linkend="GimpStringComboBox"><type>GimpStringComboBox</type></link> widget, optionally
|
|
wrapped into a <link linkend="GtkEventBox"><type>GtkEventBox</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-text-buffer-new" role="function"/>gimp_prop_text_buffer_new ()</title>
|
|
<indexterm><primary>gimp_prop_text_buffer_new</primary></indexterm><programlisting><link linkend="GtkTextBuffer">GtkTextBuffer</link>* gimp_prop_text_buffer_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
<link linkend="gint">gint</link> max_len);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GtkTextBuffer"><type>GtkTextBuffer</type></link> 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
|
|
<link linkend="gimp-prop-entry-new"><function>gimp_prop_entry_new()</function></link> instead. See <link linkend="GtkTextView"><type>GtkTextView</type></link> for information on
|
|
how to insert a text buffer into a visible widget.
|
|
</para>
|
|
<para>
|
|
If <parameter>max_len</parameter> is 0 or negative, the text buffer allows an unlimited
|
|
number of characters to be entered.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of string property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>max_len</parameter> :</term>
|
|
<listitem><simpara> Maximum allowed length of text (in characters).
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GtkTextBuffer"><type>GtkTextBuffer</type></link>.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
<refsect2>
|
|
<title><anchor id="gimp-prop-unit-menu-new" role="function"/>gimp_prop_unit_menu_new ()</title>
|
|
<indexterm><primary>gimp_prop_unit_menu_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_prop_unit_menu_new (<link linkend="GObject">GObject</link> *config,
|
|
const <link linkend="gchar">gchar</link> *property_name,
|
|
const <link linkend="gchar">gchar</link> *unit_format);</programlisting>
|
|
<para>
|
|
Creates a <link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link> to set and display the value of a Unit
|
|
property. See <link linkend="gimp-unit-menu-new"><function>gimp_unit_menu_new()</function></link> for more information.</para>
|
|
<para>
|
|
|
|
</para><variablelist role="params">
|
|
<varlistentry><term><parameter>config</parameter> :</term>
|
|
<listitem><simpara> Object to which property is attached.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>property_name</parameter> :</term>
|
|
<listitem><simpara> Name of Unit property.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><parameter>unit_format</parameter> :</term>
|
|
<listitem><simpara> A printf-like format string which is used to create
|
|
the unit strings.
|
|
</simpara></listitem></varlistentry>
|
|
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="GimpUnitMenu"><type>GimpUnitMenu</type></link> widget.
|
|
|
|
Since GIMP 2.4
|
|
</simpara></listitem></varlistentry>
|
|
</variablelist></refsect2>
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
|
|
|
|
<refsect1><refsect2 /><refsect2 /></refsect1>
|
|
</refentry>
|