GitLab repository storage has been migrated to hashed layout. Please contact Infrastructure team if you notice any issues with repositories or hooks.

gtkwidget.sgml 37.9 KB
Newer Older
Owen Taylor's avatar
Owen Taylor committed
1 2 3 4
<!-- ##### SECTION Title ##### -->
GtkWidget

<!-- ##### SECTION Short_Description ##### -->
5
Base class for all widgets
Owen Taylor's avatar
Owen Taylor committed
6 7

<!-- ##### SECTION Long_Description ##### -->
8 9 10 11 12 13 14 15 16
<para id="style-properties">
<structname>GtkWidget</structname> introduces <firstterm>style 
properties</firstterm> - these are basically object properties that are stored
not on the object, but in the style object associated to the widget. Style
properties are set in <link linkend="gtk-Resource-Files">resource files</link>.
This mechanism is used for configuring such things as the location of the
scrollbar arrows through the theme, giving theme authors more control over the
look of applications without the need to write a theme engine in C.
</para>
Owen Taylor's avatar
Owen Taylor committed
17
<para>
18 19 20 21 22
Use gtk_widget_class_install_style_property() to install style properties for 
a widget class, gtk_widget_class_find_style_property() or
gtk_widget_class_list_style_properties() to get information about existing
style properties and gtk_widget_style_get_property(), gtk_widget_style_get() or
gtk_widget_style_get_valist() to obtain the value of a style property.
Owen Taylor's avatar
Owen Taylor committed
23 24 25 26 27 28 29 30 31 32 33 34
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### STRUCT GtkWidget ##### -->
<para>

</para>

35 36 37
@style: The style for the widget. The style contains the colors the widget should be 
 drawn in for each state along with graphics contexts used to draw with and the font 
 to use for text.
38 39 40
@requisition: The widget's desired size.
@allocation: The widget's allocated size.
@window: The widget's window or its parent window if it does not have a window. (Which 
41
 will be indicated by the #GTK_NO_WINDOW flag being set).
42
@parent: 
Owen Taylor's avatar
Owen Taylor committed
43

Soeren Sandmann's avatar
Soeren Sandmann committed
44
<!-- ##### SIGNAL GtkWidget::accel-closures-changed ##### -->
45 46
<para>

47
</para>
Owen Taylor's avatar
Owen Taylor committed
48

Soeren Sandmann's avatar
Soeren Sandmann committed
49
@widget: the object which received the signal.
Owen Taylor's avatar
Owen Taylor committed
50

Soeren Sandmann's avatar
Soeren Sandmann committed
51
<!-- ##### SIGNAL GtkWidget::button-press-event ##### -->
52
<para>
Owen Taylor's avatar
Owen Taylor committed
53

Owen Taylor's avatar
Owen Taylor committed
54
</para>
Owen Taylor's avatar
Owen Taylor committed
55

Soeren Sandmann's avatar
Soeren Sandmann committed
56 57 58
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
59

Soeren Sandmann's avatar
Soeren Sandmann committed
60
<!-- ##### SIGNAL GtkWidget::button-release-event ##### -->
61
<para>
Owen Taylor's avatar
Owen Taylor committed
62

Soeren Sandmann's avatar
Soeren Sandmann committed
63
</para>
Owen Taylor's avatar
Owen Taylor committed
64

Soeren Sandmann's avatar
Soeren Sandmann committed
65 66 67
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
68

Soeren Sandmann's avatar
Soeren Sandmann committed
69
<!-- ##### SIGNAL GtkWidget::can-activate-accel ##### -->
70
<para>
Owen Taylor's avatar
Owen Taylor committed
71

Soeren Sandmann's avatar
Soeren Sandmann committed
72
</para>
Owen Taylor's avatar
Owen Taylor committed
73

Soeren Sandmann's avatar
Soeren Sandmann committed
74 75 76
@widget: the object which received the signal.
@arg1: 
@Returns: 
Owen Taylor's avatar
Owen Taylor committed
77

Soeren Sandmann's avatar
Soeren Sandmann committed
78
<!-- ##### SIGNAL GtkWidget::child-notify ##### -->
79
<para>
Owen Taylor's avatar
Owen Taylor committed
80

Soeren Sandmann's avatar
Soeren Sandmann committed
81
</para>
Owen Taylor's avatar
Owen Taylor committed
82

Soeren Sandmann's avatar
Soeren Sandmann committed
83 84
@widget: the object which received the signal.
@arg1: 
Owen Taylor's avatar
Owen Taylor committed
85

Soeren Sandmann's avatar
Soeren Sandmann committed
86
<!-- ##### SIGNAL GtkWidget::client-event ##### -->
87
<para>
Owen Taylor's avatar
Owen Taylor committed
88

Soeren Sandmann's avatar
Soeren Sandmann committed
89
</para>
Owen Taylor's avatar
Owen Taylor committed
90

Soeren Sandmann's avatar
Soeren Sandmann committed
91 92 93
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
94

Soeren Sandmann's avatar
Soeren Sandmann committed
95
<!-- ##### SIGNAL GtkWidget::configure-event ##### -->
96
<para>
Owen Taylor's avatar
Owen Taylor committed
97

Soeren Sandmann's avatar
Soeren Sandmann committed
98
</para>
Owen Taylor's avatar
Owen Taylor committed
99

Soeren Sandmann's avatar
Soeren Sandmann committed
100 101 102
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
103

