Imported Upstream version 2.2.9

This commit is contained in:
Ari Pollak
2010-08-11 01:15:37 -04:00
parent 0b9c5e2b5d
commit f6af42dd71
596 changed files with 118511 additions and 46407 deletions

View File

@ -1,68 +1,81 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>GimpIntComboBox</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual"><link rel="up" href="libgimpwidgets-widgets.html" title="Part<72>I.<2E>GIMP Widgets"><link rel="prev" href="GimpFrame.html" title="GimpFrame"><link rel="next" href="GimpIntStore.html" title="GimpIntStore"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="libgimpwidgets-widgets.html" title="Part<72>I.<2E>GIMP Widgets"><link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy"><link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView"><link rel="part" href="libgimpwidgets-colordisplay.html" title="Part<72>II.<2E>GIMP Display Filters"><link rel="part" href="libgimpwidgets-colorselector.html" title="Part<72>III.<2E>GIMP Color Selectors"><link rel="part" href="libgimpwidgets-controller.html" title="Part<72>IV.<2E>GIMP Controllers"><link rel="part" href="libgimpwidgets-utils.html" title="Part<72>V.<2E>GIMP Widgets Utilities"><link rel="part" href="libgimpwidgets-deprecated.html" title="Part<72>VI.<2E>Deprecated API"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="GimpFrame.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="libgimpwidgets-widgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GIMP Widgets Library Reference Manual</th><td><a accesskey="n" href="GimpIntStore.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="GimpIntComboBox"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle">GimpIntComboBox</span></h2><p>GimpIntComboBox &#8212; A widget providing a popup menu of integer values (e.g. enums).</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GimpIntComboBox</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
<link rel="up" href="libgimpwidgets-widgets.html" title="Part&#160;I.&#160;GIMP Widgets">
<link rel="prev" href="GimpFrame.html" title="GimpFrame">
<link rel="next" href="GimpIntStore.html" title="GimpIntStore">
<meta name="generator" content="GTK-Doc V1.4 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="libgimpwidgets-widgets.html" title="Part&#160;I.&#160;GIMP Widgets">
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part&#160;II.&#160;GIMP Display Filters">
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part&#160;III.&#160;GIMP Color Selectors">
<link rel="part" href="libgimpwidgets-controller.html" title="Part&#160;IV.&#160;GIMP Controllers">
<link rel="part" href="libgimpwidgets-utils.html" title="Part&#160;V.&#160;GIMP Widgets Utilities">
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part&#160;VI.&#160;Deprecated API">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="GimpFrame.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="libgimpwidgets-widgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
<td><a accesskey="n" href="GimpIntStore.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry" lang="en">
<a name="GimpIntComboBox"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle">GimpIntComboBox</span></h2>
<p>GimpIntComboBox &#8212; A widget providing a popup menu of integer values (e.g. enums).</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
<a href="GimpIntComboBox.html#GimpIntComboBox-struct">GimpIntComboBox</a>;
<a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GimpIntComboBox.html#gimp-int-combo-box-new">gimp_int_combo_box_new</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *first_label,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> first_value,
>GtkWidget</a>* <a href="GimpIntComboBox.html#gimp-int-combo-box-new">gimp_int_combo_box_new</a> (const gchar *first_label,
gint first_value,
...);
<a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GimpIntComboBox.html#gimp-int-combo-box-new-valist">gimp_int_combo_box_new_valist</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *first_label,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> first_value,
>GtkWidget</a>* <a href="GimpIntComboBox.html#gimp-int-combo-box-new-valist">gimp_int_combo_box_new_valist</a> (const gchar *first_label,
gint first_value,
va_list values);
<a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GimpIntComboBox.html#gimp-int-combo-box-new-array">gimp_int_combo_box_new_array</a> (<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> n_values,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *labels[]);
>GtkWidget</a>* <a href="GimpIntComboBox.html#gimp-int-combo-box-new-array">gimp_int_combo_box_new_array</a> (gint n_values,
const gchar *labels[]);
void <a href="GimpIntComboBox.html#gimp-int-combo-box-prepend">gimp_int_combo_box_prepend</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
...);
void <a href="GimpIntComboBox.html#gimp-int-combo-box-append">gimp_int_combo_box_append</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
...);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GimpIntComboBox.html#gimp-int-combo-box-set-active">gimp_int_combo_box_set_active</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> value);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GimpIntComboBox.html#gimp-int-combo-box-get-active">gimp_int_combo_box_get_active</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *value);
<a
href="../glib/glib-Basic-Types.html#gulong"
>gulong</a> <a href="GimpIntComboBox.html#gimp-int-combo-box-connect">gimp_int_combo_box_connect</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> value,
<a
href="../gobject/gobject-Closures.html#GCallback"
>GCallback</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);
gboolean <a href="GimpIntComboBox.html#gimp-int-combo-box-set-active">gimp_int_combo_box_set_active</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
gint value);
gboolean <a href="GimpIntComboBox.html#gimp-int-combo-box-get-active">gimp_int_combo_box_get_active</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
gint *value);
gulong <a href="GimpIntComboBox.html#gimp-int-combo-box-connect">gimp_int_combo_box_connect</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
gint value,
GCallback callback,
gpointer data);
</pre></div><div class="refsect1" lang="en"><a name="id2535192"></a><h2>Object Hierarchy</h2><pre class="synopsis">
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2519480"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
GObject
+----<a
href="../gtk/GtkObject.html"
>GtkObject</a>
@ -79,155 +92,393 @@ href="../gtk/GtkBin.html"
href="../gtk/GtkComboBox.html"
>GtkComboBox</a>
+----GimpIntComboBox
</pre></div><div class="refsect1" lang="en"><a name="id2535234"></a><h2>Implemented Interfaces</h2><p>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2519530"></a><h2>Implemented Interfaces</h2>
<p>
GimpIntComboBox implements
AtkImplementorIface, <a
href="../gtk/GtkCellEditable.html"
>GtkCellEditable</a> and <a
href="../gtk/GtkCellLayout.html"
>GtkCellLayout</a>.</p></div><div class="refsect1" lang="en"><a name="id2535259"></a><h2>Description</h2><p>
>GtkCellLayout</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="id2519559"></a><h2>Description</h2>
<p>
A widget providing a popup menu of integer values (e.g. enums).
</p></div><div class="refsect1" lang="en"><a name="id2535270"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2535275"></a><h3><a name="GimpIntComboBox-struct"></a>GimpIntComboBox</h3><a class="indexterm" name="id2535283"></a><pre class="programlisting">typedef struct _GimpIntComboBox GimpIntComboBox;</pre><p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2519571"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2519578"></a><h3>
<a name="GimpIntComboBox-struct"></a>GimpIntComboBox</h3>
<a class="indexterm" name="id2519587"></a><pre class="programlisting">typedef struct _GimpIntComboBox GimpIntComboBox;</pre>
<p>
</p></div><hr><div class="refsect2" lang="en"><a name="id2535294"></a><h3><a name="gimp-int-combo-box-new"></a>gimp_int_combo_box_new ()</h3><a class="indexterm" name="id2540005"></a><pre class="programlisting"><a
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2519603"></a><h3>
<a name="gimp-int-combo-box-new"></a>gimp_int_combo_box_new ()</h3>
<a class="indexterm" name="id2563417"></a><pre class="programlisting"><a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* gimp_int_combo_box_new (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *first_label,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> first_value,
...);</pre><p>
>GtkWidget</a>* gimp_int_combo_box_new (const gchar *first_label,
gint first_value,
...);</pre>
<p>
Creates a GtkComboBox that has integer values associated with each
item. The items to fill the combo box with are specified as a <code class="literal">NULL</code>
terminated list of label/value pairs.</p><p>
terminated list of label/value pairs.</p>
<p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>first_label</code></em><EFBFBD>:</span></td><td> the label of the first item
</td></tr><tr><td><span class="term"><em class="parameter"><code>first_value</code></em><EFBFBD>:</span></td><td> the value of the first item
</td></tr><tr><td><span class="term"><em class="parameter"><code>...</code></em><EFBFBD>:</span></td><td> a <code class="literal">NULL</code> terminated list of more label, value pairs
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> a new <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>first_label</code></em>&#160;:</span></td>
<td> the label of the first item
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>first_value</code></em>&#160;:</span></td>
<td> the value of the first item
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td> a <code class="literal">NULL</code> terminated list of more label, value pairs
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a new <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>.
</td></tr></tbody></table></div><p>Since GIMP 2.2
</p></div><hr><div class="refsect2" lang="en"><a name="id2540102"></a><h3><a name="gimp-int-combo-box-new-valist"></a>gimp_int_combo_box_new_valist ()</h3><a class="indexterm" name="id2540113"></a><pre class="programlisting"><a
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2563540"></a><h3>
<a name="gimp-int-combo-box-new-valist"></a>gimp_int_combo_box_new_valist ()</h3>
<a class="indexterm" name="id2563551"></a><pre class="programlisting"><a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* gimp_int_combo_box_new_valist (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *first_label,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> first_value,
va_list values);</pre><p>
>GtkWidget</a>* gimp_int_combo_box_new_valist (const gchar *first_label,
gint first_value,
va_list values);</pre>
<p>
A variant of <a href="GimpIntComboBox.html#gimp-int-combo-box-new"><code class="function">gimp_int_combo_box_new()</code></a> that takes a va_list of
label/value pairs. Probably only useful for language bindings.</p><p>
label/value pairs. Probably only useful for language bindings.</p>
<p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>first_label</code></em><EFBFBD>:</span></td><td> the label of the first item
</td></tr><tr><td><span class="term"><em class="parameter"><code>first_value</code></em><EFBFBD>:</span></td><td> the value of the first item
</td></tr><tr><td><span class="term"><em class="parameter"><code>values</code></em><EFBFBD>:</span></td><td> a va_list with more values
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> a new <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>first_label</code></em>&#160;:</span></td>
<td> the label of the first item
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>first_value</code></em>&#160;:</span></td>
<td> the value of the first item
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>values</code></em>&#160;:</span></td>
<td> a va_list with more values
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a new <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>.
</td></tr></tbody></table></div><p>Since GIMP 2.2
</p></div><hr><div class="refsect2" lang="en"><a name="id2540214"></a><h3><a name="gimp-int-combo-box-new-array"></a>gimp_int_combo_box_new_array ()</h3><a class="indexterm" name="id2540225"></a><pre class="programlisting"><a
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2564499"></a><h3>
<a name="gimp-int-combo-box-new-array"></a>gimp_int_combo_box_new_array ()</h3>
<a class="indexterm" name="id2564509"></a><pre class="programlisting"><a
href="../gtk/GtkWidget.html"
>GtkWidget</a>* gimp_int_combo_box_new_array (<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> n_values,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *labels[]);</pre><p>
>GtkWidget</a>* gimp_int_combo_box_new_array (gint n_values,
const gchar *labels[]);</pre>
<p>
A variant of <a href="GimpIntComboBox.html#gimp-int-combo-box-new"><code class="function">gimp_int_combo_box_new()</code></a> that takes an array of labels.
The array indices are used as values.</p><p>
The array indices are used as values.</p>
<p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>n_values</code></em><EFBFBD>:</span></td><td> the number of values
</td></tr><tr><td><span class="term"><em class="parameter"><code>labels</code></em><EFBFBD>:</span></td><td> an array of labels (array length must be <em class="parameter"><code>n_values</code></em>)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> a new <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>n_values</code></em>&#160;:</span></td>
<td> the number of values
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>labels</code></em>&#160;:</span></td>
<td> an array of labels (array length must be <em class="parameter"><code>n_values</code></em>)
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a new <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>.
</td></tr></tbody></table></div><p>Since GIMP 2.2
</p></div><hr><div class="refsect2" lang="en"><a name="id2586005"></a><h3><a name="gimp-int-combo-box-prepend"></a>gimp_int_combo_box_prepend ()</h3><a class="indexterm" name="id2586014"></a><pre class="programlisting">void gimp_int_combo_box_prepend (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
...);</pre><p>
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2564618"></a><h3>
<a name="gimp-int-combo-box-prepend"></a>gimp_int_combo_box_prepend ()</h3>
<a class="indexterm" name="id2564628"></a><pre class="programlisting">void gimp_int_combo_box_prepend (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
...);</pre>
<p>
This function provides a convenient way to prepend items to a
<a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>. It prepends a row to the <em class="parameter"><code>combo_box</code></em>'s list store
and calls <a
href="../gtk/GtkListStore.html#gtk-list-store-set"
><code class="function">gtk_list_store_set()</code></a> for you.
</p><p>
The column number must be taken from the enum <a href="GimpIntStore.html#GimpIntStoreColumns"><span class="type">GimpIntStoreColumns</span></a>.</p><p>
</p>
<p>
The column number must be taken from the enum <a href="GimpIntStore.html#GimpIntStoreColumns"><span class="type">GimpIntStoreColumns</span></a>.</p>
<p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>combo_box</code></em><EFBFBD>:</span></td><td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td></tr><tr><td><span class="term"><em class="parameter"><code>...</code></em><EFBFBD>:</span></td><td> pairs of column number and value, terminated with -1
</td></tr></tbody></table></div><p>Since GIMP 2.2
</p></div><hr><div class="refsect2" lang="en"><a name="id2586102"></a><h3><a name="gimp-int-combo-box-append"></a>gimp_int_combo_box_append ()</h3><a class="indexterm" name="id2586111"></a><pre class="programlisting">void gimp_int_combo_box_append (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
...);</pre><p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>combo_box</code></em>&#160;:</span></td>
<td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td> pairs of column number and value, terminated with -1
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2564740"></a><h3>
<a name="gimp-int-combo-box-append"></a>gimp_int_combo_box_append ()</h3>
<a class="indexterm" name="id2564749"></a><pre class="programlisting">void gimp_int_combo_box_append (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
...);</pre>
<p>
This function provides a convenient way to append items to a
<a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>. It appends a row to the <em class="parameter"><code>combo_box</code></em>'s list store
and calls <a
href="../gtk/GtkListStore.html#gtk-list-store-set"
><code class="function">gtk_list_store_set()</code></a> for you.
</p><p>
The column number must be taken from the enum <a href="GimpIntStore.html#GimpIntStoreColumns"><span class="type">GimpIntStoreColumns</span></a>.</p><p>
</p>
<p>
The column number must be taken from the enum <a href="GimpIntStore.html#GimpIntStoreColumns"><span class="type">GimpIntStoreColumns</span></a>.</p>
<p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>combo_box</code></em><EFBFBD>:</span></td><td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td></tr><tr><td><span class="term"><em class="parameter"><code>...</code></em><EFBFBD>:</span></td><td> pairs of column number and value, terminated with -1
</td></tr></tbody></table></div><p>Since GIMP 2.2
</p></div><hr><div class="refsect2" lang="en"><a name="id2586198"></a><h3><a name="gimp-int-combo-box-set-active"></a>gimp_int_combo_box_set_active ()</h3><a class="indexterm" name="id2586209"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_int_combo_box_set_active (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> value);</pre><p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>combo_box</code></em>&#160;:</span></td>
<td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td> pairs of column number and value, terminated with -1
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2566997"></a><h3>
<a name="gimp-int-combo-box-set-active"></a>gimp_int_combo_box_set_active ()</h3>
<a class="indexterm" name="id2567007"></a><pre class="programlisting">gboolean gimp_int_combo_box_set_active (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
gint value);</pre>
<p>
Looks up the item that belongs to the given <em class="parameter"><code>value</code></em> and makes it the
selected item in the <em class="parameter"><code>combo_box</code></em>.</p><p>
selected item in the <em class="parameter"><code>combo_box</code></em>.</p>
<p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>combo_box</code></em><EFBFBD>:</span></td><td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td></tr><tr><td><span class="term"><em class="parameter"><code>value</code></em><EFBFBD>:</span></td><td> an integer value
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> <code class="literal">TRUE</code> on success or <code class="literal">FALSE</code> if there was no item for
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>combo_box</code></em>&#160;:</span></td>
<td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
<td> an integer value
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <code class="literal">TRUE</code> on success or <code class="literal">FALSE</code> if there was no item for
this value.
</td></tr></tbody></table></div><p>Since GIMP 2.2
</p></div><hr><div class="refsect2" lang="en"><a name="id2593907"></a><h3><a name="gimp-int-combo-box-get-active"></a>gimp_int_combo_box_get_active ()</h3><a class="indexterm" name="id2593918"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_int_combo_box_get_active (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *value);</pre><p>
Retrieves the value of the selected (active) item in the <em class="parameter"><code>combo_box</code></em>.</p><p>
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2567099"></a><h3>
<a name="gimp-int-combo-box-get-active"></a>gimp_int_combo_box_get_active ()</h3>
<a class="indexterm" name="id2567109"></a><pre class="programlisting">gboolean gimp_int_combo_box_get_active (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
gint *value);</pre>
<p>
Retrieves the value of the selected (active) item in the <em class="parameter"><code>combo_box</code></em>.</p>
<p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>combo_box</code></em><EFBFBD>:</span></td><td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td></tr><tr><td><span class="term"><em class="parameter"><code>value</code></em><EFBFBD>:</span></td><td> return location for the integer value
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> <code class="literal">TRUE</code> if <em class="parameter"><code>value</code></em> has been set or <code class="literal">FALSE</code> if no item was
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>combo_box</code></em>&#160;:</span></td>
<td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
<td> return location for the integer value
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>value</code></em> has been set or <code class="literal">FALSE</code> if no item was
active.
</td></tr></tbody></table></div><p>Since GIMP 2.2
</p></div><hr><div class="refsect2" lang="en"><a name="id2594009"></a><h3><a name="gimp-int-combo-box-connect"></a>gimp_int_combo_box_connect ()</h3><a class="indexterm" name="id2594018"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gulong"
>gulong</a> gimp_int_combo_box_connect (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> value,
<a
href="../gobject/gobject-Closures.html#GCallback"
>GCallback</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre><p>
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2567216"></a><h3>
<a name="gimp-int-combo-box-connect"></a>gimp_int_combo_box_connect ()</h3>
<a class="indexterm" name="id2567225"></a><pre class="programlisting">gulong gimp_int_combo_box_connect (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
gint value,
GCallback callback,
gpointer data);</pre>
<p>
A convenience function that sets the inital <em class="parameter"><code>value</code></em> of a
<a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a> and connects <em class="parameter"><code>callback</code></em> to the "changed"
signal.
</p><p>
</p>
<p>
This function also calls the <em class="parameter"><code>callback</code></em> once after setting the
initial <em class="parameter"><code>value</code></em>. This is often convenient when working with combo
boxes that select a default active item (like for example
gimp_drawable_combo_box_new). If you pass an invalid initial
<em class="parameter"><code>value</code></em>, the <em class="parameter"><code>callback</code></em> will be called with the default item active.</p><p>
<em class="parameter"><code>value</code></em>, the <em class="parameter"><code>callback</code></em> will be called with the default item active.</p>
<p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>combo_box</code></em><EFBFBD>:</span></td><td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td></tr><tr><td><span class="term"><em class="parameter"><code>value</code></em><EFBFBD>:</span></td><td> the value to set
</td></tr><tr><td><span class="term"><em class="parameter"><code>callback</code></em><EFBFBD>:</span></td><td> a callback to connect to the <em class="parameter"><code>combo_box</code></em>'s "changed" signal
</td></tr><tr><td><span class="term"><em class="parameter"><code>data</code></em><EFBFBD>:</span></td><td> a pointer passed as data to <a
href="../gobject/gobject-Signals.html#g-signal-connect"
><code class="function">g_signal_connect()</code></a>
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span><EFBFBD>:</span></td><td> the signal handler ID as returned by <a
href="../gobject/gobject-Signals.html#g-signal-connect"
><code class="function">g_signal_connect()</code></a>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>combo_box</code></em>&#160;:</span></td>
<td> a <a href="GimpIntComboBox.html" title="GimpIntComboBox"><span class="type">GimpIntComboBox</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
<td> the value to set
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
<td> a callback to connect to the <em class="parameter"><code>combo_box</code></em>'s "changed" signal
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
<td> a pointer passed as data to <code class="function">g_signal_connect()</code>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the signal handler ID as returned by <code class="function">g_signal_connect()</code>
</td></tr></tbody></table></div><p>Since GIMP 2.2
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="GimpFrame.html"><b>&lt;&lt;<EFBFBD>GimpFrame</b></a></td><td align="right"><a accesskey="n" href="GimpIntStore.html"><b>GimpIntStore<EFBFBD>&gt;&gt;</b></a></td></tr></table></body></html>
</td>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
</p>
</div>
</div>
</div>
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
<td align="left"><a accesskey="p" href="GimpFrame.html"><b>&lt;&lt;&#160;GimpFrame</b></a></td>
<td align="right"><a accesskey="n" href="GimpIntStore.html"><b>GimpIntStore&#160;&gt;&gt;</b></a></td>
</tr></table>
</body>
</html>