4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GimpDialog</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
<link rel="home" href="index.html" title="GIMP Widgets Library Reference Manual">
8
8
<link rel="up" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
9
9
<link rel="prev" href="GimpColorProfileComboBox.html" title="GimpColorProfileComboBox">
10
10
<link rel="next" href="GimpEnumStore.html" title="GimpEnumStore">
11
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
14
14
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
34
34
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
35
35
<td><a accesskey="n" href="GimpEnumStore.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
37
<tr><td colspan="5" class="shortcuts"><nobr><a href="#GimpDialog.synopsis" class="shortcut">Top</a>
39
<a href="#GimpDialog.description" class="shortcut">Description</a>
41
<a href="#GimpDialog.object-hierarchy" class="shortcut">Object Hierarchy</a>
43
<a href="#GimpDialog.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
45
<a href="#GimpDialog.properties" class="shortcut">Properties</a></nobr></td></tr>
37
<tr><td colspan="5" class="shortcuts">
38
<a href="#GimpDialog.synopsis" class="shortcut">Top</a>
40
<a href="#GimpDialog.description" class="shortcut">Description</a>
42
<a href="#GimpDialog.object-hierarchy" class="shortcut">Object Hierarchy</a>
44
<a href="#GimpDialog.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
46
<a href="#GimpDialog.properties" class="shortcut">Properties</a>
47
<div class="refentry" lang="en">
49
<div class="refentry" title="GimpDialog">
48
50
<a name="GimpDialog"></a><div class="titlepage"></div>
49
51
<div class="refnamediv"><table width="100%"><tr>
51
53
<h2><span class="refentrytitle"><a name="GimpDialog.top_of_page"></a>GimpDialog</span></h2>
52
54
<p>GimpDialog — Constructors for <a
53
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
55
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html"
54
56
><span class="type">GtkDialog</span></a>'s and action_areas as well as other
55
57
dialog-related stuff.</p>
57
59
<td valign="top" align="right"><img src="gimp-dialog.png"></td>
58
60
</tr></table></div>
59
<div class="refsynopsisdiv">
61
<div class="refsynopsisdiv" title="Synopsis">
60
62
<a name="GimpDialog.synopsis"></a><h2>Synopsis</h2>
61
63
<pre class="synopsis">
62
64
<a class="link" href="GimpDialog.html#GimpDialog-struct" title="GimpDialog">GimpDialog</a>;
64
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
65
>GtkWidget</a>* <a class="link" href="GimpDialog.html#gimp-dialog-new" title="gimp_dialog_new ()">gimp_dialog_new</a> (const <a
66
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
67
>GtkWidget</a> * <a class="link" href="GimpDialog.html#gimp-dialog-new" title="gimp_dialog_new ()">gimp_dialog_new</a> (const <a
66
68
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
69
71
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
72
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
74
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
73
75
>GtkWidget</a> *parent,
75
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#GtkDialogFlags"
77
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#GtkDialogFlags"
76
78
>GtkDialogFlags</a> flags,
77
79
<a class="link" href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc" title="GimpHelpFunc ()">GimpHelpFunc</a> help_func,
80
82
>gchar</a> *help_id,
83
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
84
>GtkWidget</a>* <a class="link" href="GimpDialog.html#gimp-dialog-new-valist" title="gimp_dialog_new_valist ()">gimp_dialog_new_valist</a> (const <a
85
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
86
>GtkWidget</a> * <a class="link" href="GimpDialog.html#gimp-dialog-new-valist" title="gimp_dialog_new_valist ()">gimp_dialog_new_valist</a> (const <a
85
87
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
88
90
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
91
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
93
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
92
94
>GtkWidget</a> *parent,
94
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#GtkDialogFlags"
96
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#GtkDialogFlags"
95
97
>GtkDialogFlags</a> flags,
96
98
<a class="link" href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc" title="GimpHelpFunc ()">GimpHelpFunc</a> help_func,
99
101
>gchar</a> *help_id,
102
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
103
>GtkWidget</a>* <a class="link" href="GimpDialog.html#gimp-dialog-add-button" title="gimp_dialog_add_button ()">gimp_dialog_add_button</a> (<a class="link" href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog,
104
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
105
>GtkWidget</a> * <a class="link" href="GimpDialog.html#gimp-dialog-add-button" title="gimp_dialog_add_button ()">gimp_dialog_add_button</a> (<a class="link" href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog,
105
107
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
106
108
>gchar</a> *button_text,
129
131
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
130
132
>GInitiallyUnowned</a>
132
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
134
href="http://library.gnome.org/devel/gtk/unstable/GtkObject.html"
135
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
137
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
138
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
140
href="http://library.gnome.org/devel/gtk/unstable/GtkContainer.html"
139
141
>GtkContainer</a>
141
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
143
href="http://library.gnome.org/devel/gtk/unstable/GtkBin.html"
144
href="/usr/share/gtk-doc/html/gtk/GtkWindow.html"
146
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"
147
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
149
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html"
152
<div class="refsect1" lang="en">
154
<div class="refsect1" title="Implemented Interfaces">
153
155
<a name="GimpDialog.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
155
157
GimpDialog implements
156
AtkImplementorIface and <a
157
href="/usr/share/gtk-doc/html/gtk/gtk-gtkbuildable.html#GtkBuildable"
158
>GtkBuildable</a>.</p>
159
href="http://library.gnome.org/devel/gtk/unstable/gtk-gtkbuildable.html#GtkBuildable"
160
>GtkBuildable</a> and AtkImplementorIface.</p>
160
<div class="refsect1" lang="en">
162
<div class="refsect1" title="Properties">
161
163
<a name="GimpDialog.properties"></a><h2>Properties</h2>
162
164
<pre class="synopsis">
163
165
"<a class="link" href="GimpDialog.html#GimpDialog--help-func" title='The "help-func" property'>help-func</a>" <a
168
170
>gchar</a>* : Read / Write / Construct Only
171
<div class="refsect1" lang="en">
173
<div class="refsect1" title="Description">
172
174
<a name="GimpDialog.description"></a><h2>Description</h2>
177
<div class="refsect1" lang="en">
178
<div class="refsect1" title="Details">
178
179
<a name="GimpDialog.details"></a><h2>Details</h2>
179
<div class="refsect2" lang="en">
180
<div class="refsect2" title="GimpDialog">
180
181
<a name="GimpDialog-struct"></a><h3>GimpDialog</h3>
181
182
<pre class="programlisting">typedef struct _GimpDialog GimpDialog;</pre>
187
<div class="refsect2" lang="en">
187
<div class="refsect2" title="gimp_dialog_new ()">
188
188
<a name="gimp-dialog-new"></a><h3>gimp_dialog_new ()</h3>
189
189
<pre class="programlisting"><a
190
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
191
>GtkWidget</a>* gimp_dialog_new (const <a
190
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
191
>GtkWidget</a> * gimp_dialog_new (const <a
192
192
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
193
193
>gchar</a> *title,
195
195
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
196
196
>gchar</a> *role,
198
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
198
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
199
199
>GtkWidget</a> *parent,
201
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#GtkDialogFlags"
201
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#GtkDialogFlags"
202
202
>GtkDialogFlags</a> flags,
203
203
<a class="link" href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc" title="GimpHelpFunc ()">GimpHelpFunc</a> help_func,
216
216
For a description of the format of the <em class="parameter"><code>va_list</code></em> describing the
217
217
action_area buttons see <a
218
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#gtk-dialog-new-with-buttons"
218
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#gtk-dialog-new-with-buttons"
219
219
><code class="function">gtk_dialog_new_with_buttons()</code></a>.</p>
223
222
<div class="variablelist"><table border="0">
224
223
<col align="left" valign="top">
235
234
<td><p><span class="term"><em class="parameter"><code>role</code></em> :</span></p></td>
236
235
<td> The dialog's <em class="parameter"><code>role</code></em> which will be set with
238
href="/usr/share/gtk-doc/html/gtk/GtkWindow.html#gtk-window-set-role"
237
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html#gtk-window-set-role"
239
238
><code class="function">gtk_window_set_role()</code></a>.
281
<div class="refsect2" lang="en">
280
<div class="refsect2" title="gimp_dialog_new_valist ()">
282
281
<a name="gimp-dialog-new-valist"></a><h3>gimp_dialog_new_valist ()</h3>
283
282
<pre class="programlisting"><a
284
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
285
>GtkWidget</a>* gimp_dialog_new_valist (const <a
283
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
284
>GtkWidget</a> * gimp_dialog_new_valist (const <a
286
285
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
287
286
>gchar</a> *title,
289
288
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
290
289
>gchar</a> *role,
292
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
291
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
293
292
>GtkWidget</a> *parent,
295
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#GtkDialogFlags"
294
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#GtkDialogFlags"
296
295
>GtkDialogFlags</a> flags,
297
296
<a class="link" href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc" title="GimpHelpFunc ()">GimpHelpFunc</a> help_func,
307
306
For a description of the format of the <em class="parameter"><code>va_list</code></em> describing the
308
307
action_area buttons see <a
309
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#gtk-dialog-new-with-buttons"
308
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#gtk-dialog-new-with-buttons"
310
309
><code class="function">gtk_dialog_new_with_buttons()</code></a>.</p>
314
312
<div class="variablelist"><table border="0">
315
313
<col align="left" valign="top">
326
324
<td><p><span class="term"><em class="parameter"><code>role</code></em> :</span></p></td>
327
325
<td> The dialog's <em class="parameter"><code>role</code></em> which will be set with
329
href="/usr/share/gtk-doc/html/gtk/GtkWindow.html#gtk-window-set-role"
327
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html#gtk-window-set-role"
330
328
><code class="function">gtk_window_set_role()</code></a>.
334
332
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
335
333
<td> The <em class="parameter"><code>parent</code></em> widget of this dialog or <a
336
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"
334
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
337
335
><code class="literal">NULL</code></a>.
341
339
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
342
340
<td> The <em class="parameter"><code>flags</code></em> (see the <a
343
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html"
341
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html"
344
342
><span class="type">GtkDialog</span></a> documentation).
371
<div class="refsect2" lang="en">
369
<div class="refsect2" title="gimp_dialog_add_button ()">
372
370
<a name="gimp-dialog-add-button"></a><h3>gimp_dialog_add_button ()</h3>
373
371
<pre class="programlisting"><a
374
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
375
>GtkWidget</a>* gimp_dialog_add_button (<a class="link" href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog,
372
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
373
>GtkWidget</a> * gimp_dialog_add_button (<a class="link" href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog,
377
375
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
378
376
>gchar</a> *button_text,
381
379
>gint</a> response_id);</pre>
383
381
This function is essentially the same as <a
384
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#gtk-dialog-add-button"
382
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#gtk-dialog-add-button"
385
383
><code class="function">gtk_dialog_add_button()</code></a>
386
384
except it ensures there is only one help button and automatically
387
385
sets the RESPONSE_OK widget as the default response.</p>
391
388
<div class="variablelist"><table border="0">
392
389
<col align="left" valign="top">
418
<div class="refsect2" lang="en">
415
<div class="refsect2" title="gimp_dialog_add_buttons ()">
419
416
<a name="gimp-dialog-add-buttons"></a><h3>gimp_dialog_add_buttons ()</h3>
420
417
<pre class="programlisting">void gimp_dialog_add_buttons (<a class="link" href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog,
423
420
This function is essentially the same as <a
424
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#gtk-dialog-add-buttons"
421
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#gtk-dialog-add-buttons"
425
422
><code class="function">gtk_dialog_add_buttons()</code></a>
426
423
except it calls <a class="link" href="GimpDialog.html#gimp-dialog-add-button" title="gimp_dialog_add_button ()"><code class="function">gimp_dialog_add_button()</code></a> instead of <a
427
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#gtk-dialog-add-button"
424
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#gtk-dialog-add-button"
428
425
><code class="function">gtk_dialog_add_button()</code></a></p>
432
428
<div class="variablelist"><table border="0">
433
429
<col align="left" valign="top">
476
<div class="refsect2" lang="en">
471
<div class="refsect2" title="gimp_dialog_run ()">
477
472
<a name="gimp-dialog-run"></a><h3>gimp_dialog_run ()</h3>
478
473
<pre class="programlisting"><a
479
474
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
480
475
>gint</a> gimp_dialog_run (<a class="link" href="GimpDialog.html" title="GimpDialog">GimpDialog</a> *dialog);</pre>
482
477
This function does exactly the same as <a
483
href="/usr/share/gtk-doc/html/gtk/GtkDialog.html#gtk-dialog-run"
478
href="http://library.gnome.org/devel/gtk/unstable/GtkDialog.html#gtk-dialog-run"
484
479
><code class="function">gtk_dialog_run()</code></a> except it
485
480
does not make the dialog modal while the <a
486
481
href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"
487
482
><span class="type">GMainLoop</span></a> is running.</p>
491
485
<div class="variablelist"><table border="0">
492
486
<col align="left" valign="top">
526
<p class="since">Since GIMP 2.2
530
<div class="refsect1" lang="en">
519
<p class="since">Since GIMP 2.2</p>
522
<div class="refsect1" title="Property Details">
531
523
<a name="GimpDialog.property-details"></a><h2>Property Details</h2>
532
<div class="refsect2" lang="en">
524
<div class="refsect2" title='The "help-func" property'>
533
525
<a name="GimpDialog--help-func"></a><h3>The <code class="literal">"help-func"</code> property</h3>
534
526
<pre class="programlisting"> "help-func" <a
535
527
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"