Soeren Sandmann's avatar
Soeren Sandmann committed
104
<!-- ##### SIGNAL GtkWidget::delete-event ##### -->
105
<para>
Owen Taylor's avatar
Owen Taylor committed
106

Soeren Sandmann's avatar
Soeren Sandmann committed
107
</para>
Owen Taylor's avatar
Owen Taylor committed
108

Soeren Sandmann's avatar
Soeren Sandmann committed
109 110 111
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
112

Soeren Sandmann's avatar
Soeren Sandmann committed
113
<!-- ##### SIGNAL GtkWidget::destroy-event ##### -->
114
<para>
Owen Taylor's avatar
Owen Taylor committed
115

Soeren Sandmann's avatar
Soeren Sandmann committed
116
</para>
Owen Taylor's avatar
Owen Taylor committed
117

Soeren Sandmann's avatar
Soeren Sandmann committed
118 119 120
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
121

Soeren Sandmann's avatar
Soeren Sandmann committed
122
<!-- ##### SIGNAL GtkWidget::direction-changed ##### -->
123
<para>
124

Soeren Sandmann's avatar
Soeren Sandmann committed
125
</para>
126

Soeren Sandmann's avatar
Soeren Sandmann committed
127 128
@widget: the object which received the signal.
@arg1: 
129

Soeren Sandmann's avatar
Soeren Sandmann committed
130
<!-- ##### SIGNAL GtkWidget::drag-begin ##### -->
131
<para>
Owen Taylor's avatar
Owen Taylor committed
132

Soeren Sandmann's avatar
Soeren Sandmann committed
133
</para>
Owen Taylor's avatar
Owen Taylor committed
134

Soeren Sandmann's avatar
Soeren Sandmann committed
135 136
@widget: the object which received the signal.
@drag_context: 
Owen Taylor's avatar
Owen Taylor committed
137

Soeren Sandmann's avatar
Soeren Sandmann committed
138
<!-- ##### SIGNAL GtkWidget::drag-data-delete ##### -->
139
<para>
Owen Taylor's avatar
Owen Taylor committed
140

Soeren Sandmann's avatar
Soeren Sandmann committed
141
</para>
Owen Taylor's avatar
Owen Taylor committed
142

Soeren Sandmann's avatar
Soeren Sandmann committed
143 144
@widget: the object which received the signal.
@drag_context: 
Owen Taylor's avatar
Owen Taylor committed
145

Soeren Sandmann's avatar
Soeren Sandmann committed
146
<!-- ##### SIGNAL GtkWidget::drag-data-get ##### -->
147
<para>
148

Soeren Sandmann's avatar
Soeren Sandmann committed
149
</para>
150

Soeren Sandmann's avatar
Soeren Sandmann committed
151 152 153 154 155 156 157
@widget: the object which received the signal.
@drag_context: 
@data: 
@info: 
@time: 
<!-- # Unused Parameters # -->
@time_: 
Owen Taylor's avatar
Owen Taylor committed
158

Soeren Sandmann's avatar
Soeren Sandmann committed
159
<!-- ##### SIGNAL GtkWidget::drag-data-received ##### -->
160
<para>
161

Soeren Sandmann's avatar
Soeren Sandmann committed
162
</para>
Owen Taylor's avatar
Owen Taylor committed
163

Soeren Sandmann's avatar
Soeren Sandmann committed
164 165 166 167 168 169 170 171 172
@widget: the object which received the signal.
@drag_context: 
@x: 
@y: 
@data: 
@info: 
@time: 
<!-- # Unused Parameters # -->
@time_: 
Owen Taylor's avatar
Owen Taylor committed
173

Soeren Sandmann's avatar
Soeren Sandmann committed
174
<!-- ##### SIGNAL GtkWidget::drag-drop ##### -->
175
<para>
176

Soeren Sandmann's avatar
Soeren Sandmann committed
177
</para>
178

Soeren Sandmann's avatar
Soeren Sandmann committed
179 180 181 182 183 184 185 186
@widget: the object which received the signal.
@drag_context: 
@x: 
@y: 
@time: 
@Returns: 
<!-- # Unused Parameters # -->
@time_: 
187

Soeren Sandmann's avatar
Soeren Sandmann committed
188
<!-- ##### SIGNAL GtkWidget::drag-end ##### -->
189
<para>
Owen Taylor's avatar
Owen Taylor committed
190

Soeren Sandmann's avatar
Soeren Sandmann committed
191
</para>
Owen Taylor's avatar
Owen Taylor committed
192

Soeren Sandmann's avatar
Soeren Sandmann committed
193 194
@widget: the object which received the signal.
@drag_context: 
Owen Taylor's avatar
Owen Taylor committed
195

Soeren Sandmann's avatar
Soeren Sandmann committed
196
<!-- ##### SIGNAL GtkWidget::drag-leave ##### -->
197
<para>
Owen Taylor's avatar
Owen Taylor committed
198

Soeren Sandmann's avatar
Soeren Sandmann committed
199
</para>
200

Soeren Sandmann's avatar
Soeren Sandmann committed
201 202 203 204 205
@widget: the object which received the signal.
@drag_context: 
@time: 
<!-- # Unused Parameters # -->
@time_: 
Owen Taylor's avatar
Owen Taylor committed
206

Soeren Sandmann's avatar
Soeren Sandmann committed
207
<!-- ##### SIGNAL GtkWidget::drag-motion ##### -->
208
<para>
209

Soeren Sandmann's avatar
Soeren Sandmann committed
210
</para>
211

