~ubuntu-branches/ubuntu/jaunty/gimp/jaunty-security

« back to all changes in this revision

Viewing changes to devel-docs/libgimpwidgets/html/libgimpwidgets-GimpQueryBox.html

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Holbach
  • Date: 2007-05-02 16:33:03 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20070502163303-bvzhjzbpw8qglc4y
Tags: 2.3.16-1ubuntu1
* Resynchronized with Debian, remaining Ubuntu changes:
  - debian/rules: i18n magic.
* debian/control.in:
  - Maintainer: Ubuntu Core Developers <ubuntu-devel@lists.ubuntu.com>
* debian/patches/02_help-message.patch,
  debian/patches/03_gimp.desktop.in.in.patch,
  debian/patches/10_dont_show_wizard.patch: updated.
* debian/patches/04_composite-signedness.patch,
  debian/patches/05_add-letter-spacing.patch: dropped, used upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
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&#160;V.&#160;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&#160;I.&#160;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&#160;II.&#160;GIMP Display Filters">
17
18
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part&#160;III.&#160;GIMP Color Selectors">
18
19
<link rel="part" href="libgimpwidgets-controller.html" title="Part&#160;IV.&#160;GIMP Controllers">
19
20
<link rel="part" href="libgimpwidgets-utils.html" title="Part&#160;V.&#160;GIMP Widgets Utilities">
20
21
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part&#160;VI.&#160;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">
21
26
</head>
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>
30
35
</tr>
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>
32
37
                  &#160;|&#160;
33
 
                  <a href="#desc" class="shortcut">Description</a></nobr></td></tr>
 
38
                  <a href="#id2643841" class="shortcut">Description</a></nobr></td></tr>
34
39
</table>
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>
38
43
<td valign="top">
39
 
<h2><span class="refentrytitle"><a name="top_of_page"></a>GimpQueryBox</span></h2>
 
44
<h2>
 
45
<a name="id2601114"></a><span class="refentrytitle">GimpQueryBox</span>
 
46
</h2>
40
47
<p>GimpQueryBox &#8212; Some simple dialogs to enter a single int, double, string or boolean value.</p>
41
48
</td>
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>
 
52
<h2>Synopsis</h2>
46
53
<pre class="synopsis">
47
54
 
48
55
 
49
56
 
50
 
void        (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">*GimpQueryStringCallback</a>)      (GtkWidget *query_box,
51
 
                                             const gchar *string,
52
 
                                             gpointer data);
53
 
void        (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">*GimpQueryIntCallback</a>)         (GtkWidget *query_box,
54
 
                                             gint value,
55
 
                                             gpointer data);
56
 
void        (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">*GimpQueryDoubleCallback</a>)      (GtkWidget *query_box,
57
 
                                             gdouble value,
58
 
                                             gpointer data);
59
 
void        (<a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">*GimpQuerySizeCallback</a>)        (GtkWidget *query_box,
60
 
                                             gdouble size,
61
 
                                             <a
62
 
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
63
 
>GimpUnit</a> unit,
64
 
                                             gpointer data);
65
 
void        (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">*GimpQueryBooleanCallback</a>)     (GtkWidget *query_box,
66
 
                                             gboolean value,
67
 
                                             gpointer data);
68
 
GtkWidget*  <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-string-box">gimp_query_string_box</a>           (const gchar *title,
69
 
                                             GtkWidget *parent,
70
 
                                             <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
71
 
                                             const gchar *help_id,
72
 
                                             const gchar *message,
73
 
                                             const gchar *initial,
74
 
                                             GObject *object,
75
 
                                             const gchar *signal,
76
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">GimpQueryStringCallback</a> callback,
77
 
                                             gpointer data);
78
 
GtkWidget*  <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-int-box">gimp_query_int_box</a>              (const gchar *title,
79
 
                                             GtkWidget *parent,
80
 
                                             <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
81
 
                                             const gchar *help_id,
82
 
                                             const gchar *message,
83
 
                                             gint initial,
84
 
                                             gint lower,
85
 
                                             gint upper,
86
 
                                             GObject *object,
87
 
                                             const gchar *signal,
88
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">GimpQueryIntCallback</a> callback,
89
 
                                             gpointer data);
90
 
GtkWidget*  <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-double-box">gimp_query_double_box</a>           (const gchar *title,
91
 
                                             GtkWidget *parent,
92
 
                                             <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
93
 
                                             const gchar *help_id,
94
 
                                             const gchar *message,
95
 
                                             gdouble initial,
96
 
                                             gdouble lower,
97
 
                                             gdouble upper,
98
 
                                             gint digits,
99
 
                                             GObject *object,
100
 
                                             const gchar *signal,
101
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">GimpQueryDoubleCallback</a> callback,
102
 
                                             gpointer data);
103
 
GtkWidget*  <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-size-box">gimp_query_size_box</a>             (const gchar *title,
104
 
                                             GtkWidget *parent,
105
 
                                             <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
106
 
                                             const gchar *help_id,
107
 
                                             const gchar *message,
108
 
                                             gdouble initial,
109
 
                                             gdouble lower,
110
 
                                             gdouble upper,
