]> Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkcontainer.sgml
=== Released 2.2.0 ===
[~andy/gtk] / docs / reference / gtk / tmpl / gtkcontainer.sgml
1 <!-- ##### SECTION Title ##### -->
2 GtkContainer
3
4 <!-- ##### SECTION Short_Description ##### -->
5 Base class for widgets which contain other widgets
6
7 <!-- ##### SECTION Long_Description ##### -->
8 <para id="child-properties">
9 <structname>GtkContainer</structname> introduces <firstterm>child 
10 properties</firstterm> - these are object properties that are not specific
11 to either the container or the contained widget, but rather to their relation.
12 Typical examples of child properties are the position or pack-type of a widget
13 which is contained in a #GtkBox.</para>
14 <para>
15 Use gtk_container_class_install_child_property() to install child properties 
16 for a container class and gtk_container_class_find_child_property() or
17 gtk_container_class_list_child_properties() to get information about existing
18 child properties.
19 </para>
20 <para>
21 To set the value of a child property, use gtk_container_child_set_property(), 
22 gtk_container_child_set() or gtk_container_child_set_valist(). 
23 To obtain the value of a child property, use 
24 gtk_container_child_get_property(), gtk_container_child_get() or
25 gtk_container_child_get_valist(). To emit notification about child property 
26 changes, use gtk_widget_child_notify().
27 </para>
28
29 <!-- ##### SECTION See_Also ##### -->
30 <para>
31
32 </para>
33
34 <!-- ##### STRUCT GtkContainer ##### -->
35 <para>
36
37 </para>
38
39
40 <!-- ##### MACRO GTK_IS_RESIZE_CONTAINER ##### -->
41 <para>
42
43 </para>
44
45 @widget: 
46
47
48 <!-- ##### MACRO GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID ##### -->
49 <para>
50
51 </para>
52
53 @object: 
54 @property_id: 
55 @pspec: 
56
57
58 <!-- ##### MACRO gtk_container_border_width ##### -->
59 <para>
60 Does the same as gtk_container_get_border_width().
61 </para>
62
63 @Deprecated: Use gtk_container_get_border_width() instead.
64
65
66 <!-- ##### FUNCTION gtk_container_add ##### -->
67 <para>
68
69 </para>
70
71 @container: 
72 @widget: 
73
74
75 <!-- ##### FUNCTION gtk_container_remove ##### -->
76 <para>
77
78 </para>
79
80 @container: 
81 @widget: 
82
83
84 <!-- ##### FUNCTION gtk_container_add_with_properties ##### -->
85 <para>
86
87 </para>
88
89 @container: 
90 @widget: 
91 @first_prop_name: 
92 @Varargs: 
93
94
95 <!-- ##### FUNCTION gtk_container_get_resize_mode ##### -->
96 <para>
97
98 </para>
99
100 @container: 
101 @Returns: 
102
103
104 <!-- ##### FUNCTION gtk_container_set_resize_mode ##### -->
105 <para>
106
107 </para>
108
109 @container: 
110 @resize_mode: 
111
112
113 <!-- ##### FUNCTION gtk_container_check_resize ##### -->
114 <para>
115
116 </para>
117
118 @container: 
119
120
121 <!-- ##### FUNCTION gtk_container_foreach ##### -->
122 <para>
123
124 </para>
125
126 @container: 
127 @callback: 
128 @callback_data: 
129
130
131 <!-- ##### FUNCTION gtk_container_foreach_full ##### -->
132 <para>
133
134 </para>
135
136 @container: 
137 @callback: 
138 @marshal: 
139 @callback_data: 
140 @notify: 
141 @Deprecated: Use gtk_container_foreach() instead.
142
143
144 <!-- ##### MACRO gtk_container_children ##### -->
145 <para>
146 Does the same as gtk_container_get_children().
147 </para>
148
149 @Returns: 
150 @Deprecated: Use gtk_container_get_children() instead.
151
152
153 <!-- ##### FUNCTION gtk_container_get_children ##### -->
154 <para>
155
156 </para>
157
158 @container: 
159 @Returns: 
160
161
162 <!-- ##### FUNCTION gtk_container_set_reallocate_redraws ##### -->
163 <para>
164
165 </para>
166
167 @container: 
168 @needs_redraws: 
169
170
171 <!-- ##### FUNCTION gtk_container_set_focus_child ##### -->
172 <para>
173
174 </para>
175
176 @container: 
177 @child: 
178
179
180 <!-- ##### FUNCTION gtk_container_get_focus_vadjustment ##### -->
181 <para>
182
183 </para>
184
185 @container: 
186 @Returns: 
187
188
189 <!-- ##### FUNCTION gtk_container_set_focus_vadjustment ##### -->
190 <para>
191
192 </para>
193
194 @container: 
195 @adjustment: 
196
197
198 <!-- ##### FUNCTION gtk_container_get_focus_hadjustment ##### -->
199 <para>
200
201 </para>
202
203 @container: 
204 @Returns: 
205
206
207 <!-- ##### FUNCTION gtk_container_set_focus_hadjustment ##### -->
208 <para>
209
210 </para>
211
212 @container: 
213 @adjustment: 
214
215
216 <!-- ##### FUNCTION gtk_container_resize_children ##### -->
217 <para>
218
219 </para>
220
221 @container: 
222
223
224 <!-- ##### FUNCTION gtk_container_child_type ##### -->
225 <para>
226
227 </para>
228
229 @container: 
230 @Returns: 
231
232
233 <!-- ##### FUNCTION gtk_container_child_get ##### -->
234 <para>
235
236 </para>
237
238 @container: 
239 @child: 
240 @first_prop_name: 
241 @Varargs: 
242
243
244 <!-- ##### FUNCTION gtk_container_child_set ##### -->
245 <para>
246
247 </para>
248
249 @container: 
250 @child: 
251 @first_prop_name: 
252 @Varargs: 
253 <!-- # Unused Parameters # -->
254 @first_arg_name: 
255
256
257 <!-- ##### FUNCTION gtk_container_child_get_property ##### -->
258 <para>
259
260 </para>
261
262 @container: 
263 @child: 
264 @property_name: 
265 @value: 
266
267
268 <!-- ##### FUNCTION gtk_container_child_set_property ##### -->
269 <para>
270
271 </para>
272
273 @container: 
274 @child: 
275 @property_name: 
276 @value: 
277
278
279 <!-- ##### FUNCTION gtk_container_child_get_valist ##### -->
280 <para>
281
282 </para>
283
284 @container: 
285 @child: 
286 @first_property_name: 
287 @var_args: 
288
289
290 <!-- ##### FUNCTION gtk_container_child_set_valist ##### -->
291 <para>
292
293 </para>
294
295 @container: 
296 @child: 
297 @first_property_name: 
298 @var_args: 
299
300
301 <!-- ##### FUNCTION gtk_container_forall ##### -->
302 <para>
303
304 </para>
305
306 @container: 
307 @callback: 
308 @callback_data: 
309
310
311 <!-- ##### FUNCTION gtk_container_get_border_width ##### -->
312 <para>
313
314 </para>
315
316 @container: 
317 @Returns: 
318
319
320 <!-- ##### FUNCTION gtk_container_set_border_width ##### -->
321 <para>
322
323 </para>
324
325 @container: 
326 @border_width: 
327
328
329 <!-- ##### FUNCTION gtk_container_propagate_expose ##### -->
330 <para>
331
332 </para>
333
334 @container: 
335 @child: 
336 @event: 
337
338
339 <!-- ##### FUNCTION gtk_container_get_focus_chain ##### -->
340 <para>
341
342 </para>
343
344 @container: 
345 @focusable_widgets: 
346 @Returns: 
347
348
349 <!-- ##### FUNCTION gtk_container_set_focus_chain ##### -->
350 <para>
351
352 </para>
353
354 @container: 
355 @focusable_widgets: 
356
357
358 <!-- ##### FUNCTION gtk_container_unset_focus_chain ##### -->
359 <para>
360
361 </para>
362
363 @container: 
364
365
366 <!-- ##### FUNCTION gtk_container_class_find_child_property ##### -->
367 <para>
368
369 </para>
370
371 @cclass: 
372 @property_name: 
373 @Returns: 
374 <!-- # Unused Parameters # -->
375 @class: 
376
377
378 <!-- ##### FUNCTION gtk_container_class_install_child_property ##### -->
379 <para>
380
381 </para>
382
383 @cclass: 
384 @property_id: 
385 @pspec: 
386 <!-- # Unused Parameters # -->
387 @class: 
388
389
390 <!-- ##### FUNCTION gtk_container_class_list_child_properties ##### -->
391 <para>
392
393 </para>
394
395 @cclass: 
396 @n_properties: 
397 @Returns: 
398 <!-- # Unused Parameters # -->
399 @class: 
400
401
402 <!-- ##### SIGNAL GtkContainer::add ##### -->
403 <para>
404
405 </para>
406
407 @container: the object which received the signal.
408 @widget: 
409
410 <!-- ##### SIGNAL GtkContainer::check-resize ##### -->
411 <para>
412
413 </para>
414
415 @container: the object which received the signal.
416
417 <!-- ##### SIGNAL GtkContainer::remove ##### -->
418 <para>
419
420 </para>
421
422 @container: the object which received the signal.
423 @widget: 
424
425 <!-- ##### SIGNAL GtkContainer::set-focus-child ##### -->
426 <para>
427
428 </para>
429
430 @container: the object which received the signal.
431 @widget: 
432
433 <!-- ##### ARG GtkContainer:border-width ##### -->
434 <para>
435
436 </para>
437
438 <!-- ##### ARG GtkContainer:child ##### -->
439 <para>
440
441 </para>
442
443 <!-- ##### ARG GtkContainer:resize-mode ##### -->
444 <para>
445
446 </para>
447