4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>GimpQueryBox</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
8
8
<link rel="up" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
9
9
<link rel="prev" href="libgimpwidgets-GimpHelpUI.html" title="GimpHelpUI">
10
<link rel="next" href="GimpSizeEntry.html" title="GimpSizeEntry">
11
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
10
<link rel="next" href="libgimpwidgets-GimpStock.html" title="GimpStock">
11
<meta name="generator" content="GTK-Doc V1.8 (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">
15
<link rel="chapter" href="libgimpwidgets-gallery.html" title="Widget Gallery">
15
16
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
16
17
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part II. GIMP Display Filters">
17
18
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part III. GIMP Color Selectors">
18
19
<link rel="part" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
19
20
<link rel="part" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
20
21
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
22
<link rel="index" href="libgimpwidgets-index.html" title="Index">
23
<link rel="index" href="libgimpwidgets-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
24
<link rel="index" href="libgimpwidgets-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
25
<link rel="index" href="libgimpwidgets-index-deprecated.html" title="Index of deprecated symbols">
22
27
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
23
28
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
26
31
<td><a accesskey="u" href="libgimpwidgets-utils.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
27
32
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
28
33
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
29
<td><a accesskey="n" href="GimpSizeEntry.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
34
<td><a accesskey="n" href="libgimpwidgets-GimpStock.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
36
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2601114" class="shortcut">Top</a>
33
<a href="#desc" class="shortcut">Description</a></nobr></td></tr>
38
<a href="#id2643841" class="shortcut">Description</a></nobr></td></tr>
35
40
<div class="refentry" lang="en">
36
41
<a name="libgimpwidgets-GimpQueryBox"></a><div class="titlepage"></div>
37
42
<div class="refnamediv"><table width="100%"><tr>
39
<h2><span class="refentrytitle"><a name="top_of_page"></a>GimpQueryBox</span></h2>
45
<a name="id2601114"></a><span class="refentrytitle">GimpQueryBox</span>
40
47
<p>GimpQueryBox — Some simple dialogs to enter a single int, double, string or boolean value.</p>
42
49
<td valign="top" align="right"></td>
43
50
</tr></table></div>
44
51
<div class="refsynopsisdiv">
45
<a name="synopsis"></a><h2>Synopsis</h2>
46
53
<pre class="synopsis">
50
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">*GimpQueryStringCallback</a>) (GtkWidget *query_box,
53
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">*GimpQueryIntCallback</a>) (GtkWidget *query_box,
56
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">*GimpQueryDoubleCallback</a>) (GtkWidget *query_box,
59
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">*GimpQuerySizeCallback</a>) (GtkWidget *query_box,
62
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
65
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">*GimpQueryBooleanCallback</a>) (GtkWidget *query_box,
68
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-string-box">gimp_query_string_box</a> (const gchar *title,
70
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
76
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">GimpQueryStringCallback</a> callback,
78
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-int-box">gimp_query_int_box</a> (const gchar *title,
80
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
88
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">GimpQueryIntCallback</a> callback,
90
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-double-box">gimp_query_double_box</a> (const gchar *title,
92
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
101
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">GimpQueryDoubleCallback</a> callback,
103
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-size-box">gimp_query_size_box</a> (const gchar *title,
105
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
106
const gchar *help_id,
107
const gchar *message,
113
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
116
gboolean dot_for_dot,
119
<a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">GimpQuerySizeCallback</a> callback,
121
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-boolean-box">gimp_query_boolean_box</a> (const gchar *title,
123
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
124
const gchar *help_id,
125
const gchar *stock_id,
126
const gchar *message,
127
const gchar *true_button,
128
const gchar *false_button,
131
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">GimpQueryBooleanCallback</a> callback,
133
#define <a href="libgimpwidgets-GimpQueryBox.html#GIMP-QUERY-BOX-VBOX:CAPS">GIMP_QUERY_BOX_VBOX</a> (qbox)
57
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">*GimpQueryStringCallback</a>) (GtkWidget *query_box,
60
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">*GimpQueryIntCallback</a>) (GtkWidget *query_box,
63
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">*GimpQueryDoubleCallback</a>) (GtkWidget *query_box,
66
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">*GimpQuerySizeCallback</a>) (GtkWidget *query_box,
69
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
72
void (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">*GimpQueryBooleanCallback</a>) (GtkWidget *query_box,
75
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-string-box">gimp_query_string_box</a> (const gchar *title,
77
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
83
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">GimpQueryStringCallback</a> callback,
85
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-int-box">gimp_query_int_box</a> (const gchar *title,
87
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
95
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">GimpQueryIntCallback</a> callback,
97
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-double-box">gimp_query_double_box</a> (const gchar *title,
99
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
100
const gchar *help_id,
101
const gchar *message,
108
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">GimpQueryDoubleCallback</a> callback,
110
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-size-box">gimp_query_size_box</a> (const gchar *title,
112
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
113
const gchar *help_id,
114
const gchar *message,
120
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
123
gboolean dot_for_dot,
126
<a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">GimpQuerySizeCallback</a> callback,
128
GtkWidget* <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-boolean-box">gimp_query_boolean_box</a> (const gchar *title,
130
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
131
const gchar *help_id,
132
const gchar *stock_id,
133
const gchar *message,
134
const gchar *true_button,
135
const gchar *false_button,
138
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">GimpQueryBooleanCallback</a> callback,
140
#define <a href="libgimpwidgets-GimpQueryBox.html#GIMP-QUERY-BOX-VBOX:CAPS">GIMP_QUERY_BOX_VBOX</a> (qbox)
136
143
<div class="refsect1" lang="en">
137
<a name="desc"></a><h2>Description</h2>
144
<a name="id2643841"></a><h2>Description</h2>
139
146
These functions provide simple dialogs for entering a single string,
140
147
integer, double, boolean or pixel size value.
363
354
<col align="left" valign="top">
367
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
357
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
368
358
<td> The query box dialog's title.
373
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
362
<td><span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
374
363
<td> The dialog's parent widget.
379
<span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
367
<td><span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
380
368
<td> The help function to show this dialog's help page.
385
<span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
372
<td><span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
386
373
<td> A string identifying this dialog's help page.
391
<span class="term"><em class="parameter"><code>message</code></em> :</span></td>
377
<td><span class="term"><em class="parameter"><code>message</code></em> :</span></td>
392
378
<td> A string which will be shown above the dialog's entry widget.
397
<span class="term"><em class="parameter"><code>initial</code></em> :</span></td>
382
<td><span class="term"><em class="parameter"><code>initial</code></em> :</span></td>
398
383
<td> The initial value.
403
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
387
<td><span class="term"><em class="parameter"><code>object</code></em> :</span></td>
404
388
<td> The object this query box is associated with.
409
<span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
392
<td><span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
410
393
<td> The object's signal which will cause the query box to be closed.
415
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
397
<td><span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
416
398
<td> The function which will be called when the user selects "OK".
421
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
402
<td><span class="term"><em class="parameter"><code>data</code></em> :</span></td>
422
403
<td> The callback's user data.
427
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
407
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
428
408
<td> A pointer to the new <span class="type">GtkDialog</span>.
456
436
<col align="left" valign="top">
460
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
439
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
461
440
<td> The query box dialog's title.
466
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
444
<td><span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
467
445
<td> The dialog's parent widget.
472
<span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
449
<td><span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
473
450
<td> The help function to show this dialog's help page.
478
<span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
454
<td><span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
479
455
<td> A string identifying this dialog's help page.
484
<span class="term"><em class="parameter"><code>message</code></em> :</span></td>
459
<td><span class="term"><em class="parameter"><code>message</code></em> :</span></td>
485
460
<td> A string which will be shown above the dialog's entry widget.
490
<span class="term"><em class="parameter"><code>initial</code></em> :</span></td>
464
<td><span class="term"><em class="parameter"><code>initial</code></em> :</span></td>
491
465
<td> The initial value.
496
<span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
469
<td><span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
497
470
<td> The lower boundary of the range of possible values.
502
<span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
474
<td><span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
503
475
<td> The upper boundray of the range of possible values.
508
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
479
<td><span class="term"><em class="parameter"><code>object</code></em> :</span></td>
509
480
<td> The object this query box is associated with.
514
<span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
484
<td><span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
515
485
<td> The object's signal which will cause the query box to be closed.
520
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
489
<td><span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
521
490
<td> The function which will be called when the user selects "OK".
526
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
494
<td><span class="term"><em class="parameter"><code>data</code></em> :</span></td>
527
495
<td> The callback's user data.
532
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
499
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
533
500
<td> A pointer to the new <span class="type">GtkDialog</span>.
562
529
<col align="left" valign="top">
566
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
532
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
567
533
<td> The query box dialog's title.
572
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
537
<td><span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
573
538
<td> The dialog's parent widget.
578
<span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
542
<td><span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
579
543
<td> The help function to show this dialog's help page.
584
<span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
547
<td><span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
585
548
<td> A string identifying this dialog's help page.
590
<span class="term"><em class="parameter"><code>message</code></em> :</span></td>
552
<td><span class="term"><em class="parameter"><code>message</code></em> :</span></td>
591
553
<td> A string which will be shown above the dialog's entry widget.
596
<span class="term"><em class="parameter"><code>initial</code></em> :</span></td>
557
<td><span class="term"><em class="parameter"><code>initial</code></em> :</span></td>
597
558
<td> The initial value.
602
<span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
562
<td><span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
603
563
<td> The lower boundary of the range of possible values.
608
<span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
567
<td><span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
609
568
<td> The upper boundray of the range of possible values.
614
<span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
572
<td><span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
615
573
<td> The number of decimal digits the <span class="type">GtkSpinButton</span> will provide.
620
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
577
<td><span class="term"><em class="parameter"><code>object</code></em> :</span></td>
621
578
<td> The object this query box is associated with.
626
<span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
582
<td><span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
627
583
<td> The object's signal which will cause the query box to be closed.
632
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
587
<td><span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
633
588
<td> The function which will be called when the user selects "OK".
638
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
592
<td><span class="term"><em class="parameter"><code>data</code></em> :</span></td>
639
593
<td> The callback's user data.
644
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
597
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
645
598
<td> A pointer to the new <span class="type">GtkDialog</span>.
680
633
<col align="left" valign="top">
684
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
636
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
685
637
<td> The query box dialog's title.
690
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
641
<td><span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
691
642
<td> The dialog's parent widget.
696
<span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
646
<td><span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
697
647
<td> The help function to show this dialog's help page.
702
<span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
651
<td><span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
703
652
<td> A string identifying this dialog's help page.
708
<span class="term"><em class="parameter"><code>message</code></em> :</span></td>
656
<td><span class="term"><em class="parameter"><code>message</code></em> :</span></td>
709
657
<td> A string which will be shown above the dialog's entry widget.
714
<span class="term"><em class="parameter"><code>initial</code></em> :</span></td>
661
<td><span class="term"><em class="parameter"><code>initial</code></em> :</span></td>
715
662
<td> The initial value.
720
<span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
666
<td><span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
721
667
<td> The lower boundary of the range of possible values.
726
<span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
671
<td><span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
727
672
<td> The upper boundray of the range of possible values.
732
<span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
676
<td><span class="term"><em class="parameter"><code>digits</code></em> :</span></td>
733
677
<td> The number of decimal digits the <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> provide in
739
<span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
682
<td><span class="term"><em class="parameter"><code>unit</code></em> :</span></td>
740
683
<td> The unit initially shown by the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a>.
745
<span class="term"><em class="parameter"><code>resolution</code></em> :</span></td>
687
<td><span class="term"><em class="parameter"><code>resolution</code></em> :</span></td>
746
688
<td> The resolution (in dpi) which will be used for pixel/unit
752
<span class="term"><em class="parameter"><code>dot_for_dot</code></em> :</span></td>
693
<td><span class="term"><em class="parameter"><code>dot_for_dot</code></em> :</span></td>
753
694
<td> <code class="literal">TRUE</code> if the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a>'s initial unit should be "pixels".
758
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
698
<td><span class="term"><em class="parameter"><code>object</code></em> :</span></td>
759
699
<td> The object this query box is associated with.
764
<span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
703
<td><span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
765
704
<td> The object's signal which will cause the query box
771
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
709
<td><span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
772
710
<td> The function which will be called when the user selects "OK".
777
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
714
<td><span class="term"><em class="parameter"><code>data</code></em> :</span></td>
778
715
<td> The callback's user data.
783
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
719
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
784
720
<td> A pointer to the new <span class="type">GtkDialog</span>.
791
727
<div class="refsect2" lang="en">
792
<a name="id2600819"></a><h3>
728
<a name="id2651192"></a><h3>
793
729
<a name="gimp-query-boolean-box"></a>gimp_query_boolean_box ()</h3>
794
<a class="indexterm" name="id2600830"></a><pre class="programlisting">GtkWidget* gimp_query_boolean_box (const gchar *title,
796
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
797
const gchar *help_id,
798
const gchar *stock_id,
799
const gchar *message,
800
const gchar *true_button,
801
const gchar *false_button,
804
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">GimpQueryBooleanCallback</a> callback,
805
gpointer data);</pre>
730
<a class="indexterm" name="id2651202"></a><pre class="programlisting">GtkWidget* gimp_query_boolean_box (const gchar *title,
732
<a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
733
const gchar *help_id,
734
const gchar *stock_id,
735
const gchar *message,
736
const gchar *true_button,
737
const gchar *false_button,
740
<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">GimpQueryBooleanCallback</a> callback,
741
gpointer data);</pre>
807
743
Creates a new <span class="type">GtkDialog</span> that asks the user to do a boolean decision.</p>
812
748
<col align="left" valign="top">
816
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
751
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
817
752
<td> The query box dialog's title.
822
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
756
<td><span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
823
757
<td> The dialog's parent widget.
828
<span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
761
<td><span class="term"><em class="parameter"><code>help_func</code></em> :</span></td>
829
762
<td> The help function to show this dialog's help page.
834
<span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
766
<td><span class="term"><em class="parameter"><code>help_id</code></em> :</span></td>
835
767
<td> A string identifying this dialog's help page.
840
<span class="term"><em class="parameter"><code>stock_id</code></em> :</span></td>
771
<td><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></td>
841
772
<td> A stock_id to specify an icon to appear on the left
842
773
on the dialog's message.
847
<span class="term"><em class="parameter"><code>message</code></em> :</span></td>
777
<td><span class="term"><em class="parameter"><code>message</code></em> :</span></td>
848
778
<td> A string which will be shown in the query box.
853
<span class="term"><em class="parameter"><code>true_button</code></em> :</span></td>
782
<td><span class="term"><em class="parameter"><code>true_button</code></em> :</span></td>
854
783
<td> The string to be shown in the dialog's left button.
859
<span class="term"><em class="parameter"><code>false_button</code></em> :</span></td>
787
<td><span class="term"><em class="parameter"><code>false_button</code></em> :</span></td>
860
788
<td> The string to be shown in the dialog's right button.
865
<span class="term"><em class="parameter"><code>object</code></em> :</span></td>
792
<td><span class="term"><em class="parameter"><code>object</code></em> :</span></td>
866
793
<td> The object this query box is associated with.
871
<span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
797
<td><span class="term"><em class="parameter"><code>signal</code></em> :</span></td>
872
798
<td> The object's signal which will cause the query box
878
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
803
<td><span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
879
804
<td> The function which will be called when the user clicks one
885
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
809
<td><span class="term"><em class="parameter"><code>data</code></em> :</span></td>
886
810
<td> The callback's user data.
891
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
814
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
892
815
<td> A pointer to the new <span class="type">GtkDialog</span>.