111
 
                                             gint digits,
112
 
                                             <a
113
 
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
114
 
>GimpUnit</a> unit,
115
 
                                             gdouble resolution,
116
 
                                             gboolean dot_for_dot,
117
 
                                             GObject *object,
118
 
                                             const gchar *signal,
119
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">GimpQuerySizeCallback</a> callback,
120
 
                                             gpointer data);
121
 
GtkWidget*  <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-boolean-box">gimp_query_boolean_box</a>          (const gchar *title,
122
 
                                             GtkWidget *parent,
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,
129
 
                                             GObject *object,
130
 
                                             const gchar *signal,
131
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">GimpQueryBooleanCallback</a> callback,
132
 
                                             gpointer data);
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,
 
58
                                                         const gchar *string,
 
59
                                                         gpointer data);
 
60
void                (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">*GimpQueryIntCallback</a>)             (GtkWidget *query_box,
 
61
                                                         gint value,
 
62
                                                         gpointer data);
 
63
void                (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">*GimpQueryDoubleCallback</a>)          (GtkWidget *query_box,
 
64
                                                         gdouble value,
 
65
                                                         gpointer data);
 
66
void                (<a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">*GimpQuerySizeCallback</a>)            (GtkWidget *query_box,
 
67
                                                         gdouble size,
 
68
                                                         <a
 
69
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
 
70
>GimpUnit</a> unit,
 
71
                                                         gpointer data);
 
72
void                (<a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">*GimpQueryBooleanCallback</a>)         (GtkWidget *query_box,
 
73
                                                         gboolean value,
 
74
                                                         gpointer data);
 
75
GtkWidget*          <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-string-box">gimp_query_string_box</a>               (const gchar *title,
 
76
                                                         GtkWidget *parent,
 
77
                                                         <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
 
78
                                                         const gchar *help_id,
 
79
                                                         const gchar *message,
 
80
                                                         const gchar *initial,
 
81
                                                         GObject *object,
 
82
                                                         const gchar *signal,
 
83
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">GimpQueryStringCallback</a> callback,
 
84
                                                         gpointer data);
 
85
GtkWidget*          <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-int-box">gimp_query_int_box</a>                  (const gchar *title,
 
86
                                                         GtkWidget *parent,
 
87
                                                         <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
 
88
                                                         const gchar *help_id,
 
89
                                                         const gchar *message,
 
90
                                                         gint initial,
 
91
                                                         gint lower,
 
92
                                                         gint upper,
 
93
                                                         GObject *object,
 
94
                                                         const gchar *signal,
 
95
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">GimpQueryIntCallback</a> callback,
 
96
                                                         gpointer data);
 
97
GtkWidget*          <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-double-box">gimp_query_double_box</a>               (const gchar *title,
 
98
                                                         GtkWidget *parent,
 
99
                                                         <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
 
100
                                                         const gchar *help_id,
 
101
                                                         const gchar *message,
 
102
                                                         gdouble initial,
 
103
                                                         gdouble lower,
 
104
                                                         gdouble upper,
 
105
                                                         gint digits,
 
106
                                                         GObject *object,
 
107
                                                         const gchar *signal,
 
108
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">GimpQueryDoubleCallback</a> callback,
 
109
                                                         gpointer data);
 
110
GtkWidget*          <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-size-box">gimp_query_size_box</a>                 (const gchar *title,
 
111
                                                         GtkWidget *parent,
 
112
                                                         <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
 
113
                                                         const gchar *help_id,
 
114
                                                         const gchar *message,
 
115
                                                         gdouble initial,
 
116
                                                         gdouble lower,
 
117
                                                         gdouble upper,
 
118
                                                         gint digits,
 
119
                                                         <a
 
120
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
 
121
>GimpUnit</a> unit,
 
122
                                                         gdouble resolution,
 
123
                                                         gboolean dot_for_dot,
 
124
                                                         GObject *object,
 
125
                                                         const gchar *signal,
 
126
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">GimpQuerySizeCallback</a> callback,
 
127
                                                         gpointer data);
 
128
GtkWidget*          <a href="libgimpwidgets-GimpQueryBox.html#gimp-query-boolean-box">gimp_query_boolean_box</a>              (const gchar *title,
 
129
                                                         GtkWidget *parent,
 
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,
 
136
                                                         GObject *object,
 
137
                                                         const gchar *signal,
 
138
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">GimpQueryBooleanCallback</a> callback,
 
139
                                                         gpointer data);
 
140
#define             <a href="libgimpwidgets-GimpQueryBox.html#GIMP-QUERY-BOX-VBOX:CAPS">GIMP_QUERY_BOX_VBOX</a>                 (qbox)
134
141
</pre>
135
142
</div>
136
143
<div class="refsect1" lang="en">
137
 
<a name="desc"></a><h2>Description</h2>
 
144
<a name="id2643841"></a><h2>Description</h2>
138
145
<p>
139
146
These functions provide simple dialogs for entering a single string,
140
147
integer, double, boolean or pixel size value.
151
158
</p>
152
159
</div>
153
160
<div class="refsect1" lang="en">
154
 
