Imported Upstream version 2.3.16

This commit is contained in:
Ari Pollak
2010-08-11 01:21:23 -04:00
parent d694295a3e
commit 2e1d89b96f
944 changed files with 103935 additions and 69090 deletions

View File

@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GimpIntComboBox</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.71.0">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
<link rel="up" href="libgimpwidgets-widgets.html" title="Part&#160;I.&#160;GIMP Widgets">
<link rel="prev" href="libgimpwidgets-GimpHintBox.html" title="GimpHintBox">
<link rel="next" href="GimpIntStore.html" title="GimpIntStore">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="libgimpwidgets-widgets.html" title="Part&#160;I.&#160;GIMP Widgets">
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
@ -33,22 +33,22 @@
<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>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2563357" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2559955" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2600920" class="shortcut">Description</a>
<a href="#id2612088" class="shortcut">Description</a>
&#160;|&#160;
<a href="#id2552159" class="shortcut">Object Hierarchy</a>
<a href="#id2565167" class="shortcut">Object Hierarchy</a>
&#160;|&#160;
<a href="#id2600856" class="shortcut">Implemented Interfaces</a>
<a href="#id2612024" class="shortcut">Implemented Interfaces</a>
&#160;|&#160;
<a href="#id2600889" class="shortcut">Properties</a></nobr></td></tr>
<a href="#id2612058" class="shortcut">Properties</a></nobr></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>
<a name="id2563357"></a><span class="refentrytitle">GimpIntComboBox</span>
<a name="id2559955"></a><span class="refentrytitle">GimpIntComboBox</span>
</h2>
<p>GimpIntComboBox &#8212; A widget providing a popup menu of integer values (e.g. enums).</p>
</td>
@ -60,39 +60,38 @@
<a href="GimpIntComboBox.html#GimpIntComboBox-struct">GimpIntComboBox</a>;
gboolean (<a href="GimpIntComboBox.html#GimpIntSensitivityFunc">*GimpIntSensitivityFunc</a>) (gint value,
gpointer data);
GtkWidget* <a href="GimpIntComboBox.html#gimp-int-combo-box-new">gimp_int_combo_box_new</a> (const gchar *first_label,
gint first_value,
...);
GtkWidget* <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);
GtkWidget* <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,
...);
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);
void <a href="GimpIntComboBox.html#gimp-int-combo-box-set-sensitivity">gimp_int_combo_box_set_sensitivity</a>
(<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a href="GimpIntComboBox.html#GimpIntSensitivityFunc">GimpIntSensitivityFunc</a> func,
gpointer data,
GDestroyNotify destroy);
<a href="GimpIntComboBox.html#GimpIntComboBox-struct">GimpIntComboBox</a>;
gboolean (<a href="GimpIntComboBox.html#GimpIntSensitivityFunc">*GimpIntSensitivityFunc</a>) (gint value,
gpointer data);
GtkWidget* <a href="GimpIntComboBox.html#gimp-int-combo-box-new">gimp_int_combo_box_new</a> (const gchar *first_label,
gint first_value,
...);
GtkWidget* <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);
GtkWidget* <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,
...);
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);
void <a href="GimpIntComboBox.html#gimp-int-combo-box-set-sensitivity">gimp_int_combo_box_set_sensitivity</a> (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a href="GimpIntComboBox.html#GimpIntSensitivityFunc">GimpIntSensitivityFunc</a> func,
gpointer data,
GDestroyNotify destroy);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2552159"></a><h2>Object Hierarchy</h2>
<a name="id2565167"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
GObject
@ -107,40 +106,40 @@ void <a href="GimpIntComboBox.html#gimp-int-combo-box-set-sensitivity">gi
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2600856"></a><h2>Implemented Interfaces</h2>
<a name="id2612024"></a><h2>Implemented Interfaces</h2>
<p>
GimpIntComboBox implements
AtkImplementorIface, GtkCellEditable and GtkCellLayout.</p>
</div>
<div class="refsect1" lang="en">
<a name="id2600889"></a><h2>Properties</h2>
<a name="id2612058"></a><h2>Properties</h2>
<pre class="synopsis">
"<a href="GimpIntComboBox.html#GimpIntComboBox--ellipsize">ellipsize</a>" PangoEllipsizeMode : Read / Write
"<a href="GimpIntComboBox.html#GimpIntComboBox--ellipsize">ellipsize</a>" PangoEllipsizeMode : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2600920"></a><h2>Description</h2>
<a name="id2612088"></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="id2600937"></a><h2>Details</h2>
<a name="id2612105"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2600947"></a><h3>
<a name="id2612116"></a><h3>
<a name="GimpIntComboBox-struct"></a>GimpIntComboBox</h3>
<a class="indexterm" name="id2600959"></a><pre class="programlisting">typedef struct _GimpIntComboBox GimpIntComboBox;</pre>
<a class="indexterm" name="id2612128"></a><pre class="programlisting">typedef struct _GimpIntComboBox GimpIntComboBox;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2600975"></a><h3>
<a name="id2612144"></a><h3>
<a name="GimpIntSensitivityFunc"></a>GimpIntSensitivityFunc ()</h3>
<a class="indexterm" name="id2600987"></a><pre class="programlisting">gboolean (*GimpIntSensitivityFunc) (gint value,
gpointer data);</pre>
<a class="indexterm" name="id2612155"></a><pre class="programlisting">gboolean (*GimpIntSensitivityFunc) (gint value,
gpointer data);</pre>
<p>
</p>
@ -169,11 +168,11 @@ A widget providing a popup menu of integer values (e.g. enums).
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2601063"></a><h3>
<a name="id2612233"></a><h3>
<a name="gimp-int-combo-box-new"></a>gimp_int_combo_box_new ()</h3>
<a class="indexterm" name="id2601077"></a><pre class="programlisting">GtkWidget* gimp_int_combo_box_new (const gchar *first_label,
gint first_value,
...);</pre>
<a class="indexterm" name="id2612246"></a><pre class="programlisting">GtkWidget* 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>
@ -211,16 +210,16 @@ g_object_new (GIMP_TYPE_INT_COMBO_BOX, NULL).</p>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602012"></a><h3>
<a name="id2564018"></a><h3>
<a name="gimp-int-combo-box-new-valist"></a>gimp_int_combo_box_new_valist ()</h3>
<a class="indexterm" name="id2602027"></a><pre class="programlisting">GtkWidget* gimp_int_combo_box_new_valist (const gchar *first_label,
gint first_value,
va_list values);</pre>
<a class="indexterm" name="id2564032"></a><pre class="programlisting">GtkWidget* 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>
@ -253,15 +252,15 @@ label/value pairs. Probably only useful for language bindings.</p>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2602153"></a><h3>
<a name="id2564160"></a><h3>
<a name="gimp-int-combo-box-new-array"></a>gimp_int_combo_box_new_array ()</h3>
<a class="indexterm" name="id2605978"></a><pre class="programlisting">GtkWidget* gimp_int_combo_box_new_array (gint n_values,
const gchar *labels[]);</pre>
<a class="indexterm" name="id2614214"></a><pre class="programlisting">GtkWidget* 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>
@ -289,15 +288,15 @@ The array indices are used as values.</p>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606078"></a><h3>
<a name="id2614316"></a><h3>
<a name="gimp-int-combo-box-prepend"></a>gimp_int_combo_box_prepend ()</h3>
<a class="indexterm" name="id2606091"></a><pre class="programlisting">void gimp_int_combo_box_prepend (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
...);</pre>
<a class="indexterm" name="id2614329"></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
@ -323,15 +322,15 @@ The column number must be taken from the enum <a href="GimpIntStore.html#GimpInt
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606202"></a><h3>
<a name="id2614444"></a><h3>
<a name="gimp-int-combo-box-append"></a>gimp_int_combo_box_append ()</h3>
<a class="indexterm" name="id2606217"></a><pre class="programlisting">void gimp_int_combo_box_append (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
...);</pre>
<a class="indexterm" name="id2614459"></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
@ -357,15 +356,15 @@ The column number must be taken from the enum <a href="GimpIntStore.html#GimpInt
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606329"></a><h3>
<a name="id2614574"></a><h3>
<a name="gimp-int-combo-box-set-active"></a>gimp_int_combo_box_set_active ()</h3>
<a class="indexterm" name="id2606345"></a><pre class="programlisting">gboolean gimp_int_combo_box_set_active (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
gint value);</pre>
<a class="indexterm" name="id2614589"></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>
@ -394,15 +393,15 @@ selected item in the <em class="parameter"><code>combo_box</code></em>.</p>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606471"></a><h3>
<a name="id2614718"></a><h3>
<a name="gimp-int-combo-box-get-active"></a>gimp_int_combo_box_get_active ()</h3>
<a class="indexterm" name="id2606487"></a><pre class="programlisting">gboolean gimp_int_combo_box_get_active (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
gint *value);</pre>
<a class="indexterm" name="id2614733"></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>
@ -430,17 +429,17 @@ Retrieves the value of the selected (active) item in the <em class="parameter"><
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606614"></a><h3>
<a name="id2614862"></a><h3>
<a name="gimp-int-combo-box-connect"></a>gimp_int_combo_box_connect ()</h3>
<a class="indexterm" name="id2606628"></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>
<a class="indexterm" name="id2614876"></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"
@ -488,18 +487,17 @@ href="../libgimp/libgimp-GimpItemComboBox.html#gimp-drawable-combo-box-new"
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.2
<p class="since">Since GIMP 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2606850"></a><h3>
<a name="id2615101"></a><h3>
<a name="gimp-int-combo-box-set-sensitivity"></a>gimp_int_combo_box_set_sensitivity ()</h3>
<a class="indexterm" name="id2606866"></a><pre class="programlisting">void gimp_int_combo_box_set_sensitivity
(<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a href="GimpIntComboBox.html#GimpIntSensitivityFunc">GimpIntSensitivityFunc</a> func,
gpointer data,
GDestroyNotify destroy);</pre>
<a class="indexterm" name="id2615118"></a><pre class="programlisting">void gimp_int_combo_box_set_sensitivity (<a href="GimpIntComboBox.html" title="GimpIntComboBox">GimpIntComboBox</a> *combo_box,
<a href="GimpIntComboBox.html#GimpIntSensitivityFunc">GimpIntSensitivityFunc</a> func,
gpointer data,
GDestroyNotify destroy);</pre>
<p>
Sets a function that is used to decide about the sensitivity of
rows in the <em class="parameter"><code>combo_box</code></em>. Use this if you want to set certain rows
@ -536,16 +534,16 @@ sensitivity to be updated.</p>
</tr>
</tbody>
</table></div>
<p>Since GIMP 2.4
<p class="since">Since GIMP 2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2607042"></a><h2>Property Details</h2>
<a name="id2615296"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id2607053"></a><h3>
<a name="id2615306"></a><h3>
<a name="GimpIntComboBox--ellipsize"></a>The "<code class="literal">ellipsize</code>" property</h3>
<a class="indexterm" name="id2607066"></a><pre class="programlisting"> "ellipsize" PangoEllipsizeMode : Read / Write</pre>
<a class="indexterm" name="id2615320"></a><pre class="programlisting"> "ellipsize" PangoEllipsizeMode : Read / Write</pre>
<p>
Specifies the preferred place to ellipsize text in the combo-box,
if the cell renderer does not have enough room to display the