Soeren Sandmann's avatar
Soeren Sandmann committed
212 213 214 215 216 217 218 219
@widget: the object which received the signal.
@drag_context: 
@x: 
@y: 
@time: 
@Returns: 
<!-- # Unused Parameters # -->
@time_: 
Owen Taylor's avatar
Owen Taylor committed
220

Soeren Sandmann's avatar
Soeren Sandmann committed
221
<!-- ##### SIGNAL GtkWidget::enter-notify-event ##### -->
222
<para>
Owen Taylor's avatar
Owen Taylor committed
223

Soeren Sandmann's avatar
Soeren Sandmann committed
224
</para>
Owen Taylor's avatar
Owen Taylor committed
225

Soeren Sandmann's avatar
Soeren Sandmann committed
226 227 228
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
229

Soeren Sandmann's avatar
Soeren Sandmann committed
230
<!-- ##### SIGNAL GtkWidget::event ##### -->
231
<para>
Owen Taylor's avatar
Owen Taylor committed
232

Soeren Sandmann's avatar
Soeren Sandmann committed
233
</para>
Owen Taylor's avatar
Owen Taylor committed
234

Soeren Sandmann's avatar
Soeren Sandmann committed
235 236 237
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
238

Soeren Sandmann's avatar
Soeren Sandmann committed
239
<!-- ##### SIGNAL GtkWidget::event-after ##### -->
Owen Taylor's avatar
Owen Taylor committed
240 241
<para>

Soeren Sandmann's avatar
Soeren Sandmann committed
242
</para>
Owen Taylor's avatar
Owen Taylor committed
243

Soeren Sandmann's avatar
Soeren Sandmann committed
244 245
@widget: the object which received the signal.
@event: 
Owen Taylor's avatar
Owen Taylor committed
246

Soeren Sandmann's avatar
Soeren Sandmann committed
247
<!-- ##### SIGNAL GtkWidget::expose-event ##### -->
248
<para>
Owen Taylor's avatar
Owen Taylor committed
249

Soeren Sandmann's avatar
Soeren Sandmann committed
250
</para>
Owen Taylor's avatar
Owen Taylor committed
251

Soeren Sandmann's avatar
Soeren Sandmann committed
252 253 254
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
255

Soeren Sandmann's avatar
Soeren Sandmann committed
256
<!-- ##### SIGNAL GtkWidget::focus ##### -->
257
<para>
258

Soeren Sandmann's avatar
Soeren Sandmann committed
259
</para>
260

Soeren Sandmann's avatar
Soeren Sandmann committed
261 262 263
@widget: the object which received the signal.
@arg1: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
264

Soeren Sandmann's avatar
Soeren Sandmann committed
265
<!-- ##### SIGNAL GtkWidget::focus-in-event ##### -->
266
<para>
Owen Taylor's avatar
Owen Taylor committed
267

Soeren Sandmann's avatar
Soeren Sandmann committed
268
</para>
269

Soeren Sandmann's avatar
Soeren Sandmann committed
270 271 272
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
273

Soeren Sandmann's avatar
Soeren Sandmann committed
274
<!-- ##### SIGNAL GtkWidget::focus-out-event ##### -->
275
<para>
Owen Taylor's avatar
Owen Taylor committed
276

Soeren Sandmann's avatar
Soeren Sandmann committed
277
</para>
278

Soeren Sandmann's avatar
Soeren Sandmann committed
279 280 281
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
282

Soeren Sandmann's avatar
Soeren Sandmann committed
283
<!-- ##### SIGNAL GtkWidget::grab-focus ##### -->
284
<para>
Owen Taylor's avatar
Owen Taylor committed
285

Soeren Sandmann's avatar
Soeren Sandmann committed
286
</para>
287

Soeren Sandmann's avatar
Soeren Sandmann committed
288
@widget: the object which received the signal.
Owen Taylor's avatar
Owen Taylor committed
289

Soeren Sandmann's avatar
Soeren Sandmann committed
290
<!-- ##### SIGNAL GtkWidget::grab-notify ##### -->
291
<para>
Owen Taylor's avatar
Owen Taylor committed
292

Soeren Sandmann's avatar
Soeren Sandmann committed
293
</para>
294

Soeren Sandmann's avatar
Soeren Sandmann committed
295 296
@widget: the object which received the signal.
@arg1: 
297

Soeren Sandmann's avatar
Soeren Sandmann committed
298
<!-- ##### SIGNAL GtkWidget::hide ##### -->
299
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
300

301 302
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
303
@widget: the object which received the signal.
304

Soeren Sandmann's avatar
Soeren Sandmann committed
305
<!-- ##### SIGNAL GtkWidget::hierarchy-changed ##### -->
Owen Taylor's avatar
Owen Taylor committed
306
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
307 308 309 310 311
Emitted when there is a chance in the hierarchy to
which a widget belong. More precisely, a widget is
<firstterm>anchored</firstterm> when its toplevel
ancestor is a #GtkWindow. This signal is emitted when 
a widget changes from un-anchored to anchored or vice-versa.
Owen Taylor's avatar
Owen Taylor committed
312 313
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
314 315
@widget: the object which received the signal.
@widget2: 
316

Soeren Sandmann's avatar
Soeren Sandmann committed
317
<!-- ##### SIGNAL GtkWidget::key-press-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
318 319 320 321
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
322 323 324
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
325