<a name="details"></a><h2>Details</h2>
 
161
<a name="id2643887"></a><h2>Details</h2>
155
162
<div class="refsect2" lang="en">
156
 
<a name="id2594443"></a><h3>
 
163
<a name="id2643897"></a><h3>
157
164
<a name="GimpQueryStringCallback"></a>GimpQueryStringCallback ()</h3>
158
 
<a class="indexterm" name="id2594454"></a><pre class="programlisting">void        (*GimpQueryStringCallback)      (GtkWidget *query_box,
159
 
                                             const gchar *string,
160
 
                                             gpointer data);</pre>
 
165
<a class="indexterm" name="id2643909"></a><pre class="programlisting">void                (*GimpQueryStringCallback)          (GtkWidget *query_box,
 
166
                                                         const gchar *string,
 
167
                                                         gpointer data);</pre>
161
168
<p>
162
169
Note that you have to <code class="function">g_free()</code> the returned string.
163
170
</p>
165
172
<col align="left" valign="top">
166
173
<tbody>
167
174
<tr>
168
 
<td>
169
 
<span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
 
175
<td><span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
170
176
<td>The query box.
171
177
</td>
172
178
</tr>
173
179
<tr>
174
 
<td>
175
 
<span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
 
180
<td><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
176
181
<td>The entered string.
177
182
</td>
178
183
</tr>
179
184
<tr>
180
 
<td>
181
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
185
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
182
186
<td>The user data.
183
187
 
184
188
 
189
193
</div>
190
194
<hr>
191
195
<div class="refsect2" lang="en">
192
 
<a name="id2594549"></a><h3>
 
196
<a name="id2644006"></a><h3>
193
197
<a name="GimpQueryIntCallback"></a>GimpQueryIntCallback ()</h3>
194
 
<a class="indexterm" name="id2594560"></a><pre class="programlisting">void        (*GimpQueryIntCallback)         (GtkWidget *query_box,
195
 
                                             gint value,
196
 
                                             gpointer data);</pre>
 
198
<a class="indexterm" name="id2644017"></a><pre class="programlisting">void                (*GimpQueryIntCallback)             (GtkWidget *query_box,
 
199
                                                         gint value,
 
200
                                                         gpointer data);</pre>
197
201
<p>
198
202
 
199
203
</p>
201
205
<col align="left" valign="top">
202
206
<tbody>
203
207
<tr>
204
 
<td>
205
 
<span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
 
208
<td><span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
206
209
<td>The query box.
207
210
</td>
208
211
</tr>
209
212
<tr>
210
 
<td>
211
 
<span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
213
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
212
214
<td>The entered integer value.
213
215
</td>
214
216
</tr>
215
217
<tr>
216
 
<td>
217
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
218
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
218
219
<td>The user data.
219
220
 
220
221
 
225
226
</div>
226
227
<hr>
227
228
<div class="refsect2" lang="en">
228
 
<a name="id2599096"></a><h3>
 
229
<a name="id2649580"></a><h3>
229
230
<a name="GimpQueryDoubleCallback"></a>GimpQueryDoubleCallback ()</h3>
230
 
<a class="indexterm" name="id2599106"></a><pre class="programlisting">void        (*GimpQueryDoubleCallback)      (GtkWidget *query_box,
231
 
                                             gdouble value,
232
 
                                             gpointer data);</pre>
 
231
<a class="indexterm" name="id2649590"></a><pre class="programlisting">void                (*GimpQueryDoubleCallback)          (GtkWidget *query_box,
 
232
                                                         gdouble value,
 
233
                                                         gpointer data);</pre>
233
234
<p>
234
235
 
235
236
</p>
237
238
<col align="left" valign="top">
238
239
<tbody>
239
240
<tr>
240
 
<td>
241
 
<span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
 
241
<td><span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
242
242
<td>The query box.
243
243
</td>
244
244
</tr>
245
245
<tr>
246
 
<td>
247
 
<span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
246
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
248
247
<td>The entered double value.
249
248
</td>
250
249
</tr>
251
250
<tr>
252
 
<td>
253
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
251
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
254
252
<td>The user data.
255
253
 
256
254
 
261
259
</div>
262
260
<hr>
263
261
<div class="refsect2" lang="en">
264
 
<a name="id2599184"></a><h3>
 
262
<a name="id2649669"></a><h3>
265
263
<a name="GimpQuerySizeCallback"></a>GimpQuerySizeCallback ()</h3>
266
 
<a class="indexterm" name="id2599194"></a><pre class="programlisting">void        (*GimpQuerySizeCallback)        (GtkWidget *query_box,
267
 
                                             gdouble size,
268
 
                                             <a
 
264
<a class="indexterm" name="id2649679"></a><pre class="programlisting">void                (*GimpQuerySizeCallback)            (GtkWidget *query_box,
 
265
                                                         gdouble size,
 
266
                                                         <a
269
267
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
270
268
>GimpUnit</a> unit,
271
 
                                             gpointer data);</pre>
 
269
                                                         gpointer data);</pre>
272
270
<p>
273
271
 
274
272
</p>
276
274
<col align="left" valign="top">
277
275
<tbody>
278
276
<tr>
279
 
