Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkwidget.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 GtkWidget
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 Base class for all widgets
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para id="style-properties">
   9 <structname>GtkWidget</structname> introduces <firstterm>style
  10 properties</firstterm> - these are basically object properties that are stored
  11 not on the object, but in the style object associated to the widget. Style
  12 properties are set in <link linkend="gtk-Resource-Files">resource files</link>.
  13 This mechanism is used for configuring such things as the location of the
  14 scrollbar arrows through the theme, giving theme authors more control over the
  15 look of applications without the need to write a theme engine in C.
  16 </para>
  17 <para>
  18 Use gtk_widget_class_install_style_property() to install style properties for
  19 a widget class, gtk_widget_class_find_style_property() or
  20 gtk_widget_class_list_style_properties() to get information about existing
  21 style properties and gtk_widget_style_get_property(), gtk_widget_style_get() or
  22 gtk_widget_style_get_valist() to obtain the value of a style property.
  23 </para>
  24
  25 <!-- ##### SECTION See_Also ##### -->
  26 <para>
  27
  28 </para>
  29
  30 <!-- ##### SECTION Stability_Level ##### -->
  31
  32
  33 <!-- ##### STRUCT GtkWidget ##### -->
  34 <para>
  35
  36 </para>
  37
  38 @style: The style for the widget. The style contains the colors the widget should be
  39  drawn in for each state along with graphics contexts used to draw with and the font
  40  to use for text.
  41 @requisition: The widget's desired size.
  42 @allocation: The widget's allocated size.
  43 @window: The widget's window or its parent window if it does not have a window. (Which
  44  will be indicated by the #GTK_NO_WINDOW flag being set).
  45 @parent:
  46
  47 <!-- ##### SIGNAL GtkWidget::accel-closures-changed ##### -->
  48 <para>
  49
  50 </para>
  51
  52 @widget: the object which received the signal.
  53
  54 <!-- ##### SIGNAL GtkWidget::button-press-event ##### -->
  55 <para>
  56
  57 </para>
  58
  59 @widget: the object which received the signal.
  60 @event:
  61 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
  62
  63 <!-- ##### SIGNAL GtkWidget::button-release-event ##### -->
  64 <para>
  65
  66 </para>
  67
  68 @widget: the object which received the signal.
  69 @event:
  70 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
  71
  72 <!-- ##### SIGNAL GtkWidget::can-activate-accel ##### -->
  73 <para>
  74
  75 </para>
  76
  77 @widget: the object which received the signal.
  78 @arg1:
  79 @Returns:
  80
  81 <!-- ##### SIGNAL GtkWidget::child-notify ##### -->
  82 <para>
  83
  84 </para>
  85
  86 @widget: the object which received the signal.
  87 @arg1:
  88
  89 <!-- ##### SIGNAL GtkWidget::client-event ##### -->
  90 <para>
  91
  92 </para>
  93
  94 @widget: the object which received the signal.
  95 @event:
  96 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
  97
  98 <!-- ##### SIGNAL GtkWidget::composited-changed ##### -->
  99 <para>
 100
 101 </para>
 102
 103 @widget: the object which received the signal.
 104
 105 <!-- ##### SIGNAL GtkWidget::configure-event ##### -->
 106 <para>
 107
 108 </para>
 109
 110 @widget: the object which received the signal.
 111 @event:
 112 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 113
 114 <!-- ##### SIGNAL GtkWidget::delete-event ##### -->
 115 <para>
 116
 117 </para>
 118
 119 @widget: the object which received the signal.
 120 @event:
 121 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 122
 123 <!-- ##### SIGNAL GtkWidget::destroy-event ##### -->
 124 <para>
 125
 126 </para>
 127
 128 @widget: the object which received the signal.
 129 @event:
 130 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 131
 132 <!-- ##### SIGNAL GtkWidget::direction-changed ##### -->
 133 <para>
 134
 135 </para>
 136
 137 @widget: the object which received the signal.
 138 @arg1:
 139
 140 <!-- ##### SIGNAL GtkWidget::drag-begin ##### -->
 141 <para>
 142
 143 </para>
 144
 145 @widget: the object which received the signal.
 146 @drag_context:
 147
 148 <!-- ##### SIGNAL GtkWidget::drag-data-delete ##### -->
 149 <para>
 150
 151 </para>
 152
 153 @widget: the object which received the signal.
 154 @drag_context:
 155
 156 <!-- ##### SIGNAL GtkWidget::drag-data-get ##### -->
 157 <para>
 158
 159 </para>
 160
 161 @widget: the object which received the signal.
 162 @drag_context:
 163 @data:
 164 @info:
 165 @time:
 166
 167 <!-- ##### SIGNAL GtkWidget::drag-data-received ##### -->
 168 <para>
 169
 170 </para>
 171
 172 @widget: the object which received the signal.
 173 @drag_context:
 174 @x:
 175 @y:
 176 @data:
 177 @info:
 178 @time:
 179
 180 <!-- ##### SIGNAL GtkWidget::drag-drop ##### -->
 181 <para>
 182
 183 </para>
 184
 185 @widget: the object which received the signal.
 186 @drag_context:
 187 @x:
 188 @y:
 189 @time:
 190 @Returns:
 191
 192 <!-- ##### SIGNAL GtkWidget::drag-end ##### -->
 193 <para>
 194
 195 </para>
 196
 197 @widget: the object which received the signal.
 198 @drag_context:
 199
 200 <!-- ##### SIGNAL GtkWidget::drag-failed ##### -->
 201 <para>
 202
 203 </para>
 204
 205 @widget: the object which received the signal.
 206 @arg1:
 207 @arg2:
 208 @Returns:
 209
 210 <!-- ##### SIGNAL GtkWidget::drag-leave ##### -->
 211 <para>
 212
 213 </para>
 214
 215 @widget: the object which received the signal.
 216 @drag_context:
 217 @time:
 218
 219 <!-- ##### SIGNAL GtkWidget::drag-motion ##### -->
 220 <para>
 221
 222 </para>
 223
 224 @widget: the object which received the signal.
 225 @drag_context:
 226 @x:
 227 @y:
 228 @time:
 229 @Returns:
 230
 231 <!-- ##### SIGNAL GtkWidget::enter-notify-event ##### -->
 232 <para>
 233
 234 </para>
 235
 236 @widget: the object which received the signal.
 237 @event:
 238 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 239
 240 <!-- ##### SIGNAL GtkWidget::event ##### -->
 241 <para>
 242
 243 </para>
 244
 245 @widget: the object which received the signal.
 246 @event:
 247 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 248
 249 <!-- ##### SIGNAL GtkWidget::event-after ##### -->
 250 <para>
 251
 252 </para>
 253
 254 @widget: the object which received the signal.
 255 @event:
 256
 257 <!-- ##### SIGNAL GtkWidget::expose-event ##### -->
 258 <para>
 259
 260 </para>
 261
 262 @widget: the object which received the signal.
 263 @event:
 264 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 265
 266 <!-- ##### SIGNAL GtkWidget::focus ##### -->
 267 <para>
 268
 269 </para>
 270
 271 @widget: the object which received the signal.
 272 @arg1:
 273 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 274
 275 <!-- ##### SIGNAL GtkWidget::focus-in-event ##### -->
 276 <para>
 277
 278 </para>
 279
 280 @widget: the object which received the signal.
 281 @event:
 282 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 283
 284 <!-- ##### SIGNAL GtkWidget::focus-out-event ##### -->
 285 <para>
 286
 287 </para>
 288
 289 @widget: the object which received the signal.
 290 @event:
 291 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 292
 293 <!-- ##### SIGNAL GtkWidget::grab-broken-event ##### -->
 294 <para>
 295
 296 </para>
 297
 298 @widget: the object which received the signal.
 299 @event:
 300 @Returns:
 301
 302 <!-- ##### SIGNAL GtkWidget::grab-focus ##### -->
 303 <para>
 304
 305 </para>
 306
 307 @widget: the object which received the signal.
 308
 309 <!-- ##### SIGNAL GtkWidget::grab-notify ##### -->
 310 <para>
 311
 312 </para>
 313
 314 @widget: the object which received the signal.
 315 @arg1:
 316
 317 <!-- ##### SIGNAL GtkWidget::hide ##### -->
 318 <para>
 319
 320 </para>
 321
 322 @widget: the object which received the signal.
 323
 324 <!-- ##### SIGNAL GtkWidget::hierarchy-changed ##### -->
 325 <para>
 326 Emitted when there is a change in the hierarchy to
 327 which a widget belongs. More precisely, a widget is
 328 <firstterm>anchored</firstterm> when its toplevel
 329 ancestor is a #GtkWindow. This signal is emitted when
 330 a widget changes from un-anchored to anchored or vice-versa.
 331 </para>
 332
 333 @widget: the object which received the signal.
 334 @widget2: the toplevel ancestor, or %NULL
 335
 336 <!-- ##### SIGNAL GtkWidget::key-press-event ##### -->
 337 <para>
 338
 339 </para>
 340
 341 @widget: the object which received the signal.
 342 @event:
 343 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 344
 345 <!-- ##### SIGNAL GtkWidget::key-release-event ##### -->
 346 <para>
 347
 348 </para>
 349
 350 @widget: the object which received the signal.
 351 @event:
 352 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 353
 354 <!-- ##### SIGNAL GtkWidget::keynav-failed ##### -->
 355 <para>
 356
 357 </para>
 358
 359 @widget: the object which received the signal.
 360 @arg1:
 361 @Returns:
 362
 363 <!-- ##### SIGNAL GtkWidget::leave-notify-event ##### -->
 364 <para>
 365
 366 </para>
 367
 368 @widget: the object which received the signal.
 369 @event:
 370 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 371
 372 <!-- ##### SIGNAL GtkWidget::map ##### -->
 373 <para>
 374
 375 </para>
 376
 377 @widget: the object which received the signal.
 378
 379 <!-- ##### SIGNAL GtkWidget::map-event ##### -->
 380 <para>
 381
 382 </para>
 383
 384 @widget: the object which received the signal.
 385 @event:
 386 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 387
 388 <!-- ##### SIGNAL GtkWidget::mnemonic-activate ##### -->
 389 <para>
 390
 391 </para>
 392
 393 @widget: the object which received the signal.
 394 @arg1:
 395 @Returns:
 396
 397 <!-- ##### SIGNAL GtkWidget::motion-notify-event ##### -->
 398 <para>
 399
 400 </para>
 401
 402 @widget: the object which received the signal.
 403 @event:
 404 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 405
 406 <!-- ##### SIGNAL GtkWidget::move-focus ##### -->
 407 <para>
 408
 409 </para>
 410
 411 @widget: the object which received the signal.
 412 @arg1:
 413
 414 <!-- ##### SIGNAL GtkWidget::no-expose-event ##### -->
 415 <para>
 416
 417 </para>
 418
 419 @widget: the object which received the signal.
 420 @event:
 421 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 422
 423 <!-- ##### SIGNAL GtkWidget::parent-set ##### -->
 424 <para>
 425
 426 </para>
 427
 428 @widget: the object which received the signal.
 429 @old_parent:
 430
 431 <!-- ##### SIGNAL GtkWidget::popup-menu ##### -->
 432 <para>
 433
 434 </para>
 435
 436 @widget: the object which received the signal.
 437 @Returns:
 438
 439 <!-- ##### SIGNAL GtkWidget::property-notify-event ##### -->
 440 <para>
 441
 442 </para>
 443
 444 @widget: the object which received the signal.
 445 @event:
 446 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 447
 448 <!-- ##### SIGNAL GtkWidget::proximity-in-event ##### -->
 449 <para>
 450
 451 </para>
 452
 453 @widget: the object which received the signal.
 454 @event:
 455 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 456
 457 <!-- ##### SIGNAL GtkWidget::proximity-out-event ##### -->
 458 <para>
 459
 460 </para>
 461
 462 @widget: the object which received the signal.
 463 @event:
 464 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 465
 466 <!-- ##### SIGNAL GtkWidget::query-tooltip ##### -->
 467 <para>
 468
 469 </para>
 470
 471 @widget: the object which received the signal.
 472 @arg1:
 473 @arg2:
 474 @arg3:
 475 @arg4:
 476 @Returns:
 477
 478 <!-- ##### SIGNAL GtkWidget::realize ##### -->
 479 <para>
 480
 481 </para>
 482
 483 @widget: the object which received the signal.
 484
 485 <!-- ##### SIGNAL GtkWidget::screen-changed ##### -->
 486 <para>
 487
 488 </para>
 489
 490 @widget: the object which received the signal.
 491 @arg1:
 492
 493 <!-- ##### SIGNAL GtkWidget::scroll-event ##### -->
 494 <para>
 495
 496 </para>
 497
 498 @widget: the object which received the signal.
 499 @event:
 500 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 501
 502 <!-- ##### SIGNAL GtkWidget::selection-clear-event ##### -->
 503 <para>
 504
 505 </para>
 506
 507 @widget: the object which received the signal.
 508 @event:
 509 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 510
 511 <!-- ##### SIGNAL GtkWidget::selection-get ##### -->
 512 <para>
 513
 514 </para>
 515
 516 @widget: the object which received the signal.
 517 @data:
 518 @info:
 519 @time:
 520
 521 <!-- ##### SIGNAL GtkWidget::selection-notify-event ##### -->
 522 <para>
 523
 524 </para>
 525
 526 @widget: the object which received the signal.
 527 @event:
 528 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 529
 530 <!-- ##### SIGNAL GtkWidget::selection-received ##### -->
 531 <para>
 532
 533 </para>
 534
 535 @widget: the object which received the signal.
 536 @data:
 537 @time:
 538
 539 <!-- ##### SIGNAL GtkWidget::selection-request-event ##### -->
 540 <para>
 541
 542 </para>
 543
 544 @widget: the object which received the signal.
 545 @event:
 546 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 547
 548 <!-- ##### SIGNAL GtkWidget::show ##### -->
 549 <para>
 550
 551 </para>
 552
 553 @widget: the object which received the signal.
 554
 555 <!-- ##### SIGNAL GtkWidget::show-help ##### -->
 556 <para>
 557
 558 </para>
 559
 560 @widget: the object which received the signal.
 561 @arg1:
 562 @Returns:
 563
 564 <!-- ##### SIGNAL GtkWidget::size-allocate ##### -->
 565 <para>
 566
 567 </para>
 568
 569 @widget: the object which received the signal.
 570 @allocation:
 571
 572 <!-- ##### SIGNAL GtkWidget::size-request ##### -->
 573 <para>
 574
 575 </para>
 576
 577 @widget: the object which received the signal.
 578 @requisition:
 579
 580 <!-- ##### SIGNAL GtkWidget::state-changed ##### -->
 581 <para>
 582
 583 </para>
 584
 585 @widget: the object which received the signal.
 586 @state:
 587
 588 <!-- ##### SIGNAL GtkWidget::style-set ##### -->
 589 <para>
 590
 591 </para>
 592
 593 @widget: the object which received the signal.
 594 @previous_style:
 595
 596 <!-- ##### SIGNAL GtkWidget::unmap ##### -->
 597 <para>
 598
 599 </para>
 600
 601 @widget: the object which received the signal.
 602
 603 <!-- ##### SIGNAL GtkWidget::unmap-event ##### -->
 604 <para>
 605
 606 </para>
 607
 608 @widget: the object which received the signal.
 609 @event:
 610 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 611
 612 <!-- ##### SIGNAL GtkWidget::unrealize ##### -->
 613 <para>
 614
 615 </para>
 616
 617 @widget: the object which received the signal.
 618
 619 <!-- ##### SIGNAL GtkWidget::visibility-notify-event ##### -->
 620 <para>
 621
 622 </para>
 623
 624 @widget: the object which received the signal.
 625 @event:
 626 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 627
 628 <!-- ##### SIGNAL GtkWidget::window-state-event ##### -->
 629 <para>
 630
 631 </para>
 632
 633 @widget: the object which received the signal.
 634 @event:
 635 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 636
 637 <!-- ##### ARG GtkWidget:app-paintable ##### -->
 638 <para>
 639
 640 </para>
 641
 642 <!-- ##### ARG GtkWidget:can-default ##### -->
 643 <para>
 644
 645 </para>
 646
 647 <!-- ##### ARG GtkWidget:can-focus ##### -->
 648 <para>
 649
 650 </para>
 651
 652 <!-- ##### ARG GtkWidget:composite-child ##### -->
 653 <para>
 654
 655 </para>
 656
 657 <!-- ##### ARG GtkWidget:events ##### -->
 658 <para>
 659
 660 </para>
 661
 662 <!-- ##### ARG GtkWidget:extension-events ##### -->
 663 <para>
 664
 665 </para>
 666
 667 <!-- ##### ARG GtkWidget:has-default ##### -->
 668 <para>
 669
 670 </para>
 671
 672 <!-- ##### ARG GtkWidget:has-focus ##### -->
 673 <para>
 674
 675 </para>
 676
 677 <!-- ##### ARG GtkWidget:has-tooltip ##### -->
 678 <para>
 679
 680 </para>
 681
 682 <!-- ##### ARG GtkWidget:height-request ##### -->
 683 <para>
 684
 685 </para>
 686
 687 <!-- ##### ARG GtkWidget:is-focus ##### -->
 688 <para>
 689
 690 </para>
 691
 692 <!-- ##### ARG GtkWidget:name ##### -->
 693 <para>
 694
 695 </para>
 696
 697 <!-- ##### ARG GtkWidget:no-show-all ##### -->
 698 <para>
 699
 700 </para>
 701
 702 <!-- ##### ARG GtkWidget:parent ##### -->
 703 <para>
 704
 705 </para>
 706
 707 <!-- ##### ARG GtkWidget:receives-default ##### -->
 708 <para>
 709
 710 </para>
 711
 712 <!-- ##### ARG GtkWidget:sensitive ##### -->
 713 <para>
 714
 715 </para>
 716
 717 <!-- ##### ARG GtkWidget:style ##### -->
 718 <para>
 719
 720 </para>
 721
 722 <!-- ##### ARG GtkWidget:tooltip-markup ##### -->
 723 <para>
 724
 725 </para>
 726
 727 <!-- ##### ARG GtkWidget:visible ##### -->
 728 <para>
 729
 730 </para>
 731
 732 <!-- ##### ARG GtkWidget:width-request ##### -->
 733 <para>
 734
 735 </para>
 736
 737 <!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
 738 <para>
 739
 740 </para>
 741
 742 <!-- ##### ARG GtkWidget:cursor-color ##### -->
 743 <para>
 744
 745 </para>
 746
 747 <!-- ##### ARG GtkWidget:draw-border ##### -->
 748 <para>
 749
 750 </para>
 751
 752 <!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
 753 <para>
 754
 755 </para>
 756
 757 <!-- ##### ARG GtkWidget:focus-line-width ##### -->
 758 <para>
 759
 760 </para>
 761
 762 <!-- ##### ARG GtkWidget:focus-padding ##### -->
 763 <para>
 764
 765 </para>
 766
 767 <!-- ##### ARG GtkWidget:interior-focus ##### -->
 768 <para>
 769
 770 </para>
 771
 772 <!-- ##### ARG GtkWidget:link-color ##### -->
 773 <para>
 774
 775 </para>
 776
 777 <!-- ##### ARG GtkWidget:scroll-arrow-hlength ##### -->
 778 <para>
 779
 780 </para>
 781
 782 <!-- ##### ARG GtkWidget:scroll-arrow-vlength ##### -->
 783 <para>
 784
 785 </para>
 786
 787 <!-- ##### ARG GtkWidget:secondary-cursor-color ##### -->
 788 <para>
 789
 790 </para>
 791
 792 <!-- ##### ARG GtkWidget:separator-height ##### -->
 793 <para>
 794
 795 </para>
 796
 797 <!-- ##### ARG GtkWidget:separator-width ##### -->
 798 <para>
 799
 800 </para>
 801
 802 <!-- ##### ARG GtkWidget:visited-link-color ##### -->
 803 <para>
 804
 805 </para>
 806
 807 <!-- ##### ARG GtkWidget:wide-separators ##### -->
 808 <para>
 809
 810 </para>
 811
 812 <!-- ##### STRUCT GtkWidgetClass ##### -->
 813 <para>
 814 <structfield>activate_signal</structfield>
 815 The signal to emit when a widget of this class is activated,
 816 gtk_widget_activate() handles the emission. Implementation of this
 817 signal is optional.
 818 </para>
 819
 820 <para>
 821 <structfield>set_scroll_adjustment_signal</structfield>
 822 This signal is emitted  when a widget of this class is added
 823 to a scrolling aware parent, gtk_widget_set_scroll_adjustments()
 824 handles the emission.
 825 Implementation of this signal is optional.
 826 </para>
 827
 828 @parent_class:
 829 @activate_signal:
 830 @set_scroll_adjustments_signal:
 831
 832 <!-- ##### ENUM GtkWidgetFlags ##### -->
 833 <para>
 834 Tells about certain properties of the widget.
 835 </para>
 836
 837 @GTK_TOPLEVEL:
 838         widgets without a real parent, as there are #GtkWindow<!-- -->s and
 839         #GtkMenu<!-- -->s have this flag set throughout their lifetime.
 840         Toplevel widgets always contain their own #GdkWindow.
 841 @GTK_NO_WINDOW:
 842         Indicative for a widget that does not provide its own #GdkWindow.
 843         Visible action (e.g. drawing) is performed on the parent's #GdkWindow.
 844 @GTK_REALIZED:
 845         Set by gtk_widget_realize(), unset by gtk_widget_unrealize().
 846         A realized widget has an associated #GdkWindow.
 847 @GTK_MAPPED:
 848         Set by gtk_widget_map(), unset by gtk_widget_unmap().
 849         Only realized widgets can be mapped. It means that gdk_window_show()
 850         has been called on the widgets window(s).
 851 @GTK_VISIBLE:
 852         Set by gtk_widget_show(), unset by gtk_widget_hide(). Implies that a
 853         widget will be mapped as soon as its parent is mapped.
 854 @GTK_SENSITIVE:
 855         Set and unset by gtk_widget_set_sensitive().
 856         The sensitivity of a widget determines whether it will receive
 857         certain events (e.g. button or key presses). One premise for
 858         the widget's sensitivity is to have this flag set.
 859 @GTK_PARENT_SENSITIVE:
 860         Set and unset by gtk_widget_set_sensitive() operations on the
 861         parents of the widget.
 862         This is the second premise for the widget's sensitivity. Once
 863         it has %GTK_SENSITIVE and %GTK_PARENT_SENSITIVE set, its state is
 864         effectively sensitive. This is expressed (and can be examined) by
 865         the #GTK_WIDGET_IS_SENSITIVE macro.
 866 @GTK_CAN_FOCUS:
 867         Determines whether a widget is able to handle focus grabs.
 868 @GTK_HAS_FOCUS:
 869         Set by gtk_widget_grab_focus() for widgets that also
 870         have %GTK_CAN_FOCUS set. The flag will be unset once another widget
 871         grabs the focus.
 872 @GTK_CAN_DEFAULT:
 873         The widget is allowed to receive the default action via
 874         gtk_widget_grab_default().
 875 @GTK_HAS_DEFAULT:
 876         The widget currently is receiving the default action.
 877 @GTK_HAS_GRAB:
 878         Set by gtk_grab_add(), unset by gtk_grab_remove(). It means that the
 879         widget is in the grab_widgets stack, and will be the preferred one for
 880         receiving events other than ones of cosmetic value.
 881 @GTK_RC_STYLE:
 882         Indicates that the widget's style has been looked up through the rc
 883         mechanism. It does not imply that the widget actually had a style
 884         defined through the rc mechanism.
 885 @GTK_COMPOSITE_CHILD:
 886         Indicates that the widget is a composite child of its parent; see
 887         gtk_widget_push_composite_child(), gtk_widget_pop_composite_child().
 888 @GTK_NO_REPARENT:
 889         Unused since before GTK+ 1.2, will be removed in a future version.
 890 @GTK_APP_PAINTABLE:
 891         Set and unset by gtk_widget_set_app_paintable().
 892         Must be set on widgets whose window the application directly draws on,
 893         in order to keep GTK+ from overwriting the drawn stuff.
 894 @GTK_RECEIVES_DEFAULT:
 895         The widget when focused will receive the default action and have
 896         %GTK_HAS_DEFAULT set even if there is a different widget set as default.
 897 @GTK_DOUBLE_BUFFERED:
 898         Set and unset by gtk_widget_set_double_buffered().
 899         Indicates that exposes done on the widget should be double-buffered.
 900 @GTK_NO_SHOW_ALL:
 901
 902 <!-- ##### MACRO GTK_WIDGET_TYPE ##### -->
 903 <para>
 904 Gets the type of a widget.
 905 </para>
 906
 907 @wid: a #GtkWidget.
 908
 909
 910 <!-- ##### MACRO GTK_WIDGET_STATE ##### -->
 911 <para>
 912 Returns the current state of the widget, as a #GtkStateType.
 913 </para>
 914
 915 @wid: a #GtkWidget.
 916
 917
 918 <!-- ##### MACRO GTK_WIDGET_SAVED_STATE ##### -->
 919 <para>
 920 Returns the saved state of the widget, as a #GtkStateType.
 921 </para>
 922 <para>
 923 The saved state will be restored when a widget gets sensitive
 924 again, after it has been made insensitive with gtk_widget_set_state()
 925 or gtk_widget_set_sensitive().
 926 </para>
 927
 928 @wid: a #GtkWidget.
 929
 930
 931 <!-- ##### MACRO GTK_WIDGET_FLAGS ##### -->
 932 <para>
 933 Returns the widget flags from @wid.
 934 </para>
 935
 936 @wid: a #GtkWidget.
 937
 938
 939 <!-- ##### MACRO GTK_WIDGET_TOPLEVEL ##### -->
 940 <para>
 941 Evaluates to %TRUE if the widget is a toplevel widget.
 942 </para>
 943
 944 @wid: a #GtkWidget.
 945
 946
 947 <!-- ##### MACRO GTK_WIDGET_NO_WINDOW ##### -->
 948 <para>
 949 Evaluates to %TRUE if the widget doesn't have an own #GdkWindow.
 950 </para>
 951
 952 @wid: a #GtkWidget.
 953
 954
 955 <!-- ##### MACRO GTK_WIDGET_REALIZED ##### -->
 956 <para>
 957 Evaluates to %TRUE if the widget is realized.
 958 </para>
 959
 960 @wid: a #GtkWidget.
 961
 962
 963 <!-- ##### MACRO GTK_WIDGET_MAPPED ##### -->
 964 <para>
 965 Evaluates to %TRUE if the widget is mapped.
 966 </para>
 967
 968 @wid: a #GtkWidget.
 969
 970
 971 <!-- ##### MACRO GTK_WIDGET_VISIBLE ##### -->
 972 <para>
 973 Evaluates to %TRUE if the widget is visible.
 974 </para>
 975
 976 @wid: a #GtkWidget.
 977
 978
 979 <!-- ##### MACRO GTK_WIDGET_DRAWABLE ##### -->
 980 <para>
 981 Evaluates to %TRUE if the widget is mapped and visible.
 982 </para>
 983
 984 @wid: a #GtkWidget.
 985
 986
 987 <!-- ##### MACRO GTK_WIDGET_SENSITIVE ##### -->
 988 <para>
 989 Evaluates to %TRUE if the #GTK_SENSITIVE flag has be set on the widget.
 990 </para>
 991
 992 @wid: a #GtkWidget.
 993
 994
 995 <!-- ##### MACRO GTK_WIDGET_PARENT_SENSITIVE ##### -->
 996 <para>
 997 Evaluates to %TRUE if the #GTK_PARENT_SENSITIVE flag has be set on the widget.
 998 </para>
 999