Soeren Sandmann's avatar
Soeren Sandmann committed
326
<!-- ##### SIGNAL GtkWidget::key-release-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
327 328 329 330
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
331 332 333
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
334

Soeren Sandmann's avatar
Soeren Sandmann committed
335
<!-- ##### SIGNAL GtkWidget::leave-notify-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
336 337 338 339
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
340 341 342
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
343

Soeren Sandmann's avatar
Soeren Sandmann committed
344
<!-- ##### SIGNAL GtkWidget::map ##### -->
Owen Taylor's avatar
Owen Taylor committed
345 346 347 348
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
349
@widget: the object which received the signal.
350

Soeren Sandmann's avatar
Soeren Sandmann committed
351
<!-- ##### SIGNAL GtkWidget::map-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
352 353 354 355
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
356 357 358
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
359

Soeren Sandmann's avatar
Soeren Sandmann committed
360
<!-- ##### SIGNAL GtkWidget::mnemonic-activate ##### -->
Owen Taylor's avatar
Owen Taylor committed
361 362 363 364
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
365 366
@widget: the object which received the signal.
@arg1: 
367
@Returns: 
368

Soeren Sandmann's avatar
Soeren Sandmann committed
369
<!-- ##### SIGNAL GtkWidget::motion-notify-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
370 371 372 373
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
374 375 376
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
377

Soeren Sandmann's avatar
Soeren Sandmann committed
378
<!-- ##### SIGNAL GtkWidget::no-expose-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
379 380 381 382
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
383 384 385
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
386

Soeren Sandmann's avatar
Soeren Sandmann committed
387
<!-- ##### SIGNAL GtkWidget::parent-set ##### -->
Owen Taylor's avatar
Owen Taylor committed
388 389 390 391
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
392 393
@widget: the object which received the signal.
@old_parent: 
394

Soeren Sandmann's avatar
Soeren Sandmann committed
395
<!-- ##### SIGNAL GtkWidget::popup-menu ##### -->
Owen Taylor's avatar
Owen Taylor committed
396 397 398 399
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
400 401
@widget: the object which received the signal.
@Returns: 
402

Soeren Sandmann's avatar
Soeren Sandmann committed
403
<!-- ##### SIGNAL GtkWidget::property-notify-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
404 405 406 407
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
408 409 410
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
411

Soeren Sandmann's avatar
Soeren Sandmann committed
412
<!-- ##### SIGNAL GtkWidget::proximity-in-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
413 414 415 416
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
417 418 419
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
420

Soeren Sandmann's avatar
Soeren Sandmann committed
421
<!-- ##### SIGNAL GtkWidget::proximity-out-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
422 423 424 425
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
426 427 428
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
429

Soeren Sandmann's avatar
Soeren Sandmann committed
430
<!-- ##### SIGNAL GtkWidget::realize ##### -->
Owen Taylor's avatar
Owen Taylor committed
431 432 433 434
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
435
@widget: the object which received the signal.
436

Soeren Sandmann's avatar
Soeren Sandmann committed
437
<!-- ##### SIGNAL GtkWidget::screen-changed ##### -->
Owen Taylor's avatar
Owen Taylor committed
438 439 440 441
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
442 443
@widget: the object which received the signal.
@arg1: 
444

Soeren Sandmann's avatar
Soeren Sandmann committed
445
<!-- ##### SIGNAL GtkWidget::scroll-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
446 447 448 449
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
450 451 452
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
453

Soeren Sandmann's avatar
Soeren Sandmann committed
454
<!-- ##### SIGNAL GtkWidget::selection-clear-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
455 456 457 458
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
459 460 461
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
462

Soeren Sandmann's avatar
Soeren Sandmann committed
463
<!-- ##### SIGNAL GtkWidget::selection-get ##### -->
Owen Taylor's avatar
Owen Taylor committed
464 465 466 467
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
468 469 470 471 472 473
@widget: the object which received the signal.
@data: 
@info: 
@time: 
<!-- # Unused Parameters # -->
@time_: 
474

Soeren Sandmann's avatar
Soeren Sandmann committed
475
<!-- ##### SIGNAL GtkWidget::selection-notify-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
476 477 478 479
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
480 481 482
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
483

Soeren Sandmann's avatar
Soeren Sandmann committed
484
<!-- ##### SIGNAL GtkWidget::selection-received ##### -->
Owen Taylor's avatar
Owen Taylor committed
485 486 487 488
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
489 490 491 492 493
@widget: the object which received the signal.
@data: 
@time: 
<!-- # Unused Parameters # -->
@time_: 
494

Soeren Sandmann's avatar
Soeren Sandmann committed
495
<!-- ##### SIGNAL GtkWidget::selection-request-event ##### -->
496 497 498 499
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
500 501 502
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
503

Soeren Sandmann's avatar
Soeren Sandmann committed
504
<!-- ##### SIGNAL GtkWidget::show ##### -->
Owen Taylor's avatar
Owen Taylor committed
505 506 507 508
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
509
@widget: the object which received the signal.
510

Soeren Sandmann's avatar
Soeren Sandmann committed
511
<!-- ##### SIGNAL GtkWidget::show-help ##### -->
Owen Taylor's avatar
Owen Taylor committed
512 513 514 515
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
516 517 518
@widget: the object which received the signal.
@arg1: 
@Returns: 
519

Soeren Sandmann's avatar
Soeren Sandmann committed
520
<!-- ##### SIGNAL GtkWidget::size-allocate ##### -->
Owen Taylor's avatar
Owen Taylor committed
521 522 523 524
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
525 526
@widget: the object which received the signal.
@allocation: 
527