<td>
280
 
<span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
 
277
<td><span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
281
278
<td>The query box.
282
279
</td>
283
280
</tr>
284
281
<tr>
285
 
<td>
286
 
<span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
 
282
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
287
283
<td>The entered size in pixels.
288
284
</td>
289
285
</tr>
290
286
<tr>
291
 
<td>
292
 
<span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
 
287
<td><span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
293
288
<td>The selected unit from the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a>.
294
289
</td>
295
290
</tr>
296
291
<tr>
297
 
<td>
298
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
292
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
299
293
<td>The user data.
300
294
 
301
295
 
306
300
</div>
307
301
<hr>
308
302
<div class="refsect2" lang="en">
309
 
<a name="id2599307"></a><h3>
 
303
<a name="id2649793"></a><h3>
310
304
<a name="GimpQueryBooleanCallback"></a>GimpQueryBooleanCallback ()</h3>
311
 
<a class="indexterm" name="id2599318"></a><pre class="programlisting">void        (*GimpQueryBooleanCallback)     (GtkWidget *query_box,
312
 
                                             gboolean value,
313
 
                                             gpointer data);</pre>
 
305
<a class="indexterm" name="id2649804"></a><pre class="programlisting">void                (*GimpQueryBooleanCallback)         (GtkWidget *query_box,
 
306
                                                         gboolean value,
 
307
                                                         gpointer data);</pre>
314
308
<p>
315
309
 
316
310
</p>
318
312
<col align="left" valign="top">
319
313
<tbody>
320
314
<tr>
321
 
<td>
322
 
<span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
 
315
<td><span class="term"><em class="parameter"><code>query_box</code></em>&#160;:</span></td>
323
316
<td>The query box.
324
317
</td>
325
318
</tr>
326
319
<tr>
327
 
<td>
328
 
<span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
320
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
329
321
<td>The entered boolean value.
330
322
</td>
331
323
</tr>
332
324
<tr>
333
 
<td>
334
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
325
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
335
326
<td>The user data.
336
327
 
337
328
 
342
333
</div>
343
334
<hr>
344
335
<div class="refsect2" lang="en">
345
 
<a name="id2599406"></a><h3>
 
336
<a name="id2649892"></a><h3>
346
337
<a name="gimp-query-string-box"></a>gimp_query_string_box ()</h3>
347
 
<a class="indexterm" name="id2599417"></a><pre class="programlisting">GtkWidget*  gimp_query_string_box           (const gchar *title,
348
 
                                             GtkWidget *parent,
349
 
                                             <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
350
 
                                             const gchar *help_id,
351
 
                                             const gchar *message,
352
 
                                             const gchar *initial,
353
 
                                             GObject *object,
354
 
                                             const gchar *signal,
355
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">GimpQueryStringCallback</a> callback,
356
 
                                             gpointer data);</pre>
 
338
<a class="indexterm" name="id2649904"></a><pre class="programlisting">GtkWidget*          gimp_query_string_box               (const gchar *title,
 
339
                                                         GtkWidget *parent,
 
340
                                                         <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
 
341
                                                         const gchar *help_id,
 
342
                                                         const gchar *message,
 
343
                                                         const gchar *initial,
 
344
                                                         GObject *object,
 
345
                                                         const gchar *signal,
 
346
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryStringCallback">GimpQueryStringCallback</a> callback,
 
347
                                                         gpointer data);</pre>
357
348
<p>
358
349
Creates a new <span class="type">GtkDialog</span> that queries the user for a string value.</p>
359
350
<p>
363
354
<col align="left" valign="top">
364
355
<tbody>
365
356
<tr>
366
 
<td>
367
 
<span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
 
357
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
368
358
<td>     The query box dialog's title.
369
359
</td>
370
360
</tr>
371
361
<tr>
372
 
<td>
373
 
<span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
 
362
<td><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
374
363
<td>    The dialog's parent widget.
375
364
</td>
376
365
</tr>
377
366
<tr>
378
 
<td>
379
 
<span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
 
367
<td><span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
380
368
<td> The help function to show this dialog's help page.
381
369
</td>
382
370
</tr>
383
371
<tr>
384
 
<td>
385
 
<span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
 
372
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
386
373
<td>   A string identifying this dialog's help page.
387
374
</td>
388
375
</tr>
389
376
<tr>
390
 
<td>
391
 
<span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
 
377
<td><span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
392
378
<td>   A string which will be shown above the dialog's entry widget.
393
379
</td>
394
380
</tr>
395
381
<tr>
396
 
<td>
397
 
<span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
 
382
<td><span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
398
383
<td>   The initial value.
399
384
</td>
400
385
</tr>
401
386
<tr>
402
 
<td>
403
 
<span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
 
387
<td><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
404
388
<td>    The object this query box is associated with.
405
389
</td>
406
390
</tr>
407
391
<tr>
408
 
<td>
409
 
<span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
 
392
<td><span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
410
393
<td>    The object's signal which will cause the query box to be closed.
411
394
</td>
412
395
</tr>
413
396
<tr>
414
 