1000 @wid: a #GtkWidget.
1001
1002
1003 <!-- ##### MACRO GTK_WIDGET_IS_SENSITIVE ##### -->
1004 <para>
1005 Evaluates to %TRUE if the widget is effectively sensitive.
1006 </para>
1007
1008 @wid: a #GtkWidget.
1009
1010
1011 <!-- ##### MACRO GTK_WIDGET_CAN_FOCUS ##### -->
1012 <para>
1013 Evaluates to %TRUE if the widget is able to handle focus grabs.
1014 </para>
1015
1016 @wid: a #GtkWidget.
1017
1018
1019 <!-- ##### MACRO GTK_WIDGET_HAS_FOCUS ##### -->
1020 <para>
1021 Evaluates to %TRUE if the widget has grabbed the focus and no other
1022 widget has done so more recently.
1023 </para>
1024
1025 @wid: a #GtkWidget.
1026
1027
1028 <!-- ##### MACRO GTK_WIDGET_CAN_DEFAULT ##### -->
1029 <para>
1030 Evaluates to %TRUE if the widget is allowed to receive the default action
1031 via gtk_widget_grab_default().
1032 </para>
1033
1034 @wid: a #GtkWidget.
1035
1036
1037 <!-- ##### MACRO GTK_WIDGET_RECEIVES_DEFAULT ##### -->
1038 <para>
1039 Evaluates to %TRUE if the widget when focused will receive the default action
1040 even if there is a different widget set as default.
1041 </para>
1042
1043 @wid: a #GtkWidget.
1044
1045
1046 <!-- ##### MACRO GTK_WIDGET_HAS_DEFAULT ##### -->
1047 <para>
1048 Evaluates to %TRUE if the widget currently is receiving the default action.
1049 </para>
1050
1051 @wid: a #GtkWidget.
1052
1053
1054 <!-- ##### MACRO GTK_WIDGET_HAS_GRAB ##### -->
1055 <para>
1056 Evaluates to %TRUE if the widget is in the grab_widgets stack, and will be
1057 the preferred one for receiving events other than ones of cosmetic value.
1058 </para>
1059
1060 @wid: a #GtkWidget.
1061
1062
1063 <!-- ##### MACRO GTK_WIDGET_RC_STYLE ##### -->
1064 <para>
1065 Evaluates to %TRUE if the widget's style has been looked up through the rc
1066 mechanism.
1067 </para>
1068
1069 @wid: a #GtkWidget.
1070
1071
1072 <!-- ##### MACRO GTK_WIDGET_COMPOSITE_CHILD ##### -->
1073 <para>
1074 Evaluates to %TRUE if the widget is a composite child of its parent.
1075 </para>
1076
1077 @wid: a #GtkWidget.
1078
1079
1080 <!-- ##### MACRO GTK_WIDGET_APP_PAINTABLE ##### -->
1081 <para>
1082 Evaluates to %TRUE if the #GTK_APP_PAINTABLE flag has been set on the widget.
1083 </para>
1084
1085 @wid: a #GtkWidget.
1086
1087
1088 <!-- ##### MACRO GTK_WIDGET_DOUBLE_BUFFERED ##### -->
1089 <para>
1090 Evaluates to %TRUE if the #GTK_DOUBLE_BUFFERED flag has been set on the widget.
1091 </para>
1092
1093 @wid: a #GtkWidget.
1094
1095
1096 <!-- ##### MACRO GTK_WIDGET_SET_FLAGS ##### -->
1097 <para>
1098 Turns on certain widget flags.
1099 </para>
1100
1101 @wid: a #GtkWidget.
1102 @flag: the flags to set.
1103
1104
1105 <!-- ##### MACRO GTK_WIDGET_UNSET_FLAGS ##### -->
1106 <para>
1107 Turns off certain widget flags.
1108 </para>
1109
1110 @wid: a #GtkWidget.
1111 @flag: the flags to unset.
1112
1113
1114 <!-- ##### USER_FUNCTION GtkCallback ##### -->
1115 <para>
1116 The type of the callback functions used for e.g. iterating over
1117 the children of a container, see gtk_container_foreach().
1118 </para>
1119
1120 @widget: the widget to operate on
1121 @data: user-supplied data
1122
1123
1124 <!-- ##### STRUCT GtkRequisition ##### -->
1125 <para>
1126 A <structname>GtkRequisition</structname> represents the desired size of a widget. See
1127 <xref linkend="size-requisition"/> for more information.
1128 </para>
1129
1130 @width: the widget's desired width
1131 @height: the widget's desired height
1132
1133 <!-- ##### STRUCT GtkAllocation ##### -->
1134 <para>
1135 A <structname>GtkAllocation</structname> of a widget represents region which has been allocated to the
1136 widget by its parent. It is a subregion of its parents allocation. See
1137 <xref linkend="size-allocation"/> for more information.
1138 </para>
1139
1140 @x: the X position of the widget's area relative to its parents allocation.
1141 @y: the Y position of the widget's area relative to its parents allocation.
1142 @width: the width of the widget's allocated area.
1143 @height: the height of the widget's allocated area.
1144
1145 <!-- ##### STRUCT GtkSelectionData ##### -->
1146 <para>
1147
1148 </para>
1149
1150 @selection:
1151 @target:
1152 @type:
1153 @format:
1154 @data:
1155 @length:
1156 @display:
1157
1158 <!-- ##### STRUCT GtkWidgetAuxInfo ##### -->
1159 <para>
1160
1161 </para>
1162
1163 @x:
1164 @y:
1165 @width:
1166 @height:
1167 @x_set:
1168 @y_set:
1169
1170 <!-- ##### STRUCT GtkWidgetShapeInfo ##### -->
1171 <para>
1172
1173 </para>
1174
1175 @offset_x:
1176 @offset_y:
1177 @shape_mask:
1178
1179 <!-- ##### ENUM GtkWidgetHelpType ##### -->
1180 <para>
1181
1182 </para>
1183
1184 @GTK_WIDGET_HELP_TOOLTIP:
1185 @GTK_WIDGET_HELP_WHATS_THIS:
1186
1187 <!-- ##### FUNCTION gtk_widget_new ##### -->
1188 <para>
1189
1190 </para>
1191
1192 @type:
1193 @first_property_name:
1194 @Varargs:
1195 @Returns:
1196
1197
1198 <!-- ##### FUNCTION gtk_widget_ref ##### -->
1199 <para>
1200
1201 </para>
1202
1203 @widget:
1204 @Returns:
1205
1206
1207 <!-- ##### FUNCTION gtk_widget_unref ##### -->
1208 <para>
1209
1210 </para>
1211
1212 @widget:
1213
1214
1215 <!-- ##### FUNCTION gtk_widget_destroy ##### -->
1216 <para>
1217
1218 </para>
1219
1220 @widget:
1221
1222
1223 <!-- ##### FUNCTION gtk_widget_destroyed ##### -->
1224 <para>
1225
1226 </para>
1227
1228 @widget:
1229 @widget_pointer:
1230
1231
1232 <!-- ##### FUNCTION gtk_widget_set ##### -->
1233 <para>
1234
1235 </para>
1236
1237 @widget:
1238 @first_property_name:
1239 @Varargs:
1240
1241
1242 <!-- ##### FUNCTION gtk_widget_unparent ##### -->
1243 <para>
1244
1245 </para>
1246
1247 @widget:
1248
1249
1250 <!-- ##### FUNCTION gtk_widget_show ##### -->
1251 <para>
1252
1253 </para>
1254
1255 @widget:
1256
1257
1258 <!-- ##### FUNCTION gtk_widget_show_now ##### -->
1259 <para>
1260
1261 </para>
1262
1263 @widget:
1264
1265
1266 <!-- ##### FUNCTION gtk_widget_hide ##### -->
1267 <para>
1268
1269 </para>
1270
1271 @widget:
1272
1273
1274 <!-- ##### FUNCTION gtk_widget_show_all ##### -->
1275 <para>
1276
1277 </para>
1278
1279 @widget:
1280
1281
1282 <!-- ##### FUNCTION gtk_widget_hide_all ##### -->
1283 <para>
1284
1285 </para>
1286
1287 @widget:
1288
1289
1290 <!-- ##### FUNCTION gtk_widget_map ##### -->
1291 <para>
1292
1293 </para>
1294
1295 @widget:
1296
1297
1298 <!-- ##### FUNCTION gtk_widget_unmap ##### -->
1299 <para>
1300
1301 </para>
1302
1303 @widget:
1304
1305
1306 <!-- ##### FUNCTION gtk_widget_realize ##### -->
1307 <para>
1308
1309 </para>
1310
1311 @widget:
1312
1313
1314 <!-- ##### FUNCTION gtk_widget_unrealize ##### -->
1315 <para>
1316
1317 </para>
1318
1319 @widget:
1320
1321
1322 <!-- ##### FUNCTION gtk_widget_queue_draw ##### -->
1323 <para>
1324
1325 </para>
1326
1327 @widget:
1328
1329
1330 <!-- ##### FUNCTION gtk_widget_queue_resize ##### -->
1331 <para>
1332
1333 </para>
1334
1335 @widget:
1336
1337
1338 <!-- ##### FUNCTION gtk_widget_queue_resize_no_redraw ##### -->
1339 <para>
1340
1341 </para>
1342
1343 @widget:
1344
1345
1346 <!-- ##### FUNCTION gtk_widget_draw ##### -->
1347 <para>
1348
1349 </para>
1350
1351 @widget:
1352 @area:
1353
1354
1355 <!-- ##### FUNCTION gtk_widget_size_request ##### -->
1356 <para>
1357
1358 </para>
1359
1360 @widget:
1361 @requisition:
1362
1363
1364 <!-- ##### FUNCTION gtk_widget_get_child_requisition ##### -->
1365 <para>
1366
1367 </para>
1368
1369 @widget:
1370 @requisition:
1371
1372
1373 <!-- ##### FUNCTION gtk_widget_size_allocate ##### -->
1374 <para>
1375
1376 </para>
1377
1378 @widget:
1379 @allocation:
1380
1381
1382 <!-- ##### FUNCTION gtk_widget_add_accelerator ##### -->
1383 <para>
1384
1385 </para>
1386
1387 @widget:
1388 @accel_signal:
1389 @accel_group:
1390 @accel_key:
1391 @accel_mods:
1392 @accel_flags:
1393
1394
1395 <!-- ##### FUNCTION gtk_widget_remove_accelerator ##### -->
1396 <para>
1397
1398 </para>
1399
1400 @widget:
1401 @accel_group:
1402 @accel_key:
1403 @accel_mods:
1404 @Returns:
1405
1406
1407 <!-- ##### FUNCTION gtk_widget_set_accel_path ##### -->
1408 <para>
1409
1410 </para>
1411
1412 @widget:
1413 @accel_path:
1414 @accel_group:
1415
1416
1417 <!-- ##### FUNCTION gtk_widget_list_accel_closures ##### -->
1418 <para>
1419
1420 </para>
1421
1422 @widget:
1423 @Returns:
1424
1425
1426 <!-- ##### FUNCTION gtk_widget_can_activate_accel ##### -->
1427 <para>
1428
1429 </para>
1430
1431 @widget:
1432 @signal_id:
1433 @Returns:
1434
1435
1436 <!-- ##### FUNCTION gtk_widget_event ##### -->
1437 <para>
1438
1439 </para>
1440
1441 @widget:
1442 @event:
1443 @Returns:
1444
1445
1446 <!-- ##### FUNCTION gtk_widget_activate ##### -->
1447 <para>
1448
1449 </para>
1450
1451 @widget:
1452 @Returns:
1453
1454
1455 <!-- ##### FUNCTION gtk_widget_reparent ##### -->
1456 <para>
1457
1458 </para>
1459
1460 @widget:
1461 @new_parent:
1462
1463
1464 <!-- ##### FUNCTION gtk_widget_intersect ##### -->
1465 <para>
1466
1467 </para>
1468
1469 @widget:
1470 @area:
1471 @intersection:
1472 @Returns:
1473
1474
1475 <!-- ##### FUNCTION gtk_widget_is_focus ##### -->
1476 <para>
1477
1478 </para>
1479
1480 @widget:
1481 @Returns:
1482
1483
1484 <!-- ##### FUNCTION gtk_widget_grab_focus ##### -->
1485 <para>
1486
1487 </para>
1488
1489 @widget:
1490
1491
1492 <!-- ##### FUNCTION gtk_widget_grab_default ##### -->
1493 <para>
1494
1495 </para>
1496
1497 @widget:
1498
1499
1500 <!-- ##### FUNCTION gtk_widget_set_name ##### -->
1501 <para>
1502
1503 </para>
1504
1505 @widget:
1506 @name:
1507
1508
1509 <!-- ##### FUNCTION gtk_widget_get_name ##### -->
1510 <para>
1511
1512 </para>
1513
1514 @widget:
1515 @Returns:
1516
1517
1518 <!-- ##### FUNCTION gtk_widget_set_state ##### -->
1519 <para>
1520
1521 </para>
1522
1523 @widget:
1524 @state:
1525
1526
1527 <!-- ##### FUNCTION gtk_widget_set_sensitive ##### -->
1528 <para>
1529
1530 </para>
1531
1532 @widget:
1533 @sensitive:
1534
1535
1536 <!-- ##### FUNCTION gtk_widget_set_parent ##### -->
1537 <para>
1538
1539 </para>
1540
1541 @widget:
1542 @parent:
1543
1544
1545 <!-- ##### FUNCTION gtk_widget_set_parent_window ##### -->
1546 <para>
1547
1548 </para>
1549
1550 @widget:
1551 @parent_window:
1552
1553
1554 <!-- ##### FUNCTION gtk_widget_get_parent_window ##### -->
1555 <para>
1556
1557 </para>
1558
1559 @widget:
1560 @Returns:
1561
1562
1563 <!-- ##### FUNCTION gtk_widget_set_uposition ##### -->
1564 <para>
1565
1566 </para>
1567
1568 @widget:
1569 @x:
1570 @y:
1571
1572
1573 <!-- ##### FUNCTION gtk_widget_set_usize ##### -->
1574 <para>
1575
1576 </para>
1577
1578 @widget:
1579 @width:
1580 @height:
1581
1582
1583 <!-- ##### FUNCTION gtk_widget_set_events ##### -->
1584 <para>
1585
1586 </para>
1587
1588 @widget:
1589 @events:
1590
1591
1592 <!-- ##### FUNCTION gtk_widget_add_events ##### -->
1593 <para>
1594
1595 </para>
1596
1597 @widget:
1598 @events:
1599
1600
1601 <!-- ##### FUNCTION gtk_widget_set_extension_events ##### -->
1602 <para>
1603
1604 </para>
1605
1606 @widget:
1607 @mode:
1608
1609
1610 <!-- ##### FUNCTION gtk_widget_get_extension_events ##### -->
1611 <para>
1612
1613 </para>
1614
1615 @widget:
1616 @Returns:
1617
1618
1619 <!-- ##### FUNCTION gtk_widget_get_toplevel ##### -->
1620 <para>
1621
1622 </para>
1623
1624 @widget:
1625 @Returns:
1626
1627
1628 <!-- ##### FUNCTION gtk_widget_get_ancestor ##### -->
1629 <para>
1630
1631 </para>
1632
1633 @widget:
1634 @widget_type:
1635 @Returns:
1636
1637
1638 <!-- ##### FUNCTION gtk_widget_get_colormap ##### -->
1639 <para>
1640
1641 </para>
1642
1643 @widget:
1644 @Returns:
1645
1646
1647 <!-- ##### FUNCTION gtk_widget_set_colormap ##### -->
1648 <para>
1649
1650 </para>
1651
1652 @widget:
1653 @colormap:
1654
1655
1656 <!-- ##### FUNCTION gtk_widget_get_visual ##### -->
1657 <para>
1658
1659 </para>
1660
1661 @widget:
1662 @Returns:
1663
1664
1665 <!-- ##### FUNCTION gtk_widget_get_events ##### -->
1666 <para>
1667
1668 </para>
1669
1670 @widget:
1671 @Returns:
1672
1673
1674 <!-- ##### FUNCTION gtk_widget_get_pointer ##### -->
1675 <para>
1676
1677 </para>
1678
1679 @widget:
1680 @x:
1681 @y:
1682
1683
1684 <!-- ##### FUNCTION gtk_widget_is_ancestor ##### -->
1685 <para>
1686
1687 </para>
1688
1689 @widget:
1690 @ancestor:
1691 @Returns:
1692
1693
1694 <!-- ##### FUNCTION gtk_widget_translate_coordinates ##### -->
1695 <para>
1696
1697 </para>
1698
1699 @src_widget:
1700 @dest_widget:
1701 @src_x:
1702 @src_y:
1703 @dest_x:
1704 @dest_y:
1705 @Returns:
1706
1707
1708 <!-- ##### FUNCTION gtk_widget_hide_on_delete ##### -->
1709 <para>
1710
1711 </para>
1712
1713 @widget:
1714 @Returns:
1715
1716
1717 <!-- ##### FUNCTION gtk_widget_set_style ##### -->
1718 <para>
1719
1720 </para>
1721
1722 @widget:
1723 @style:
1724
1725
1726 <!-- ##### MACRO gtk_widget_set_rc_style ##### -->
1727 <para>
1728 Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
1729 </para>
1730
1731 @widget: a #GtkWidget.
1732
1733
1734 <!-- ##### FUNCTION gtk_widget_ensure_style ##### -->
1735 <para>
1736
1737 </para>
1738
1739 @widget:
1740
1741
1742 <!-- ##### FUNCTION gtk_widget_get_style ##### -->
1743 <para>
1744
1745 </para>
1746
1747 @widget:
1748 @Returns:
1749
1750
1751 <!-- ##### MACRO gtk_widget_restore_default_style ##### -->
1752 <para>
1753 Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
1754 </para>
1755
1756 @widget: a #GtkWidget.
1757
1758
1759 <!-- ##### FUNCTION gtk_widget_reset_rc_styles ##### -->
1760 <para>
1761 Reset the styles of @widget and all descendents, so when
1762 they are looked up again, they get the correct values
1763 for the currently loaded RC file settings.
1764 </para>
1765 <para>
1766 This function is not useful for applications.
1767 </para>
1768
1769 @widget: a #GtkWidget.
1770
1771
1772 <!-- ##### FUNCTION gtk_widget_push_colormap ##### -->
1773 <para>
1774
1775 </para>
1776
1777 @cmap:
1778
1779
1780 <!-- ##### FUNCTION gtk_widget_pop_colormap ##### -->
1781 <para>
1782
1783 </para>
1784
1785
1786
1787 <!-- ##### FUNCTION gtk_widget_set_default_colormap ##### -->
1788 <para>
1789
1790 </para>
1791
1792 @colormap:
1793
1794
1795 <!-- ##### FUNCTION gtk_widget_get_default_style ##### -->
1796 <para>
1797
1798 </para>
1799
1800 @Returns:
1801
1802
1803 <!-- ##### FUNCTION gtk_widget_get_default_colormap ##### -->
1804 <para>
1805
1806 </para>
1807
1808 @Returns:
1809
1810
1811 <!-- ##### FUNCTION gtk_widget_get_default_visual ##### -->
1812 <para>
1813
1814 </para>
1815
1816 @Returns:
1817
1818
1819 <!-- ##### FUNCTION gtk_widget_set_direction ##### -->
1820 <para>
1821
1822 </para>
1823
1824 @widget:
1825 @dir:
1826
1827
1828 <!-- ##### ENUM GtkTextDirection ##### -->
1829 <para>
1830
1831 </para>
1832
1833 @GTK_TEXT_DIR_NONE:
1834 @GTK_TEXT_DIR_LTR:
1835 @GTK_TEXT_DIR_RTL:
1836
1837 <!-- ##### FUNCTION gtk_widget_get_direction ##### -->
1838 <para>
1839
1840 </para>
1841
1842 @widget:
1843 @Returns:
1844
1845
1846 <!-- ##### FUNCTION gtk_widget_set_default_direction ##### -->
1847 <para>
1848
1849 </para>
1850
1851 @dir:
1852
1853
1854 <!-- ##### FUNCTION gtk_widget_get_default_direction ##### -->
1855 <para>
1856
1857 </para>
1858
1859 @Returns:
1860
1861
1862 <!-- ##### FUNCTION gtk_widget_shape_combine_mask ##### -->
1863 <para>
1864
1865 </para>
1866
1867 @widget:
1868 @shape_mask:
1869 @offset_x:
1870 @offset_y:
1871
1872
1873 <!-- ##### FUNCTION gtk_widget_input_shape_combine_mask ##### -->
1874 <para>
1875
1876 </para>
1877
1878 @widget:
1879 @shape_mask:
1880 @offset_x:
1881 @offset_y:
1882
1883
1884 <!-- ##### FUNCTION gtk_widget_path ##### -->
1885 <para>
1886
1887 </para>
1888
1889 @widget:
1890 @path_length:
1891 @path:
1892 @path_reversed:
1893
1894
1895 <!-- ##### FUNCTION gtk_widget_class_path ##### -->
1896 <para>
1897
1898 </para>
1899
1900 @widget:
1901 @path_length:
1902 @path:
1903 @path_reversed:
1904
1905
1906 <!-- ##### FUNCTION gtk_widget_get_composite_name ##### -->
1907 <para>
1908
1909 </para>
1910
1911 @widget:
1912 @Returns:
1913
1914
1915 <!-- ##### FUNCTION gtk_widget_modify_style ##### -->
1916 <para>
1917
1918 </para>
1919
1920 @widget:
1921 @style:
1922
1923
1924 <!-- ##### FUNCTION gtk_widget_get_modifier_style ##### -->
1925 <para>
1926
1927 </para>
1928
1929 @widget:
1930 @Returns:
1931
1932
1933 <!-- ##### FUNCTION gtk_widget_modify_fg ##### -->
1934 <para>
1935
1936 </para>
1937
1938 @widget:
1939 @state:
1940 @color:
1941
1942
1943 <!-- ##### FUNCTION gtk_widget_modify_bg ##### -->
1944 <para>
1945
1946 </para>
1947
1948 @widget:
1949 @state:
1950 @color:
1951
1952
1953 <!-- ##### FUNCTION gtk_widget_modify_text ##### -->
1954 <para>
1955
1956 </para>
1957
1958 @widget:
1959 @state:
1960 @color:
1961
1962
1963 <!-- ##### FUNCTION gtk_widget_modify_base ##### -->
1964 <para>
1965
1966 </para>
1967
1968 @widget:
1969 @state:
1970 @color:
1971
1972
1973 <!-- ##### FUNCTION gtk_widget_modify_font ##### -->
1974 <para>
1975
1976 </para>
1977
1978 @widget:
1979 @font_desc:
1980
1981
1982 <!-- ##### FUNCTION gtk_widget_create_pango_context ##### -->
1983 <para>
1984
1985 </para>
1986
1987 @widget:
1988 @Returns:
1989
1990
1991 <!-- ##### FUNCTION gtk_widget_get_pango_context ##### -->
1992 <para>
1993
1994 </para>
1995
1996 @widget:
1997 @Returns:
1998
1999
2000 <!-- ##### FUNCTION gtk_widget_create_pango_layout ##### -->
2001 <para>
2002
2003 </para>
2004
2005 @widget:
2006 @text:
2007 @Returns:
2008
2009
2010 <!-- ##### FUNCTION gtk_widget_render_icon ##### -->
2011 <para>
2012
2013 </para>
2014
2015 @widget:
2016 @stock_id:
2017 @size:
2018 @detail:
2019 @Returns:
2020
2021
2022 <!-- ##### FUNCTION gtk_widget_pop_composite_child ##### -->
2023 <para>
2024
2025 </para>
2026
2027
2028
2029 <!-- ##### FUNCTION gtk_widget_push_composite_child ##### -->
2030 <para>
2031
2032 </para>
2033
2034
2035
2036 <!-- ##### FUNCTION gtk_widget_queue_clear ##### -->
2037 <para>
2038
2039 </para>
2040
2041 @widget:
2042
2043
2044 <!-- ##### FUNCTION gtk_widget_queue_clear_area ##### -->
2045 <para>
2046
2047 </para>
2048
2049 @widget:
2050 @x:
2051 @y:
2052 @width:
2053 @height:
2054
2055
2056 <!-- ##### FUNCTION gtk_widget_queue_draw_area ##### -->
2057 <para>
2058
2059 </para>
2060
2061 @widget:
2062 @x:
2063 @y:
2064 @width:
2065 @height:
2066
2067
2068 <!-- ##### FUNCTION gtk_widget_reset_shapes ##### -->
2069 <para>
2070
2071 </para>
2072
2073 @widget:
2074
2075
2076 <!-- ##### FUNCTION gtk_widget_set_app_paintable ##### -->
2077 <para>
2078
2079 </para>
2080
2081 @widget:
2082 @app_paintable:
2083
2084
2085 <!-- ##### FUNCTION gtk_widget_set_double_buffered ##### -->
2086 <para>
2087
2088 </para>
2089
2090 @widget:
2091 @double_buffered:
2092
2093
2094 <!-- ##### FUNCTION gtk_widget_set_redraw_on_allocate ##### -->
2095 <para>
2096
2097 </para>
2098
2099 @widget:
2100 @redraw_on_allocate:
2101
2102
2103 <!-- ##### FUNCTION gtk_widget_set_composite_name ##### -->
2104 <para>
2105
2106 </para>
2107
2108 @widget:
2109 @name:
2110
2111
2112 <!-- ##### FUNCTION gtk_widget_set_scroll_adjustments ##### -->
2113 <para>
2114
2115 </para>
2116
2117 @widget:
2118 @hadjustment:
2119 @vadjustment:
2120 @Returns:
2121
2122
2123 <!-- ##### FUNCTION gtk_widget_mnemonic_activate ##### -->
2124 <para>
2125
2126 </para>
2127
2128 @widget:
2129 @group_cycling:
2130 @Returns:
2131
2132
2133 <!-- ##### FUNCTION gtk_widget_class_install_style_property ##### -->
2134 <para>
2135
2136 </para>
2137
2138 @klass:
2139 @pspec:
2140
2141
2142 <!-- ##### FUNCTION gtk_widget_class_install_style_property_parser ##### -->
2143 <para>
2144
2145 </para>
2146
2147 @klass:
2148 @pspec:
2149 @parser:
2150
2151
2152 <!-- ##### FUNCTION gtk_widget_class_find_style_property ##### -->
2153 <para>
2154
2155 </para>
2156
2157 @klass:
2158 @property_name:
2159 @Returns:
2160
2161
2162 <!-- ##### FUNCTION gtk_widget_class_list_style_properties ##### -->
2163 <para>
2164
2165 </para>
2166
2167 @klass:
2168 @n_properties:
2169 @Returns:
2170
2171
2172 <!-- ##### FUNCTION gtk_widget_region_intersect ##### -->
2173 <para>
2174
2175 </para>
2176
2177 @widget:
2178 @region:
2179 @Returns:
2180
2181
2182 <!-- ##### FUNCTION gtk_widget_send_expose ##### -->
2183 <para>
2184
2185 </para>
2186
2187 @widget:
2188 @event:
2189 @Returns:
2190
2191
2192 <!-- ##### FUNCTION gtk_widget_style_get ##### -->
2193 <para>
2194
2195 </para>
2196
2197 @widget:
2198 @first_property_name:
2199 @Varargs:
2200
2201
2202 <!-- ##### FUNCTION gtk_widget_style_get_property ##### -->
2203 <para>
2204
2205 </para>
2206
2207 @widget:
2208 @property_name:
2209 @value:
2210
2211
2212 <!-- ##### FUNCTION gtk_widget_style_get_valist ##### -->
2213 <para>
2214
2215 </para>
2216
2217 @widget:
2218 @first_property_name:
2219 @var_args:
2220
2221
2222 <!-- ##### FUNCTION gtk_widget_get_accessible ##### -->
2223 <para>
2224
2225 </para>
2226
2227 @widget:
2228 @Returns:
2229
2230
2231 <!-- ##### FUNCTION gtk_widget_child_focus ##### -->
2232 <para>
2233
2234 </para>
2235
2236 @widget:
2237 @direction:
2238 @Returns:
2239
2240
2241 <!-- ##### FUNCTION gtk_widget_child_notify ##### -->
2242 <para>
2243
2244 </para>
2245
2246 @widget:
2247 @child_property:
2248
2249
2250 <!-- ##### FUNCTION gtk_widget_freeze_child_notify ##### -->
2251 <para>
2252
2253 </para>
2254
2255 @widget:
2256
2257
2258 <!-- ##### FUNCTION gtk_widget_get_child_visible ##### -->
2259 <para>
2260
2261 </para>
2262
2263 @widget:
2264 @Returns:
2265
2266
2267 <!-- ##### FUNCTION gtk_widget_get_parent ##### -->
2268 <para>
2269
2270 </para>
2271
2272 @widget:
2273 @Returns:
2274
2275
2276 <!-- ##### FUNCTION gtk_widget_get_settings ##### -->
2277 <para>
2278
2279 </para>
2280
2281 @widget:
2282 @Returns:
2283
2284
2285 <!-- ##### FUNCTION gtk_widget_get_clipboard ##### -->
2286 <para>
2287
2288 </para>
2289
2290 @widget:
2291 @selection:
2292 @Returns:
2293
2294
2295 <!-- ##### FUNCTION gtk_widget_get_display ##### -->
2296 <para>
2297
2298 </para>
2299
2300 @widget:
2301 @Returns:
2302
2303
2304 <!-- ##### FUNCTION gtk_widget_get_root_window ##### -->
2305 <para>
2306
2307 </para>
2308
2309 @widget:
2310 @Returns:
2311
2312
2313 <!-- ##### FUNCTION gtk_widget_get_screen ##### -->
2314 <para>
2315
2316 </para>
2317
2318 @widget:
2319 @Returns:
2320
2321
2322 <!-- ##### FUNCTION gtk_widget_has_screen ##### -->
2323 <para>
2324
2325 </para>
2326
2327 @widget:
2328 @Returns:
2329
2330
2331 <!-- ##### FUNCTION gtk_widget_get_size_request ##### -->
2332 <para>
2333
2334 </para>
2335
2336 @widget:
2337 @width:
2338 @height:
2339
2340
2341 <!-- ##### MACRO gtk_widget_pop_visual ##### -->
2342 <para>
2343 This function is deprecated; it does nothing.
2344 </para>
2345
2346
2347
2348 <!-- ##### MACRO gtk_widget_push_visual ##### -->
2349 <para>
2350 This function is deprecated; it does nothing.
2351 </para>
2352
2353 @visual:
2354
2355
2356 <!-- ##### FUNCTION gtk_widget_set_child_visible ##### -->
2357 <para>
2358
2359 </para>
2360
2361 @widget:
2362 @is_visible:
2363
2364
2365 <!-- ##### MACRO gtk_widget_set_default_visual ##### -->
2366 <para>
2367 This function is deprecated; it does nothing.
2368 </para>
2369
2370 @visual:
2371
2372
2373 <!-- ##### FUNCTION gtk_widget_set_size_request ##### -->
2374 <para>
2375
2376 </para>
2377
2378 @widget:
2379 @width:
2380 @height:
2381
2382
2383 <!-- ##### MACRO gtk_widget_set_visual ##### -->
2384 <para>
2385 This function is deprecated; it does nothing.
2386 </para>
2387
2388 @widget:
2389 @visual:
2390
2391
2392 <!-- ##### FUNCTION gtk_widget_thaw_child_notify ##### -->
2393 <para>
2394
2395 </para>
2396
2397 @widget:
2398
2399
2400 <!-- ##### FUNCTION gtk_widget_set_no_show_all ##### -->
2401 <para>
2402
2403 </para>
2404
2405 @widget:
2406 @no_show_all:
2407
2408
2409 <!-- ##### FUNCTION gtk_widget_get_no_show_all ##### -->
2410 <para>
2411
2412 </para>
2413
2414 @widget:
2415 @Returns:
2416
2417
2418 <!-- ##### FUNCTION gtk_widget_list_mnemonic_labels ##### -->
2419 <para>
2420
2421 </para>
2422
2423 @widget:
2424 @Returns:
2425
2426
2427 <!-- ##### FUNCTION gtk_widget_add_mnemonic_label ##### -->
2428 <para>
2429
2430 </para>
2431
2432 @widget:
2433 @label:
2434
2435
2436 <!-- ##### FUNCTION gtk_widget_remove_mnemonic_label ##### -->
2437 <para>
2438
2439 </para>
2440
2441 @widget:
2442 @label:
2443
2444
2445 <!-- ##### FUNCTION gtk_widget_get_action ##### -->
2446 <para>
2447
2448 </para>
2449
2450 @widget:
2451 @Returns:
2452
2453
2454 <!-- ##### FUNCTION gtk_widget_is_composited ##### -->
2455 <para>
2456
2457 </para>
2458
2459 @widget:
2460 @Returns:
2461
2462
2463 <!-- ##### FUNCTION gtk_widget_error_bell ##### -->
2464 <para>
2465
2466 </para>
2467
2468 @widget:
2469
2470
2471 <!-- ##### FUNCTION gtk_widget_keynav_failed ##### -->
2472 <para>
2473
2474 </para>
2475
2476 @widget:
2477 @direction:
2478 @Returns:
2479
2480
2481 <!-- ##### FUNCTION gtk_widget_get_tooltip_window ##### -->
2482 <para>
2483
2484 </para>
2485
2486 @widget:
2487 @Returns:
2488
2489
2490 <!-- ##### FUNCTION gtk_widget_set_tooltip_window ##### -->
2491 <para>
2492
2493 </para>
2494
2495 @widget:
2496 @custom_window:
2497
2498
2499 <!-- ##### FUNCTION gtk_widget_trigger_tooltip_query ##### -->
2500 <para>
2501
2502 </para>
2503
2504 @widget:
2505
2506
2507 <!-- ##### FUNCTION gtk_requisition_copy ##### -->
2508 <para>
2509
2510 </para>
2511
2512 @requisition:
2513 @Returns:
2514
2515
2516 <!-- ##### FUNCTION gtk_requisition_free ##### -->
2517 <para>
2518
2519 </para>
2520
2521 @requisition:
2522
2523