Soeren Sandmann's avatar
Soeren Sandmann committed
528
<!-- ##### SIGNAL GtkWidget::size-request ##### -->
Owen Taylor's avatar
Owen Taylor committed
529
<para>
Owen Taylor's avatar
Owen Taylor committed
530

Owen Taylor's avatar
Owen Taylor committed
531
</para>
Owen Taylor's avatar
Owen Taylor committed
532

Soeren Sandmann's avatar
Soeren Sandmann committed
533
@widget: the object which received the signal.
534
@requisition: 
Owen Taylor's avatar
Owen Taylor committed
535

Soeren Sandmann's avatar
Soeren Sandmann committed
536
<!-- ##### SIGNAL GtkWidget::state-changed ##### -->
Owen Taylor's avatar
Owen Taylor committed
537
<para>
Owen Taylor's avatar
Owen Taylor committed
538

Owen Taylor's avatar
Owen Taylor committed
539
</para>
Owen Taylor's avatar
Owen Taylor committed
540

Soeren Sandmann's avatar
Soeren Sandmann committed
541 542
@widget: the object which received the signal.
@state: 
Owen Taylor's avatar
Owen Taylor committed
543

Soeren Sandmann's avatar
Soeren Sandmann committed
544
<!-- ##### SIGNAL GtkWidget::style-set ##### -->
Owen Taylor's avatar
Owen Taylor committed
545
<para>
Owen Taylor's avatar
Owen Taylor committed
546

Owen Taylor's avatar
Owen Taylor committed
547
</para>
Owen Taylor's avatar
Owen Taylor committed
548

Soeren Sandmann's avatar
Soeren Sandmann committed
549 550
@widget: the object which received the signal.
@previous_style: 
Owen Taylor's avatar
Owen Taylor committed
551

Soeren Sandmann's avatar
Soeren Sandmann committed
552
<!-- ##### SIGNAL GtkWidget::unmap ##### -->
Owen Taylor's avatar
Owen Taylor committed
553
<para>
Owen Taylor's avatar
Owen Taylor committed
554

Owen Taylor's avatar
Owen Taylor committed
555
</para>
Owen Taylor's avatar
Owen Taylor committed
556

Soeren Sandmann's avatar
Soeren Sandmann committed
557
@widget: the object which received the signal.
Owen Taylor's avatar
Owen Taylor committed
558

Soeren Sandmann's avatar
Soeren Sandmann committed
559
<!-- ##### SIGNAL GtkWidget::unmap-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
560
<para>
Owen Taylor's avatar
Owen Taylor committed
561

Owen Taylor's avatar
Owen Taylor committed
562
</para>
Owen Taylor's avatar
Owen Taylor committed
563

Soeren Sandmann's avatar
Soeren Sandmann committed
564 565 566
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
567

Soeren Sandmann's avatar
Soeren Sandmann committed
568
<!-- ##### SIGNAL GtkWidget::unrealize ##### -->
Owen Taylor's avatar
Owen Taylor committed
569
<para>
Owen Taylor's avatar
Owen Taylor committed
570

Owen Taylor's avatar
Owen Taylor committed
571
</para>
Owen Taylor's avatar
Owen Taylor committed
572

Soeren Sandmann's avatar
Soeren Sandmann committed
573
@widget: the object which received the signal.
574

Soeren Sandmann's avatar
Soeren Sandmann committed
575
<!-- ##### SIGNAL GtkWidget::visibility-notify-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
576
<para>
Owen Taylor's avatar
Owen Taylor committed
577

Owen Taylor's avatar
Owen Taylor committed
578
</para>
Owen Taylor's avatar
Owen Taylor committed
579

Soeren Sandmann's avatar
Soeren Sandmann committed
580 581 582
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
583

Soeren Sandmann's avatar
Soeren Sandmann committed
584
<!-- ##### SIGNAL GtkWidget::window-state-event ##### -->
Owen Taylor's avatar
Owen Taylor committed
585
<para>
586

Owen Taylor's avatar
Owen Taylor committed
587
</para>
588

Soeren Sandmann's avatar
Soeren Sandmann committed
589 590 591
@widget: the object which received the signal.
@event: 
@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
Owen Taylor's avatar
Owen Taylor committed
592

Soeren Sandmann's avatar
Soeren Sandmann committed
593 594
<!-- ##### ARG GtkWidget:app-paintable ##### -->
<para>
Owen Taylor's avatar
Owen Taylor committed
595

Soeren Sandmann's avatar
Soeren Sandmann committed
596 597 598
</para>

<!-- ##### ARG GtkWidget:can-default ##### -->
Owen Taylor's avatar
Owen Taylor committed
599
<para>
600

Owen Taylor's avatar
Owen Taylor committed
601
</para>
602

Soeren Sandmann's avatar
Soeren Sandmann committed
603 604
<!-- ##### ARG GtkWidget:can-focus ##### -->
<para>
Owen Taylor's avatar
Owen Taylor committed
605

Soeren Sandmann's avatar
Soeren Sandmann committed
606
</para>
Owen Taylor's avatar
Owen Taylor committed
607

Soeren Sandmann's avatar
Soeren Sandmann committed
608
<!-- ##### ARG GtkWidget:composite-child ##### -->
Owen Taylor's avatar
Owen Taylor committed
609
<para>
610