<td>
415
 
<span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
397
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
416
398
<td>  The function which will be called when the user selects "OK".
417
399
</td>
418
400
</tr>
419
401
<tr>
420
 
<td>
421
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
402
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
422
403
<td>      The callback's user data.
423
404
</td>
424
405
</tr>
425
406
<tr>
426
 
<td>
427
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
407
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
428
408
<td> A pointer to the new <span class="type">GtkDialog</span>.
429
409
</td>
430
410
</tr>
433
413
</div>
434
414
<hr>
435
415
<div class="refsect2" lang="en">
436
 
<a name="id2599686"></a><h3>
 
416
<a name="id2650173"></a><h3>
437
417
<a name="gimp-query-int-box"></a>gimp_query_int_box ()</h3>
438
 
<a class="indexterm" name="id2599698"></a><pre class="programlisting">GtkWidget*  gimp_query_int_box              (const gchar *title,
439
 
                                             GtkWidget *parent,
440
 
                                             <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
441
 
                                             const gchar *help_id,
442
 
                                             const gchar *message,
443
 
                                             gint initial,
444
 
                                             gint lower,
445
 
                                             gint upper,
446
 
                                             GObject *object,
447
 
                                             const gchar *signal,
448
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">GimpQueryIntCallback</a> callback,
449
 
                                             gpointer data);</pre>
 
418
<a class="indexterm" name="id2575188"></a><pre class="programlisting">GtkWidget*          gimp_query_int_box                  (const gchar *title,
 
419
                                                         GtkWidget *parent,
 
420
                                                         <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
 
421
                                                         const gchar *help_id,
 
422
                                                         const gchar *message,
 
423
                                                         gint initial,
 
424
                                                         gint lower,
 
425
                                                         gint upper,
 
426
                                                         GObject *object,
 
427
                                                         const gchar *signal,
 
428
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryIntCallback">GimpQueryIntCallback</a> callback,
 
429
                                                         gpointer data);</pre>
450
430
<p>
451
431
Creates a new <span class="type">GtkDialog</span> that queries the user for an integer value.</p>
452
432
<p>
456
436
<col align="left" valign="top">
457
437
<tbody>
458
438
<tr>
459
 
<td>
460
 
<span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
 
439
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
461
440
<td>     The query box dialog's title.
462
441
</td>
463
442
</tr>
464
443
<tr>
465
 
<td>
466
 
<span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
 
444
<td><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
467
445
<td>    The dialog's parent widget.
468
446
</td>
469
447
</tr>
470
448
<tr>
471
 
<td>
472
 
<span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
 
449
<td><span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
473
450
<td> The help function to show this dialog's help page.
474
451
</td>
475
452
</tr>
476
453
<tr>
477
 
<td>
478
 
<span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
 
454
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
479
455
<td>   A string identifying this dialog's help page.
480
456
</td>
481
457
</tr>
482
458
<tr>
483
 
<td>
484
 
<span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
 
459
<td><span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
485
460
<td>   A string which will be shown above the dialog's entry widget.
486
461
</td>
487
462
</tr>
488
463
<tr>
489
 
<td>
490
 
<span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
 
464
<td><span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
491
465
<td>   The initial value.
492
466
</td>
493
467
</tr>
494
468
<tr>
495
 
<td>
496
 
<span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
 
469
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
497
470
<td>     The lower boundary of the range of possible values.
498
471
</td>
499
472
</tr>
500
473
<tr>
501
 
<td>
502
 
<span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
 
474
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
503
475
<td>     The upper boundray of the range of possible values.
504
476
</td>
505
477
</tr>
506
478
<tr>
507
 
<td>
508
 
<span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
 
479
<td><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
509
480
<td>    The object this query box is associated with.
510
481
</td>
511
482
</tr>
512
483
<tr>
513
 
<td>
514
 
<span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
 
484
<td><span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
515
485
<td>    The object's signal which will cause the query box to be closed.
516
486
</td>
517
487
</tr>
518
488
<tr>
519
 
<td>
520
 
<span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
489
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
521
490
<td>  The function which will be called when the user selects "OK".
522
491
</td>
523
492
</tr>
524
493
<tr>
525
 
<td>
526
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
494
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
527
495
<td>      The callback's user data.
528
496
</td>
529
497
</tr>
530
498
<tr>
531
 
<td>
532
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
499
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
533
500
<td> A pointer to the new <span class="type">GtkDialog</span>.
534
501
</td>
535
502
</tr>
538
505
</div>
539
506
<hr>
540
507
<div class="refsect2" lang="en">
541
 
<a name="id2600012"></a><h3>
 
508
<a name="id2650455"></a><h3>
542
509
<a name="gimp-query-double-box"></a>gimp_query_double_box ()</h3>
543
 
<a class="indexterm" name="id2600023"></a><pre class="programlisting">GtkWidget*  gimp_query_double_box           (const gchar *title,
544
 
                                             GtkWidget *parent,
545
 
                                             <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
546
 
                                             const gchar *help_id,
547
 
                                             const gchar *message,
548
 
                                             gdouble initial,
549
 
                                             gdouble lower,
550
 
                                             gdouble upper,
551
 
                                             gint digits,
552
 
                                             GObject *object,
553
 
                                             const gchar *signal,
554
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">GimpQueryDoubleCallback</a> callback,
555
 
                                             gpointer data);</pre>
 
