Imported Upstream version 2.2.14

This commit is contained in:
Ari Pollak
2010-08-11 01:17:12 -04:00
parent 70ad8213cf
commit a2f097051e
490 changed files with 35329 additions and 58398 deletions

View File

@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GimpDialog</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<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="GimpColorSelection.html" title="GimpColorSelection">
<link rel="next" href="GimpFileEntry.html" title="GimpFileEntry">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<meta name="generator" content="GTK-Doc V1.7 (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">
@ -28,26 +28,30 @@
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
<td><a accesskey="n" href="GimpFileEntry.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="#top_of_page" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2595684" class="shortcut">Top</a>
&#160;|&#160;
<a href="#desc" class="shortcut">Description</a>
<a href="#id2580587" class="shortcut">Description</a>
&#160;|&#160;
<a href="#object_hierarchy" class="shortcut">Object Hierarchy</a>
<a href="#id2580454" class="shortcut">Object Hierarchy</a>
&#160;|&#160;
<a href="#properties" class="shortcut">Properties</a></nobr></td></tr>
<a href="#id2580522" class="shortcut">Implemented Interfaces</a>
&#160;|&#160;
<a href="#id2580543" class="shortcut">Properties</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GimpDialog"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="top_of_page"></a>GimpDialog</span></h2>
<h2>
<a name="id2595684"></a><span class="refentrytitle">GimpDialog</span>
</h2>
<p>GimpDialog &#8212; Constructors for <span class="type">GtkDialog</span>'s and action_areas as well as other
dialog-related stuff.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="synopsis"></a><h2>Synopsis</h2>
<h2>Synopsis</h2>
<pre class="synopsis">
@ -75,7 +79,7 @@ void <a href="GimpDialog.html#gimp-dialogs-show-help-button">gimp_dialogs
</pre>
</div>
<div class="refsect1" lang="en">
<a name="object_hierarchy"></a><h2>Object Hierarchy</h2>
<a name="id2580454"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
GObject
@ -90,13 +94,13 @@ void <a href="GimpDialog.html#gimp-dialogs-show-help-button">gimp_dialogs
</pre>
</div>
<div class="refsect1" lang="en">
<a name="impl_interfaces"></a><h2>Implemented Interfaces</h2>
<a name="id2580522"></a><h2>Implemented Interfaces</h2>
<p>
GimpDialog implements
AtkImplementorIface.</p>
</div>
<div class="refsect1" lang="en">
<a name="properties"></a><h2>Properties</h2>
<a name="id2580543"></a><h2>Properties</h2>
<pre class="synopsis">
"<a href="GimpDialog.html#GimpDialog--help-func">help-func</a>" gpointer : Read / Write / Construct Only
@ -104,26 +108,26 @@ GimpDialog implements
</pre>
</div>
<div class="refsect1" lang="en">
<a name="desc"></a><h2>Description</h2>
<a name="id2580587"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="details"></a><h2>Details</h2>
<a name="id2556714"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2528047"></a><h3>
<a name="id2556725"></a><h3>
<a name="GimpDialog-struct"></a>GimpDialog</h3>
<a class="indexterm" name="id2528059"></a><pre class="programlisting">typedef struct _GimpDialog GimpDialog;</pre>
<a class="indexterm" name="id2556738"></a><pre class="programlisting">typedef struct _GimpDialog GimpDialog;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2528074"></a><h3>
<a name="id2556753"></a><h3>
<a name="gimp-dialog-new"></a>gimp_dialog_new ()</h3>
<a class="indexterm" name="id2528086"></a><pre class="programlisting">GtkWidget* gimp_dialog_new (const gchar *title,
<a class="indexterm" name="id2556765"></a><pre class="programlisting">GtkWidget* gimp_dialog_new (const gchar *title,
const gchar *role,
GtkWidget *parent,
GtkDialogFlags flags,
@ -147,53 +151,45 @@ action_area buttons see <code class="function">gtk_dialog_new_with_buttons()</co
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
<td> The dialog's title which will be set with
<code class="function">gtk_window_set_title()</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>role</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>role</code></em>&#160;:</span></td>
<td> The dialog's <em class="parameter"><code>role</code></em> which will be set with
<code class="function">gtk_window_set_role()</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>parent</code></em> widget of this dialog.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>flags</code></em> (see the <span class="type">GtkDialog</span> documentation).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
<td> The function which will be called if the user presses "F1".
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
<td> The help_id which will be passed to <em class="parameter"><code>help_func</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td> A <code class="literal">NULL</code>-terminated <em class="parameter"><code>va_list</code></em> destribing the
action_area buttons.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <a href="GimpDialog.html" title="GimpDialog"><span class="type">GimpDialog</span></a>.
</td>
</tr>
@ -202,9 +198,9 @@ action_area buttons see <code class="function">gtk_dialog_new_with_buttons()</co
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2526401"></a><h3>
<a name="id2575934"></a><h3>
<a name="gimp-dialog-new-valist"></a>gimp_dialog_new_valist ()</h3>
<a class="indexterm" name="id2526412"></a><pre class="programlisting">GtkWidget* gimp_dialog_new_valist (const gchar *title,
<a class="indexterm" name="id2575945"></a><pre class="programlisting">GtkWidget* gimp_dialog_new_valist (const gchar *title,
const gchar *role,
GtkWidget *parent,
GtkDialogFlags flags,
@ -225,52 +221,44 @@ action_area buttons see <code class="function">gtk_dialog_new_with_buttons()</co
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
<td> The dialog's title which will be set with
<code class="function">gtk_window_set_title()</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>role</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>role</code></em>&#160;:</span></td>
<td> The dialog's <em class="parameter"><code>role</code></em> which will be set with
<code class="function">gtk_window_set_role()</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>parent</code></em> widget of this dialog or <code class="literal">NULL</code>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>flags</code></em> (see the <span class="type">GtkDialog</span> documentation).
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
<td> The function which will be called if the user presses "F1".
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
<td> The help_id which will be passed to <em class="parameter"><code>help_func</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>args</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>args</code></em>&#160;:</span></td>
<td> A <em class="parameter"><code>va_list</code></em> destribing the action_area buttons.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A <a href="GimpDialog.html" title="GimpDialog"><span class="type">GimpDialog</span></a>.
</td>
</tr>
@ -279,9 +267,9 @@ action_area buttons see <code class="function">gtk_dialog_new_with_buttons()</co
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2572313"></a><h3>
<a name="id2605499"></a><h3>
<a name="gimp-dialog-add-buttons-valist"></a>gimp_dialog_add_buttons_valist ()</h3>
<a class="indexterm" name="id2572323"></a><pre class="programlisting">void gimp_dialog_add_buttons_valist (<a href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog,
<a class="indexterm" name="id2605510"></a><pre class="programlisting">void gimp_dialog_add_buttons_valist (<a href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog,
va_list args);</pre>
<p>
This function is essentially the same as <code class="function">gtk_dialog_add_buttons()</code>
@ -293,14 +281,12 @@ except it takes a va_list instead of '...'</p>
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></td>
<td> The <em class="parameter"><code>dialog</code></em> to add buttons to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>args</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>args</code></em>&#160;:</span></td>
<td> The buttons as va_list.
</td>
</tr>
@ -309,9 +295,9 @@ except it takes a va_list instead of '...'</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2572409"></a><h3>
<a name="id2605595"></a><h3>
<a name="gimp-dialog-run"></a>gimp_dialog_run ()</h3>
<a class="indexterm" name="id2572421"></a><pre class="programlisting">gint gimp_dialog_run (<a href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog);</pre>
<a class="indexterm" name="id2605608"></a><pre class="programlisting">gint gimp_dialog_run (<a href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog);</pre>
<p>
This function does exactly the same as <code class="function">gtk_dialog_run()</code> except it
does not make the dialog modal while the <span class="type">GMainLoop</span> is running.</p>
@ -322,14 +308,12 @@ does not make the dialog modal while the <span class="type">GMainLoop</span> is
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></td>
<td> a <a href="GimpDialog.html" title="GimpDialog"><span class="type">GimpDialog</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> response ID
</td>
</tr>
@ -338,9 +322,9 @@ does not make the dialog modal while the <span class="type">GMainLoop</span> is
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2572507"></a><h3>
<a name="id2605693"></a><h3>
<a name="gimp-dialogs-show-help-button"></a>gimp_dialogs_show_help_button ()</h3>
<a class="indexterm" name="id2572523"></a><pre class="programlisting">void gimp_dialogs_show_help_button (gboolean show);</pre>
<a class="indexterm" name="id2605709"></a><pre class="programlisting">void gimp_dialogs_show_help_button (gboolean show);</pre>
<p>
This function is for internal use only.</p>
<p>
@ -349,8 +333,7 @@ This function is for internal use only.</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>show</code></em>&#160;:</span></td>
<td><span class="term"><em class="parameter"><code>show</code></em>&#160;:</span></td>
<td> whether a help button should be added when creating a GimpDialog
</td>
</tr></tbody>
@ -360,18 +343,18 @@ This function is for internal use only.</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="property_details"></a><h2>Property Details</h2>
<a name="id2605766"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id2572591"></a><h3>
<a name="id2605777"></a><h3>
<a name="GimpDialog--help-func"></a>The "<code class="literal">help-func</code>" property</h3>
<a class="indexterm" name="id2572605"></a><pre class="programlisting"> "help-func" gpointer : Read / Write / Construct Only</pre>
<a class="indexterm" name="id2605791"></a><pre class="programlisting"> "help-func" gpointer : Read / Write / Construct Only</pre>
<p></p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2572625"></a><h3>
<a name="id2605811"></a><h3>
<a name="GimpDialog--help-id"></a>The "<code class="literal">help-id</code>" property</h3>
<a class="indexterm" name="id2572640"></a><pre class="programlisting"> "help-id" gchararray : Read / Write / Construct Only</pre>
<a class="indexterm" name="id2605826"></a><pre class="programlisting"> "help-id" gchararray : Read / Write / Construct Only</pre>
<p></p>
<p>Default value: NULL</p>
</div>