Owen Taylor's avatar
Owen Taylor committed
611
</para>
612

Soeren Sandmann's avatar
Soeren Sandmann committed
613 614
<!-- ##### ARG GtkWidget:events ##### -->
<para>
Owen Taylor's avatar
Owen Taylor committed
615

Soeren Sandmann's avatar
Soeren Sandmann committed
616
</para>
Owen Taylor's avatar
Owen Taylor committed
617

Soeren Sandmann's avatar
Soeren Sandmann committed
618
<!-- ##### ARG GtkWidget:extension-events ##### -->
Owen Taylor's avatar
Owen Taylor committed
619
<para>
Owen Taylor's avatar
Owen Taylor committed
620

Owen Taylor's avatar
Owen Taylor committed
621
</para>
Owen Taylor's avatar
Owen Taylor committed
622

Soeren Sandmann's avatar
Soeren Sandmann committed
623 624
<!-- ##### ARG GtkWidget:has-default ##### -->
<para>
625

Soeren Sandmann's avatar
Soeren Sandmann committed
626
</para>
627

Soeren Sandmann's avatar
Soeren Sandmann committed
628
<!-- ##### ARG GtkWidget:has-focus ##### -->
Owen Taylor's avatar
Owen Taylor committed
629 630 631 632
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
633 634
<!-- ##### ARG GtkWidget:height-request ##### -->
<para>
635

Soeren Sandmann's avatar
Soeren Sandmann committed
636
</para>
637

Soeren Sandmann's avatar
Soeren Sandmann committed
638
<!-- ##### ARG GtkWidget:is-focus ##### -->
Owen Taylor's avatar
Owen Taylor committed
639
<para>
Owen Taylor's avatar
Owen Taylor committed
640

Owen Taylor's avatar
Owen Taylor committed
641
</para>
Owen Taylor's avatar
Owen Taylor committed
642

Soeren Sandmann's avatar
Soeren Sandmann committed
643 644
<!-- ##### ARG GtkWidget:name ##### -->
<para>
645

Soeren Sandmann's avatar
Soeren Sandmann committed
646
</para>
647

Soeren Sandmann's avatar
Soeren Sandmann committed
648
<!-- ##### ARG GtkWidget:no-show-all ##### -->
Owen Taylor's avatar
Owen Taylor committed
649 650 651 652
<para>

</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
653 654
<!-- ##### ARG GtkWidget:parent ##### -->
<para>
655

Soeren Sandmann's avatar
Soeren Sandmann committed
656
</para>
657

Soeren Sandmann's avatar
Soeren Sandmann committed
658
<!-- ##### ARG GtkWidget:receives-default ##### -->
Owen Taylor's avatar
Owen Taylor committed
659
<para>
Owen Taylor's avatar
Owen Taylor committed
660

Owen Taylor's avatar
Owen Taylor committed
661
</para>
Owen Taylor's avatar
Owen Taylor committed
662

Soeren Sandmann's avatar
Soeren Sandmann committed
663 664
<!-- ##### ARG GtkWidget:sensitive ##### -->
<para>
665

Soeren Sandmann's avatar
Soeren Sandmann committed
666
</para>
667

Soeren Sandmann's avatar
Soeren Sandmann committed
668
<!-- ##### ARG GtkWidget:style ##### -->
Owen Taylor's avatar
Owen Taylor committed
669
<para>
670

Owen Taylor's avatar
Owen Taylor committed
671 672
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
673 674
<!-- ##### ARG GtkWidget:visible ##### -->
<para>
675

Soeren Sandmann's avatar
Soeren Sandmann committed
676
</para>
677

Soeren Sandmann's avatar
Soeren Sandmann committed
678
<!-- ##### ARG GtkWidget:width-request ##### -->
Owen Taylor's avatar
Owen Taylor committed
679
<para>
680

Owen Taylor's avatar
Owen Taylor committed
681
</para>
Owen Taylor's avatar
Owen Taylor committed
682

Soeren Sandmann's avatar
Soeren Sandmann committed
683 684
<!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
<para>
Owen Taylor's avatar
Owen Taylor committed
685

Soeren Sandmann's avatar
Soeren Sandmann committed
686
</para>
687

Soeren Sandmann's avatar
Soeren Sandmann committed
688
<!-- ##### ARG GtkWidget:cursor-color ##### -->
Owen Taylor's avatar
Owen Taylor committed
689
<para>
690

Owen Taylor's avatar
Owen Taylor committed
691 692
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
693 694
<!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
<para>
Owen Taylor's avatar
Owen Taylor committed
695

Soeren Sandmann's avatar
Soeren Sandmann committed
696
</para>
697

Soeren Sandmann's avatar
Soeren Sandmann committed
698
<!-- ##### ARG GtkWidget:focus-line-width ##### -->
Owen Taylor's avatar
Owen Taylor committed
699
<para>
700

Owen Taylor's avatar
Owen Taylor committed
701
</para>
Owen Taylor's avatar
Owen Taylor committed
702

Soeren Sandmann's avatar
Soeren Sandmann committed
703 704
<!-- ##### ARG GtkWidget:focus-padding ##### -->
<para>
705

Soeren Sandmann's avatar
Soeren Sandmann committed
706
</para>
707

Soeren Sandmann's avatar
Soeren Sandmann committed
708
<!-- ##### ARG GtkWidget:interior-focus ##### -->
Owen Taylor's avatar
Owen Taylor committed
709
<para>
710