510
<a class="indexterm" name="id2650465"></a><pre class="programlisting">GtkWidget*          gimp_query_double_box               (const gchar *title,
 
511
                                                         GtkWidget *parent,
 
512
                                                         <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
 
513
                                                         const gchar *help_id,
 
514
                                                         const gchar *message,
 
515
                                                         gdouble initial,
 
516
                                                         gdouble lower,
 
517
                                                         gdouble upper,
 
518
                                                         gint digits,
 
519
                                                         GObject *object,
 
520
                                                         const gchar *signal,
 
521
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryDoubleCallback">GimpQueryDoubleCallback</a> callback,
 
522
                                                         gpointer data);</pre>
556
523
<p>
557
524
Creates a new <span class="type">GtkDialog</span> that queries the user for a double value.</p>
558
525
<p>
562
529
<col align="left" valign="top">
563
530
<tbody>
564
531
<tr>
565
 
<td>
566
 
<span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
 
532
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
567
533
<td>     The query box dialog's title.
568
534
</td>
569
535
</tr>
570
536
<tr>
571
 
<td>
572
 
<span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
 
537
<td><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
573
538
<td>    The dialog's parent widget.
574
539
</td>
575
540
</tr>
576
541
<tr>
577
 
<td>
578
 
<span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
 
542
<td><span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
579
543
<td> The help function to show this dialog's help page.
580
544
</td>
581
545
</tr>
582
546
<tr>
583
 
<td>
584
 
<span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
 
547
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
585
548
<td>   A string identifying this dialog's help page.
586
549
</td>
587
550
</tr>
588
551
<tr>
589
 
<td>
590
 
<span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
 
552
<td><span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
591
553
<td>   A string which will be shown above the dialog's entry widget.
592
554
</td>
593
555
</tr>
594
556
<tr>
595
 
<td>
596
 
<span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
 
557
<td><span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
597
558
<td>   The initial value.
598
559
</td>
599
560
</tr>
600
561
<tr>
601
 
<td>
602
 
<span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
 
562
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
603
563
<td>     The lower boundary of the range of possible values.
604
564
</td>
605
565
</tr>
606
566
<tr>
607
 
<td>
608
 
<span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
 
567
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
609
568
<td>     The upper boundray of the range of possible values.
610
569
</td>
611
570
</tr>
612
571
<tr>
613
 
<td>
614
 
<span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
 
572
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
615
573
<td>    The number of decimal digits the <span class="type">GtkSpinButton</span> will provide.
616
574
</td>
617
575
</tr>
618
576
<tr>
619
 
<td>
620
 
<span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
 
577
<td><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
621
578
<td>    The object this query box is associated with.
622
579
</td>
623
580
</tr>
624
581
<tr>
625
 
<td>
626
 
<span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
 
582
<td><span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
627
583
<td>    The object's signal which will cause the query box to be closed.
628
584
</td>
629
585
</tr>
630
586
<tr>
631
 
<td>
632
 
<span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
587
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
633
588
<td>  The function which will be called when the user selects "OK".
634
589
</td>
635
590
</tr>
636
591
<tr>
637
 
<td>
638
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
592
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
639
593
<td>      The callback's user data.
640
594
</td>
641
595
</tr>
642
596
<tr>
643
 
<td>
644
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
597
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
645
598
<td> A pointer to the new <span class="type">GtkDialog</span>.
646
599
</td>
647
600
</tr>
650
603
</div>
651
604
<hr>
652
605
<div class="refsect2" lang="en">
653
 
<a name="id2600366"></a><h3>
 
606
<a name="id2650778"></a><h3>
654
607
<a name="gimp-query-size-box"></a>gimp_query_size_box ()</h3>
655
 
<a class="indexterm" name="id2600378"></a><pre class="programlisting">GtkWidget*  gimp_query_size_box             (const gchar *title,
656
 
                                             GtkWidget *parent,
657
 
                                             <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
658
 
                                             const gchar *help_id,
659
 
                                             const gchar *message,
660
 
                                             gdouble initial,
661
 
                                             gdouble lower,
662
 
                                             gdouble upper,
663
 
                                             gint digits,
664
 
                                             <a
 
608
<a class="indexterm" name="id2650788"></a><pre class="programlisting">GtkWidget*          gimp_query_size_box                 (const gchar *title,
 
609
                                                         GtkWidget *parent,
 
610
                                                         <a href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc">GimpHelpFunc</a> help_func,
 
611
                                                         const gchar *help_id,
 
612
                                                         const gchar *message,
 
613
                                                         gdouble initial,
 
614
                                                         gdouble lower,
 
615
                                                         gdouble upper,
 
616
                                                         gint digits,
 
617
                                                         <a
665
618
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
666
619
>GimpUnit</a> unit,
667
 
                                             gdouble resolution,
668
 
                                             gboolean dot_for_dot,
669
 
                                             GObject *object,
670
 
                                             const gchar *signal,
671
 
                                             <a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">GimpQuerySizeCallback</a> callback,
672
 
                                             gpointer data);</pre>
 
620
                                                         gdouble resolution,
 
621
                                                         gboolean dot_for_dot,
 
622
                                                         GObject *object,
 
623
                                                         const gchar *signal,
 
624
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQuerySizeCallback">GimpQuerySizeCallback</a> callback,
 
625
                                                         gpointer data);</pre>
673
626
<p>
674
627
Creates a new <span class="type">GtkDialog</span> that queries the user for a size using a
675
628
<a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a>.</p>
680
633
<col align="left" valign="top">
681
634
<tbody>
682
635
<tr>
683
 
<td>
684
 
<span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
 
636
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
685
637
<td>       The query box dialog's title.
686
638
</td>
687
639
</tr>
688
640
<tr>
689
 
<td>
690
 
<span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
 
641
<td><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
691
642
<td>      The dialog's parent widget.
692
643
</td>
693
644
</tr>
694
645
<tr>
695
 
<td>
696
 
<span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
 
646
<td><span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
697
647
<td>   The help function to show this dialog's help page.
698
648
</td>
699
649
</tr>
700
650
<tr>
701
 
<td>
702
 
<span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
 
651
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
703
652
<td>     A string identifying this dialog's help page.
704
653
</td>
705
654
</tr>
706
655
<tr>
707
 
<td>
708
 
<span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
 
656
<td><span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
709
657
<td>     A string which will be shown above the dialog's entry widget.
710
658
</td>
711
659
</tr>
712
660
<tr>
713
 
<td>
714
 
<span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
 
661
<td><span class="term"><em class="parameter"><code>initial</code></em>&#160;:</span></td>
715
662
<td>     The initial value.
716
663
</td>
717
664
</tr>
718
665
<tr>
719
 
<td>
720
 
<span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
 
666
<td><span class="term"><em class="parameter"><code>lower</code></em>&#160;:</span></td>
721
667
<td>       The lower boundary of the range of possible values.
722
668
</td>
723
669
</tr>
724
670
<tr>
725
 
<td>
726
 
<span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
 
671
<td><span class="term"><em class="parameter"><code>upper</code></em>&#160;:</span></td>
727
672
<td>       The upper boundray of the range of possible values.
728
673
</td>
729
674
</tr>
730
675
<tr>
731
 
<td>
732
 
<span class="term"><em class="parameter"><code>digits</code></em>&#160;:</span></td>
 
676
<td><span class="term"><em class="parameter"><code>digits</code></em>&#160;:</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
734
678
              "pixel" mode.
735
679
</td>
736
680
</tr>
737
681
<tr>
738
 
<td>
739
 
<span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
 
682
<td><span class="term"><em class="parameter"><code>unit</code></em>&#160;:</span></td>
740
683
<td>        The unit initially shown by the <a href="GimpUnitMenu.html" title="GimpUnitMenu"><span class="type">GimpUnitMenu</span></a>.
741
684
</td>
742
685
</tr>
743
686
<tr>
744
 
<td>
745
 
<span class="term"><em class="parameter"><code>resolution</code></em>&#160;:</span></td>
 
687
<td><span class="term"><em class="parameter"><code>resolution</code></em>&#160;:</span></td>
746
688
<td>  The resolution (in dpi) which will be used for pixel/unit
747
689
              calculations.
748
690
</td>
749
691
</tr>
750
692
<tr>
751
 
<td>
752
 
<span class="term"><em class="parameter"><code>dot_for_dot</code></em>&#160;:</span></td>
 
693
<td><span class="term"><em class="parameter"><code>dot_for_dot</code></em>&#160;:</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".
754
695
</td>
755
696
</tr>
756
697
<tr>
757
 
<td>
758
 
<span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
 
698
<td><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
759
699
<td>      The object this query box is associated with.
760
700
</td>
761
701
</tr>
762
702
<tr>
763
 
<td>
764
 
<span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
 
703
<td><span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
765
704
<td>      The object's signal which will cause the query box
766
705
              to be closed.
767
706
</td>
768
707
</tr>
769
708
<tr>
770
 
<td>
771
 
<span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
709
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
772
710
<td>    The function which will be called when the user selects "OK".
773
711
</td>
774
712
</tr>
775
713
<tr>
776
 
<td>
777
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
714
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
778
715
<td>        The callback's user data.
779
716
</td>
780
717
</tr>
781
718
<tr>
782
 
<td>
783
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
719
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
784
720
<td> A pointer to the new <span class="type">GtkDialog</span>.
785
721
</td>
786
722
</tr>
789
725
</div>
790
726
<hr>
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,
795
 
                                             GtkWidget *parent,
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,
802
 
                                             GObject *object,
803
 
                                             const gchar *signal,
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,
 
731
                                                         GtkWidget *parent,
 
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,
 
738
                                                         GObject *object,
 
739
                                                         const gchar *signal,
 
740
                                                         <a href="libgimpwidgets-GimpQueryBox.html#GimpQueryBooleanCallback">GimpQueryBooleanCallback</a> callback,
 