Owen Taylor's avatar
Owen Taylor committed
711 712
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
713 714
<!-- ##### ARG GtkWidget:secondary-cursor-color ##### -->
<para>
715

Soeren Sandmann's avatar
Soeren Sandmann committed
716 717 718 719 720 721 722 723 724
</para>

<!-- ##### STRUCT GtkWidgetClass ##### -->
<para>
<structfield>activate_signal</structfield>
The signal to emit when a widget of this class is activated,
gtk_widget_activate() handles the emission. Implementation of this
signal is optional. 
</para>
725

Owen Taylor's avatar
Owen Taylor committed
726
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
727 728 729 730 731
<structfield>set_scroll_adjustment_signal</structfield>
This signal is emitted  when a widget of this class is added
to a scrolling aware parent, gtk_widget_set_scroll_adjustments()
handles the emission.
Implementation of this signal is optional.
Owen Taylor's avatar
Owen Taylor committed
732
</para>
733

Soeren Sandmann's avatar
Soeren Sandmann committed
734 735 736
@parent_class: 
@activate_signal: 
@set_scroll_adjustments_signal: 
737

Soeren Sandmann's avatar
Soeren Sandmann committed
738
<!-- ##### ENUM GtkWidgetFlags ##### -->
Owen Taylor's avatar
Owen Taylor committed
739
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
740
Tells about certain properties of the widget.
Owen Taylor's avatar
Owen Taylor committed
741 742
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763
@GTK_TOPLEVEL: 
        widgets without a real parent, as there are #GtkWindow<!-- -->s and
        #GtkMenu<!-- -->s have this flag set throughout their lifetime.
        Toplevel widgets always contain their own #GdkWindow.
@GTK_NO_WINDOW: 
        Indicative for a widget that does not provide its own #GdkWindow. 
        Visible action (e.g. drawing) is performed on the parent's #GdkWindow.
@GTK_REALIZED: 
        Set by gtk_widget_realize(), unset by gtk_widget_unrealize().
        A realized widget has an associated #GdkWindow.
@GTK_MAPPED: 
        Set by gtk_widget_map(), unset by gtk_widget_unmap().
        Only realized widgets can be mapped. It means that gdk_window_show() 
        has been called on the widgets window(s).
@GTK_VISIBLE: 
        Set by gtk_widget_show(), unset by gtk_widget_hide(). Implies that a 
        widget will be mapped as soon as its parent is mapped.
@GTK_SENSITIVE: 
        Set and unset by gtk_widget_set_sensitive().
        The sensitivity of a widget determines whether it will receive
        certain events (e.g. button or key presses). One premise for
764
        the widget's sensitivity is to have this flag set.
Soeren Sandmann's avatar
Soeren Sandmann committed
765 766 767
@GTK_PARENT_SENSITIVE: 
        Set and unset by gtk_widget_set_sensitive() operations on the
        parents of the widget.
768
        This is the second premise for the widget's sensitivity. Once
Soeren Sandmann's avatar
Soeren Sandmann committed
769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787
        it has %GTK_SENSITIVE and %GTK_PARENT_SENSITIVE set, its state is
        effectively sensitive. This is expressed (and can be examined) by
        the #GTK_WIDGET_IS_SENSITIVE macro.
@GTK_CAN_FOCUS: 
        Determines whether a widget is able to handle focus grabs.
@GTK_HAS_FOCUS: 
        Set by gtk_widget_grab_focus() for widgets that also
        have %GTK_CAN_FOCUS set. The flag will be unset once another widget
        grabs the focus.
@GTK_CAN_DEFAULT: 
        The widget is allowed to receive the default action via 
        gtk_widget_grab_default().
@GTK_HAS_DEFAULT: 
        The widget currently is receiving the default action.
@GTK_HAS_GRAB: 
        Set by gtk_grab_add(), unset by gtk_grab_remove(). It means that the 
        widget is in the grab_widgets stack, and will be the preferred one for 
        receiving events other than ones of cosmetic value.
@GTK_RC_STYLE: 
788
        Indicates that the widget's style has been looked up through the rc 
Soeren Sandmann's avatar
Soeren Sandmann committed
789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806
        mechanism. It does not imply that the widget actually had a style 
        defined through the rc mechanism.
@GTK_COMPOSITE_CHILD: 
        Indicates that the widget is a composite child of its parent; see 
        gtk_widget_push_composite_child(), gtk_widget_pop_composite_child().
@GTK_NO_REPARENT: 
	Unused since before GTK+ 1.2, will be removed in a future version.
@GTK_APP_PAINTABLE: 
        Set and unset by gtk_widget_set_app_paintable().
        Must be set on widgets whose window the application directly draws on, 
	in order to keep GTK+ from overwriting the drawn stuff.
@GTK_RECEIVES_DEFAULT: 
        The widget when focused will receive the default action and have 
        %GTK_HAS_DEFAULT set even if there is a different widget set as default.
@GTK_DOUBLE_BUFFERED: 
        Set and unset by gtk_widget_set_double_buffered().
        Indicates that exposes done on the widget should be double-buffered.
@GTK_NO_SHOW_ALL: 
Owen Taylor's avatar
Owen Taylor committed
807

Soeren Sandmann's avatar
Soeren Sandmann committed
808
<!-- ##### MACRO GTK_WIDGET_TYPE ##### -->
Owen Taylor's avatar
Owen Taylor committed
809
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
810
Gets the type of a widget.
Owen Taylor's avatar
Owen Taylor committed
811 812
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
813
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
814 815


Soeren Sandmann's avatar
Soeren Sandmann committed
816
<!-- ##### MACRO GTK_WIDGET_STATE ##### -->
Owen Taylor's avatar
Owen Taylor committed
817
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
818
Returns the current state of the widget, as a #GtkStateType.
Owen Taylor's avatar
Owen Taylor committed
819 820
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
821
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
822 823


Soeren Sandmann's avatar
Soeren Sandmann committed
824
<!-- ##### MACRO GTK_WIDGET_SAVED_STATE ##### -->
Owen Taylor's avatar
Owen Taylor committed
825
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
826 827 828 829 830 831
Returns the saved state of the widget, as a #GtkStateType.
</para>
<para>
The saved state will be restored when a widget gets sensitive
again, after it has been made insensitive with gtk_widget_set_state()
or gtk_widget_set_sensitive().
Owen Taylor's avatar
Owen Taylor committed
832 833
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
834
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
835 836


Soeren Sandmann's avatar
Soeren Sandmann committed
837
<!-- ##### MACRO GTK_WIDGET_FLAGS ##### -->
Owen Taylor's avatar
Owen Taylor committed
838
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
839
Returns the widget flags from @wid.
Owen Taylor's avatar
Owen Taylor committed
840 841
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
842
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
843 844


Soeren Sandmann's avatar
Soeren Sandmann committed
845
<!-- ##### MACRO GTK_WIDGET_TOPLEVEL ##### -->
Owen Taylor's avatar
Owen Taylor committed
846
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
847
Evaluates to %TRUE if the widget is a toplevel widget.
Owen Taylor's avatar
Owen Taylor committed
848 849
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
850
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
851 852


Soeren Sandmann's avatar
Soeren Sandmann committed
853
<!-- ##### MACRO GTK_WIDGET_NO_WINDOW ##### -->
Owen Taylor's avatar
Owen Taylor committed
854
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
855
Evaluates to %TRUE if the widget doesn't have an own #GdkWindow.
Owen Taylor's avatar
Owen Taylor committed
856 857
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
858
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
859 860


Soeren Sandmann's avatar
Soeren Sandmann committed
861
<!-- ##### MACRO GTK_WIDGET_REALIZED ##### -->
Owen Taylor's avatar
Owen Taylor committed
862
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
863
Evaluates to %TRUE if the widget is realized.
Owen Taylor's avatar
Owen Taylor committed
864 865
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
866
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
867 868


Soeren Sandmann's avatar
Soeren Sandmann committed
869
<!-- ##### MACRO GTK_WIDGET_MAPPED ##### -->
Owen Taylor's avatar
Owen Taylor committed
870
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
871
Evaluates to %TRUE if the widget is mapped.
Owen Taylor's avatar
Owen Taylor committed
872 873
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
874
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
875 876


Soeren Sandmann's avatar
Soeren Sandmann committed
877
<!-- ##### MACRO GTK_WIDGET_VISIBLE ##### -->
Owen Taylor's avatar
Owen Taylor committed
878
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
879
Evaluates to %TRUE if the widget is visible.
Owen Taylor's avatar
Owen Taylor committed
880 881
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
882
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
883 884


Soeren Sandmann's avatar
Soeren Sandmann committed
885
<!-- ##### MACRO GTK_WIDGET_DRAWABLE ##### -->
Owen Taylor's avatar
Owen Taylor committed
886
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
887
Evaluates to %TRUE if the widget is mapped and visible.
Owen Taylor's avatar
Owen Taylor committed
888 889
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
890
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
891 892


Soeren Sandmann's avatar
Soeren Sandmann committed
893
<!-- ##### MACRO GTK_WIDGET_SENSITIVE ##### -->
Owen Taylor's avatar
Updates  
Owen Taylor committed
894
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
895
Evaluates to %TRUE if the #GTK_SENSITIVE flag has be set on the widget.
Owen Taylor's avatar
Updates  
Owen Taylor committed
896 897
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
898
@wid: a #GtkWidget.
Owen Taylor's avatar
Updates  
Owen Taylor committed
899 900


Soeren Sandmann's avatar
Soeren Sandmann committed
901
<!-- ##### MACRO GTK_WIDGET_PARENT_SENSITIVE ##### -->
Owen Taylor's avatar
Owen Taylor committed
902
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
903
Evaluates to %TRUE if the #GTK_PARENT_SENSITIVE flag has be set on the widget.
Owen Taylor's avatar
Owen Taylor committed
904 905
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
906
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
907 908


Soeren Sandmann's avatar
Soeren Sandmann committed
909
<!-- ##### MACRO GTK_WIDGET_IS_SENSITIVE ##### -->
Owen Taylor's avatar
Owen Taylor committed
910
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
911
Evaluates to %TRUE if the widget is effectively sensitive.
Owen Taylor's avatar
Owen Taylor committed
912 913
</para>

Soeren Sandmann's avatar
Soeren Sandmann committed
914
@wid: a #GtkWidget.
Owen Taylor's avatar
Owen Taylor committed
915 916


Soeren Sandmann's avatar
Soeren Sandmann committed
917
<!-- ##### MACRO GTK_WIDGET_CAN_FOCUS ##### -->
Owen Taylor's avatar
Owen Taylor committed
918
<para>
Soeren Sandmann's avatar
Soeren Sandmann committed
919
Evaluates to %TRUE if the widget is able to handle focus grabs.