741
                                                         gpointer data);</pre>
806
742
<p>
807
743
Creates a new <span class="type">GtkDialog</span> that asks the user to do a boolean decision.</p>
808
744
<p>
812
748
<col align="left" valign="top">
813
749
<tbody>
814
750
<tr>
815
 
<td>
816
 
<span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
 
751
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
817
752
<td>        The query box dialog's title.
818
753
</td>
819
754
</tr>
820
755
<tr>
821
 
<td>
822
 
<span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
 
756
<td><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></td>
823
757
<td>       The dialog's parent widget.
824
758
</td>
825
759
</tr>
826
760
<tr>
827
 
<td>
828
 
<span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
 
761
<td><span class="term"><em class="parameter"><code>help_func</code></em>&#160;:</span></td>
829
762
<td>    The help function to show this dialog's help page.
830
763
</td>
831
764
</tr>
832
765
<tr>
833
 
<td>
834
 
<span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
 
766
<td><span class="term"><em class="parameter"><code>help_id</code></em>&#160;:</span></td>
835
767
<td>      A string identifying this dialog's help page.
836
768
</td>
837
769
</tr>
838
770
<tr>
839
 
<td>
840
 
<span class="term"><em class="parameter"><code>stock_id</code></em>&#160;:</span></td>
 
771
<td><span class="term"><em class="parameter"><code>stock_id</code></em>&#160;:</span></td>
841
772
<td>     A stock_id to specify an icon to appear on the left
842
773
               on the dialog's message.
843
774
</td>
844
775
</tr>
845
776
<tr>
846
 
<td>
847
 
<span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
 
777
<td><span class="term"><em class="parameter"><code>message</code></em>&#160;:</span></td>
848
778
<td>      A string which will be shown in the query box.
849
779
</td>
850
780
</tr>
851
781
<tr>
852
 
<td>
853
 
<span class="term"><em class="parameter"><code>true_button</code></em>&#160;:</span></td>
 
782
<td><span class="term"><em class="parameter"><code>true_button</code></em>&#160;:</span></td>
854
783
<td>  The string to be shown in the dialog's left button.
855
784
</td>
856
785
</tr>
857
786
<tr>
858
 
<td>
859
 
<span class="term"><em class="parameter"><code>false_button</code></em>&#160;:</span></td>
 
787
<td><span class="term"><em class="parameter"><code>false_button</code></em>&#160;:</span></td>
860
788
<td> The string to be shown in the dialog's right button.
861
789
</td>
862
790
</tr>
863
791
<tr>
864
 
<td>
865
 
<span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
 
792
<td><span class="term"><em class="parameter"><code>object</code></em>&#160;:</span></td>
866
793
<td>       The object this query box is associated with.
867
794
</td>
868
795
</tr>
869
796
<tr>
870
 
<td>
871
 
<span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
 
797
<td><span class="term"><em class="parameter"><code>signal</code></em>&#160;:</span></td>
872
798
<td>       The object's signal which will cause the query box
873
799
               to be closed.
874
800
</td>
875
801
</tr>
876
802
<tr>
877
 
<td>
878
 
<span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
803
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
879
804
<td>     The function which will be called when the user clicks one
880
805
               of the buttons.
881
806
</td>
882
807
</tr>
883
808
<tr>
884
 
<td>
885
 
<span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
809
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
886
810
<td>         The callback's user data.
887
811
</td>
888
812
</tr>
889
813
<tr>
890
 
<td>
891
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
814
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
892
815
<td> A pointer to the new <span class="type">GtkDialog</span>.
893
816
</td>
894
817
</tr>
897
820
</div>
898
821
<hr>
899
822
<div class="refsect2" lang="en">
900
 
<a name="id2601116"></a><h3>
 
823
<a name="id2651494"></a><h3>
901
824
<a name="GIMP-QUERY-BOX-VBOX:CAPS"></a>GIMP_QUERY_BOX_VBOX()</h3>
902
 
<a class="indexterm" name="id2601126"></a><pre class="programlisting">#define     GIMP_QUERY_BOX_VBOX(qbox)</pre>
 
825
<a class="indexterm" name="id2651504"></a><pre class="programlisting">#define             GIMP_QUERY_BOX_VBOX(qbox)</pre>
903
826
<p>
904
827
A macro to access the <span class="type">GtkVBox</span> in a <span class="type">GimpQueryBox</span>. Useful if you want to add
905
828
more widgets.
907
830
<div class="variablelist"><table border="0">
908
831
<col align="left" valign="top">
909
832
<tbody><tr>
910
 
<td>
911
 
<span class="term"><em class="parameter"><code>qbox</code></em>&#160;:</span></td>
 
833
<td><span class="term"><em class="parameter"><code>qbox</code></em>&#160;:</span></td>
912
834
<td>
913
835
 
914
836
 
918
840
</div>
919
841
</div>
920
842
<div class="refsect1" lang="en">
921
 
<a name="id2601172"></a><h2>See Also</h2>
 
843
<a name="id2651550"></a><h2>See Also</h2>
922
844
<p>
923
845
GimpSizeEntry
924
846
</p>