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

   1 <!-- ##### SECTION ./tmpl/gtkdata.sgml:Long_Description ##### -->
   2 <para>
   3 The #GtkData object is a very simple object intended to be used as a base
   4 class for objects which contain data (i.e. the 'Model' in the object-oriented
   5 Model/View/Controller framework).
   6 </para>
   7 <para>
   8 Currently it is not very useful since all it provides is a "disconnect" signal.
   9 This signal could be emitted by a #GtkData subclass to notify any 'Views'
  10 that they should disconnect from the #GtkData (the 'Model'), possibly just
  11 before the #GtkData is destroyed.
  12 </para>
  13
  14
  15 <!-- ##### SECTION ./tmpl/gtkdata.sgml:See_Also ##### -->
  16 <para>
  17
  18 </para>
  19
  20
  21 <!-- ##### SECTION ./tmpl/gtkdata.sgml:Short_Description ##### -->
  22 abstract base class for objects containing data.
  23
  24
  25 <!-- ##### SECTION ./tmpl/gtkdata.sgml:Title ##### -->
  26 GtkData
  27
  28
  29 <!-- ##### SECTION ./tmpl/gtkdebug.sgml:Title ##### -->
  30 Debugging
  31
  32
  33 <!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Title ##### -->
  34 gtkenums.sgml
  35
  36
  37 <!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Title ##### -->
  38 GtkIMContextSimple
  39
  40
  41 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Long_Description ##### -->
  42 <refsect2>
  43 <title>What are Signal Marshallers?</title>
  44 <para>
  45 Marshals are functions which all have the same prototype:
  46 they take a #GtkObject, a #GtkSignalFunc, a #gpointer,
  47 and an array of argument values.
  48 The functions are names gtk_marshall_RETURNTYPE__PARAMTYPE1_PARAMTYPE2....
  49 </para>
  50 <para>
  51 They then call a native function:  the GtkObject is the first
  52 parameter passed in.  The arguments are passed in the native
  53 calling convention:  chars, shorts, ints, longs may be packed
  54 on the stack, or tucked in registers:  it doesn't matter
  55 because the same calling convention will be generated
  56 inside the gtkmarshal code as is expected where you define
  57 your handlers.
  58 </para>
  59 <para>
  60 So the function named:
  61 <programlisting>
  62 gtk_marshal_BOOL__POINTER_INT_INT_UINT(GtkObject*, GtkSignalFunc, gpointer, GtkArg*);
  63 </programlisting>
  64 will call the #GtkSignalFunc assuming it was a function with signature:
  65 <programlisting>
  66 gboolean sigfunc(gpointer,gint,gint,guint);
  67 </programlisting>
  68 </para>
  69 </refsect2>
  70 <refsect2>
  71 <title>Writing Custom Marshals</title>
  72 <para>
  73 Marshals are primarily used as arguments to gtk_signal_new().
  74 Sometimes, you may find that a marshaller you need isn't available
  75 in the standard list.  Then you have to write your own.
  76 </para>
  77 <para>
  78 If you wish to define a signal with a new type of argument list.
  79 Suppose you want 2 pointers and 2 integers.
  80 You would write:
  81 <programlisting>
  82 typedef int (*GtkSignal_INT__POINTER_POINTER_INT_INT)(
  83                         gpointer, gpointer, gint, gint
  84 );
  85
  86 void marshal_INT__POINTER_POINTER_INT_INT(GtkObject*    object,
  87                                            GtkSignalFunc func,
  88                                            gpointer      func_data,
  89                                            GtkArg*       args)
  90 {
  91         GtkSignal_NONE__POINTER_POINTER_INT_INT rfunc;
  92         gint* return_val;
  93         return_val = GTK_RETLOC_INT(args[4]);
  94         rfunc = (GtkSignal_INT__POINTER_POINTER_INT_INT)func;
  95         *return_val = (*rfunc)(object,
  96                                GTK_VALUE_POINTER(args[0]),
  97                                GTK_VALUE_POINTER(args[1]),
  98                                GTK_VALUE_INT(args[2]),
  99                                GTK_VALUE_INT(args[3]),
 100                                func_data);
 101 }
 102 </programlisting>
 103 </para>
 104 </refsect2>
 105
 106
 107 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:See_Also ##### -->
 108 <para>
 109 <variablelist>
 110
 111 <varlistentry>
 112 <term>#GtkSignal</term>
 113 <listitem><para>The signal handling functions (of which marshallers are
 114 really an implementation detail).</para></listitem>
 115 </varlistentry>
 116
 117 </variablelist>
 118 </para>
 119
 120
 121 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Short_Description ##### -->
 122 Functions to adapt C structures to native calling convention.
 123
 124
 125 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Title ##### -->
 126 Signal Marshallers
 127
 128
 129 <!-- ##### SECTION ./tmpl/gtkprivate.sgml:Title ##### -->
 130 Private Information
 131
 132
 133 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Long_Description ##### -->
 134 <para>
 135
 136 </para>
 137
 138
 139 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:See_Also ##### -->
 140 <para>
 141
 142 </para>
 143
 144
 145 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Short_Description ##### -->
 146
 147
 148
 149 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Title ##### -->
 150 GtkModelSimple
 151
 152
 153 <!-- ##### MACRO GTK_CLIST_CHILD_HAS_FOCUS ##### -->
 154 <para>
 155 A macro to check whether a child widget of the CList
 156 has the focus.
 157 </para>
 158
 159 @clist: The #GtkCList widget to check.
 160
 161 <!-- ##### MACRO GTK_ICON_SIZE_BUTTON ##### -->
 162 <para>
 163
 164 </para>
 165
 166
 167 <!-- ##### MACRO GTK_ICON_SIZE_DIALOG ##### -->
 168 <para>
 169
 170 </para>
 171
 172
 173 <!-- ##### MACRO GTK_ICON_SIZE_LARGE_TOOLBAR ##### -->
 174 <para>
 175
 176 </para>
 177
 178
 179 <!-- ##### MACRO GTK_ICON_SIZE_MENU ##### -->
 180 <para>
 181
 182 </para>
 183
 184
 185 <!-- ##### MACRO GTK_ICON_SIZE_SMALL_TOOLBAR ##### -->
 186 <para>
 187
 188 </para>
 189
 190
 191 <!-- ##### MACRO GTK_OBJECT_CONSTRUCTED ##### -->
 192 <para>
 193 Test whether a GtkObject's arguments have been prepared.
 194 </para>
 195
 196 @obj: the object to examine.
 197
 198 <!-- ##### MACRO GTK_OBJECT_NSIGNALS ##### -->
 199 <para>
 200 Get the number of signals defined by this object.
 201 </para>
 202
 203 @obj: the object to query.
 204
 205 <!-- ##### MACRO GTK_OBJECT_SIGNALS ##### -->
 206 <para>
 207 Get the array of signals defined for this object.
 208 </para>
 209
 210 @obj: the object to fetch the signals from.
 211
 212 <!-- ##### MACRO GTK_TREE_SELECTION ##### -->
 213 <para>
 214 A macro that returns a GList that contains the selection of the root tree of @obj.
 215 </para>
 216
 217 @obj: A pointer to the #GtkTree. @obj will accept any pointer, but it the pointer does not point to a #GtkTree, the results are undefined.
 218
 219 <!-- ##### MACRO GTK_TYPE_FLAT_FIRST ##### -->
 220 <para>
 221 The first "flat" (no struct) enumerated type value.
 222 </para>
 223
 224
 225 <!-- ##### MACRO GTK_TYPE_FLAT_LAST ##### -->
 226 <para>
 227 The last "flat" (no struct) enumerated type value.
 228 </para>
 229
 230
 231 <!-- ##### MACRO GTK_TYPE_IDENTIFIER ##### -->
 232 <para>
 233 Hide the name of gtk_identifier_get_type
 234 </para>
 235
 236
 237 <!-- ##### MACRO GTK_TYPE_MAKE ##### -->
 238 <para>
 239 Combine a fundemantal type and a sequence number to create a gtk type.
 240 </para>
 241
 242 @parent_t:
 243 @seqno:
 244
 245 <!-- ##### MACRO GTK_TYPE_NUM_BUILTINS ##### -->
 246 <para>
 247 No idea.
 248 </para>
 249
 250
 251 <!-- ##### MACRO GTK_TYPE_SEQNO ##### -->
 252 <para>
 253 Convert a gtk type into its sequence number
 254 </para>
 255
 256 @type:
 257
 258 <!-- ##### MACRO GTK_TYPE_STRUCTURED_FIRST ##### -->
 259 <para>
 260 The first structured enumerated type value.
 261 </para>
 262
 263
 264 <!-- ##### MACRO GTK_TYPE_STRUCTURED_LAST ##### -->
 265 <para>
 266 The last structured enumerated type value.
 267 </para>
 268
 269
 270 <!-- ##### MACRO GTK_TYPE_TREE_COLUMN ##### -->
 271 <para>
 272
 273 </para>
 274
 275
 276 <!-- ##### MACRO GTK_VALUE_ARGS ##### -->
 277 <para>
 278 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS
 279 </para>
 280
 281 @a:
 282
 283 <!-- ##### MACRO GTK_VALUE_CALLBACK ##### -->
 284 <para>
 285 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK
 286 </para>
 287
 288 @a:
 289
 290 <!-- ##### MACRO GTK_VALUE_C_CALLBACK ##### -->
 291 <para>
 292 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK
 293 </para>
 294
 295 @a:
 296
 297 <!-- ##### MACRO GTK_VALUE_FOREIGN ##### -->
 298 <para>
 299 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
 300 </para>
 301
 302 @a:
 303
 304 <!-- ##### STRUCT GtkData ##### -->
 305 <para>
 306 The #GtkData-struct struct contains no public fields.
 307 </para>
 308
 309
 310 <!-- ##### SIGNAL GtkData::disconnect ##### -->
 311 <para>
 312 Emitted to notify any views on the #GtkData object to disconnect from it,
 313 possibly because the #GtkData object is about to be destroyed.
 314 </para>
 315
 316 @data: the object which received the signal.
 317
 318 <!-- ##### SIGNAL GtkEditable::activate ##### -->
 319 <para>
 320 Indicates that the user has activated the widget
 321 in some fashion. Generally, this will be done
 322 with a keystroke. (The default binding for this
 323 action is Return for #GtkEntry and
 324 Control-Return for #GtkText.)
 325 </para>
 326
 327 @editable: the object which received the signal.
 328
 329 <!-- ##### SIGNAL GtkEditable::changed ##### -->
 330 <para>
 331 Indicates that the user has changed the contents
 332 of the widget.
 333 </para>
 334
 335 @editable: the object which received the signal.
 336
 337 <!-- ##### SIGNAL GtkEditable::copy-clipboard ##### -->
 338 <para>
 339 An action signal. Causes the characters in the current selection to
 340 be copied to the clipboard.
 341 </para>
 342
 343 @editable: the object which received the signal.
 344
 345 <!-- ##### SIGNAL GtkEditable::cut-clipboard ##### -->
 346 <para>
 347 An action signal. Causes the characters in the current
 348 selection to be copied to the clipboard and then deleted from
 349 the widget.
 350 </para>
 351
 352 @editable: the object which received the signal.
 353
 354 <!-- ##### SIGNAL GtkEditable::delete-text ##### -->
 355 <para>
 356 This signal is emitted when text is deleted from
 357 the widget by the user. The default handler for
 358 this signal will normally be responsible for inserting
 359 the text, so by connecting to this signal and then
 360 stopping the signal with gtk_signal_emit_stop(), it
 361 is possible to modify the inserted text, or prevent
 362 it from being inserted entirely. The @start_pos
 363 and @end_pos parameters are interpreted as for
 364 gtk_editable_delete_text()
 365 </para>
 366
 367 @editable: the object which received the signal.
 368 @start_pos: the starting position.
 369 @end_pos: the end position.
 370
 371 <!-- ##### SIGNAL GtkEditable::insert-text ##### -->
 372 <para>
 373 This signal is emitted when text is inserted into
 374 the widget by the user. The default handler for
 375 this signal will normally be responsible for inserting
 376 the text, so by connecting to this signal and then
 377 stopping the signal with gtk_signal_emit_stop(), it
 378 is possible to modify the inserted text, or prevent
 379 it from being inserted entirely.
 380 </para>
 381
 382 @editable: the object which received the signal.
 383 @new_text: the new text to insert.
 384 @new_text_length: the length of the new text.
 385 @position: the position at which to insert the new text.
 386            this is an in-out paramter. After the signal
 387            emission is finished, it should point after
 388            the newly inserted text.
 389
 390 <!-- ##### SIGNAL GtkEditable::kill-char ##### -->
 391 <para>
 392 An action signal. Delete a single character.
 393 </para>
 394
 395 @editable: the object which received the signal.
 396 @direction: the direction in which to delete. Positive
 397    indicates forward deletion, negative, backwards deletion.
 398
 399 <!-- ##### SIGNAL GtkEditable::kill-line ##### -->
 400 <para>
 401 An action signal. Delete a single line.
 402 </para>
 403
 404 @editable: the object which received the signal.
 405 @direction: the direction in which to delete. Positive
 406    indicates forward deletion, negative, backwards deletion.
 407
 408 <!-- ##### SIGNAL GtkEditable::kill-word ##### -->
 409 <para>
 410 An action signal. Delete a single word.
 411 </para>
 412
 413 @editable: the object which received the signal.
 414 @direction: the direction in which to delete. Positive
 415    indicates forward deletion, negative, backwards deletion.
 416
 417 <!-- ##### SIGNAL GtkEditable::move-cursor ##### -->
 418 <para>
 419 An action signal. Move the cursor position.
 420 </para>
 421
 422 @editable: the object which received the signal.
 423 @x: horizontal distance to move the cursor.
 424 @y: vertical distance to move the cursor.
 425
 426 <!-- ##### SIGNAL GtkEditable::move-page ##### -->
 427 <para>
 428 An action signal. Move the cursor by pages.
 429 </para>
 430
 431 @editable: the object which received the signal.
 432 @x: Number of pages to move the cursor horizontally.
 433 @y: Number of pages to move the cursor vertically.
 434
 435 <!-- ##### SIGNAL GtkEditable::move-to-column ##### -->
 436 <para>
 437 An action signal. Move the cursor to the given column.
 438 </para>
 439
 440 @editable: the object which received the signal.
 441 @column: the column to move to. (A negative value indicates
 442          the last column)
 443
 444 <!-- ##### SIGNAL GtkEditable::move-to-row ##### -->
 445 <para>
 446 An action signal. Move the cursor to the given row.
 447 </para>
 448
 449 @editable: the object which received the signal.
 450 @row: the row to move to. (A negative value indicates
 451       the last row)
 452
 453 <!-- ##### SIGNAL GtkEditable::move-word ##### -->
 454 <para>
 455 An action signal. Move the cursor by words.
 456 </para>
 457
 458 @editable: the object which received the signal.
 459 @num_words: The number of words to move the
 460 cursor. (Can be negative).
 461
 462 <!-- ##### SIGNAL GtkEditable::paste-clipboard ##### -->
 463 <para>
 464 An action signal. Causes the contents of the clipboard to
 465 be pasted into the editable widget at the current cursor
 466 position.
 467 </para>
 468
 469 @editable: the object which received the signal.
 470
 471 <!-- ##### SIGNAL GtkEditable::set-editable ##### -->
 472 <para>
 473 Determines if the user can edit the text in the editable
 474 widget or not. This is meant to be overriden by
 475 child classes and should not generally useful to
 476 applications.
 477 </para>
 478
 479 @editable: the object which received the signal.
 480 @is_editable: %TRUE if the user is allowed to edit the text
 481   in the widget.
 482
 483 <!-- ##### ARG GtkEditable:editable ##### -->
 484 <para>
 485 A boolean indicating whether the widget is editable by
 486 the user.
 487 </para>
 488
 489
 490 <!-- ##### ARG GtkEditable:text-position ##### -->
 491 <para>
 492 The position of the cursor.
 493 </para>
 494
 495
 496 <!-- ##### USER_FUNCTION GtkEmissionHook ##### -->
 497 <para>
 498 A simple function pointer to get invoked when the
 499 signal is emitted.  This allows you tie a hook to the signal type,
 500 so that it will trap all emissions of that signal, from any object.
 501 </para>
 502 <para>
 503 You may not attach these to signals created with the
 504 #GTK_RUN_NO_HOOKS flag.
 505 </para>
 506
 507 @object:
 508 @signal_id:
 509 @n_params:
 510 @params:
 511 @data:
 512 @Returns:
 513
 514 <!-- ##### ENUM GtkFontFilterType ##### -->
 515 <para>
 516 A set of bit flags used to specify the filter being set
 517 when calling gtk_font_selection_dialog_set_filter() or
 518 gtk_font_selection_set_filter().
 519 </para>
 520
 521 @GTK_FONT_FILTER_BASE: the base filter, which can't be changed by the user.
 522 @GTK_FONT_FILTER_USER: the user filter, which can be changed from within the
 523 'Filter' page of the #GtkFontSelection widget.
 524
 525 <!-- ##### ENUM GtkFontType ##### -->
 526 <para>
 527 A set of bit flags used to specify the type of fonts shown
 528 when calling gtk_font_selection_dialog_set_filter() or
 529 gtk_font_selection_set_filter().
 530 </para>
 531
 532 @GTK_FONT_BITMAP: bitmap fonts.
 533 @GTK_FONT_SCALABLE: scalable fonts.
 534 @GTK_FONT_SCALABLE_BITMAP: scaled bitmap fonts.
 535 @GTK_FONT_ALL: a bitwise combination of all of the above.
 536
 537 <!-- ##### ARG GtkFrame:shadow-type ##### -->
 538 <para>
 539
 540 </para>
 541
 542
 543 <!-- ##### STRUCT GtkIMContextSimple ##### -->
 544 <para>
 545
 546 </para>
 547
 548 @object:
 549 @tables:
 550 @compose_buffer:
 551 @tentative_match:
 552 @tentative_match_len:
 553
 554 <!-- ##### ARG GtkLabel:accel-keyval ##### -->
 555 <para>
 556
 557 </para>
 558
 559
 560 <!-- ##### ARG GtkObject:object-signal ##### -->
 561 <para>
 562 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
 563 the signal to the object, so that the user data and objects
 564 and swapped when the signal handler is invoked.
 565 </para>
 566 <para>
 567 This is useful for handlers that are primarily notifying
 568 other objects and could just invoke an already existing function
 569 if the parameters were swapped.
 570 See gtk_signal_connect_object() for more details.
 571 </para>
 572
 573
 574 <!-- ##### ARG GtkObject:object-signal-after ##### -->
 575 <para>
 576 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
 577 the signal to the object, so that the user data and objects
 578 and swapped when the signal handler is invoked,
 579 and so that the handler is invoked after all others.
 580 </para>
 581 <para>
 582 See gtk_signal_connect_object_after() for more details.
 583 </para>
 584
 585
 586 <!-- ##### ARG GtkObject:signal ##### -->
 587 <para>
 588 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
 589 the signal to the object.
 590 </para>
 591
 592
 593 <!-- ##### ARG GtkObject:signal-after ##### -->
 594 <para>
 595 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
 596 the signal to the object, so that the signal is always run
 597 after other user handlers and the default handler.
 598 </para>
 599
 600
 601 <!-- ##### ARG GtkPaned:handle-size ##### -->
 602 <para>
 603
 604 </para>
 605
 606
 607 <!-- ##### STRUCT GtkPatternSpec ##### -->
 608 <para>
 609
 610 </para>
 611
 612 @match_type:
 613 @pattern_length:
 614 @pattern:
 615 @pattern_reversed:
 616 @user_data:
 617 @seq_id:
 618
 619 <!-- ##### ENUM GtkPrivateFlags ##### -->
 620 <para>
 621
 622 </para>
 623
 624 @PRIVATE_GTK_USER_STYLE:
 625 @PRIVATE_GTK_RESIZE_PENDING:
 626 @PRIVATE_GTK_RESIZE_NEEDED:
 627 @PRIVATE_GTK_LEAVE_PENDING:
 628 @PRIVATE_GTK_HAS_SHAPE_MASK:
 629 @PRIVATE_GTK_IN_REPARENT:
 630 @PRIVATE_GTK_DIRECTION_SET:
 631 @PRIVATE_GTK_DIRECTION_LTR:
 632
 633 <!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
 634 <para>
 635 A function which you can use to clean up when the
 636 signal handler is destroyed.
 637 </para>
 638 <para>
 639 For example, if your handler requires a few variables
 640 that you made into a struct and allocated (using g_new()
 641 or something), then you will probably want to free
 642 it as soon as the hook is destroyed.  This will
 643 allow you to do that. (For this in particular
 644 it is convenient to pass g_free() as a #GtkSignalDestroy
 645 function).
 646 </para>
 647
 648 @data: The user data associated with the hook that is being
 649 destroyed.
 650
 651 <!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
 652 <para>
 653 This is currently a hack left in for a scheme wrapper library.
 654 It may be removed.
 655 </para>
 656 <para>
 657 Don't use it.
 658 </para>
 659
 660 @object: The object which emits the signal.
 661 @data: The user data associated with the hook.
 662 @nparams: The number of parameters to the function.
 663 @args: The actual values of the arguments.
 664 @arg_types: The types of the arguments.
 665 @return_type: The type of the return value from the function
 666 or #GTK_TYPE_NONE for no return value.
 667
 668 <!-- ##### STRUCT GtkSignalQuery ##### -->
 669 <para>
 670 This structure contains all the information about a particular
 671 signal:  its name, the type it affects, the signature of the handlers,
 672 and its unique identifying integer.
 673 </para>
 674
 675 @object_type:
 676 @signal_id:
 677 @signal_name:
 678 @is_user_signal:
 679 @signal_flags:
 680 @return_val:
 681 @nparams:
 682 @params:
 683
 684 <!-- ##### ARG GtkSpinButton:shadow-type ##### -->
 685 <para>
 686 the type of border that surrounds the arrows of a spin button.
 687 </para>
 688
 689
 690 <!-- ##### STRUCT GtkStatusbarMsg ##### -->
 691 <para>
 692 Holds the data for a statusbar message. <structfield>text</structfield> holds the actual text string. <structfield>context_id</structfield> is the context that this message is associated with, and <structfield>message_id</structfield> is this particular message's identifier. However, these fields should not be modified directly.
 693 </para>
 694
 695 @text:
 696 @context_id:
 697 @message_id:
 698
 699 <!-- ##### ARG GtkTextTag:justify ##### -->
 700 <para>
 701 A #GtkJustification for the text. This is only used when the tag is
 702 applied to the first character in a paragraph.
 703 </para>
 704
 705
 706 <!-- ##### ARG GtkTextTag:left-wrapped-line-margin ##### -->
 707 <para>
 708 Pixel width of the left margin of the text for lines after the first
 709 line in a wrapped paragraph.
 710 </para>
 711
 712
 713 <!-- ##### ARG GtkTextTag:left-wrapped-line-margin-set ##### -->
 714 <para>
 715
 716 </para>
 717
 718
 719 <!-- ##### ARG GtkTextTag:offset ##### -->
 720 <para>
 721 Pixels to offset the text horizontally or vertically, useful to
 722 produce superscript and subscript.
 723 </para>
 724
 725
 726 <!-- ##### ARG GtkTextView:justify ##### -->
 727 <para>
 728
 729 </para>
 730
 731
 732 <!-- ##### ARG GtkTextView:wrap-mode ##### -->
 733 <para>
 734
 735 </para>
 736
 737
 738 <!-- ##### SIGNAL GtkWidget::activate-mnemonic ##### -->
 739 <para>
 740
 741 </para>
 742
 743 @widget: the object which received the signal.
 744 @arg1:
 745 @Returns:
 746
 747 <!-- ##### SIGNAL GtkWidget::debug-msg ##### -->
 748 <para>
 749
 750 </para>
 751
 752 @widget: the object which received the signal.
 753 @message:
 754
 755 <!-- ##### SIGNAL GtkWidget::draw ##### -->
 756 <para>
 757
 758 </para>
 759
 760 @widget: the object which received the signal.
 761 @area:
 762
 763 <!-- ##### SIGNAL GtkWidget::draw-default ##### -->
 764 <para>
 765
 766 </para>
 767
 768 @widget: the object which received the signal.
 769
 770 <!-- ##### SIGNAL GtkWidget::draw-focus ##### -->
 771 <para>
 772
 773 </para>
 774
 775 @widget: the object which received the signal.
 776
 777 <!-- ##### FUNCTION gtk_button_box_child_requisition ##### -->
 778 <para>\r
 779 This is an internally used function and should never be called from an\r
 780 application.\r
 781 </para>
 782
 783 @widget:
 784 @nvis_children:
 785 @width:
 786 @height:
 787
 788 <!-- ##### FUNCTION gtk_button_box_get_child_ipadding_default ##### -->
 789 <para>\r
 790 The internal padding of a button is the amount of space between the outside\r
 791 of the button and the widget it contains. This function gets the default\r
 792 amount of horizontal and vertical padding, placing the results in @ipad_x\r
 793 and @ipad_y, respectively.\r
 794 </para>
 795
 796 @ipad_x: the default horizontal internal button padding.
 797 @ipad_y: the default vertical internal button padding.
 798
 799 <!-- ##### FUNCTION gtk_button_box_get_child_size_default ##### -->
 800 <para>\r
 801 Retrieves the default minimum width and height for all button boxes, and\r
 802 places the values in @min_width and @min_height, respectively.\r
 803 </para>
 804
 805 @min_width: the default minimum width of a child widget.
 806 @min_height: the default minimum height of a child widget.
 807
 808 <!-- ##### FUNCTION gtk_button_box_set_child_ipadding_default ##### -->
 809 <para>\r
 810 Sets the default number of pixels that pad each button in every button box.\r
 811 </para>
 812
 813 @ipad_x: new default horizontal padding.
 814 @ipad_y: new default vertical padding.
 815
 816 <!-- ##### FUNCTION gtk_button_box_set_child_size_default ##### -->
 817 <para>\r
 818 Sets the default size of child buttons.\r
 819 </para>
 820
 821 @min_width: minimum default width for child buttons.
 822 @min_height: minimum default height for child buttons.
 823
 824 <!-- ##### FUNCTION gtk_button_new_accel ##### -->
 825 <para>
 826
 827 </para>
 828
 829 @uline_label:
 830 @accel_group:
 831 @Returns:
 832
 833 <!-- ##### FUNCTION gtk_button_new_stock ##### -->
 834 <para>
 835
 836 </para>
 837
 838 @stock_id:
 839 @accel_group:
 840 @Returns:
 841
 842 <!-- ##### FUNCTION gtk_clist_construct ##### -->
 843 <para>
 844 Initializes a previously allocated #GtkCList widget for use.  This should not
 845 normally be used to create a #GtkCList widget.  Use gtk_clist_new() instead.
 846 </para>
 847
 848 @clist: A pointer to an uninitialized #GtkCList widget.
 849 @columns: The number of columns the #GtkCList should have.
 850 @titles: An array of strings that should be used as the titles i
 851 of the columns.  There should be enough strings in the array for
 852 the number of columns specified.
 853
 854 <!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
 855 <para>
 856 Controls whether opacity can be set with the #GtkColorSelection.
 857 If this functionality is enabled, the necessary additional widgets
 858 are added to the #GtkColorSelection and the opacity value can be
 859 retrieved via the fourth value in the color array returned by
 860 the gtk_color_selection_get_color() function.
 861 </para>
 862
 863 @colorsel: a #GtkColorSelection.
 864 @use_opacity: a boolean indicating whether the opacity selection
 865 is enabled.
 866
 867 <!-- ##### FUNCTION gtk_ctree_construct ##### -->
 868 <para>
 869 This function is not usually used by users.
 870 </para>
 871
 872 @ctree:
 873 @columns:
 874 @tree_column:
 875 @titles:
 876
 877 <!-- ##### FUNCTION gtk_editable_changed ##### -->
 878 <para>
 879 Causes the "changed" signal to be emitted.
 880 </para>
 881
 882 @editable: a #GtkEditable widget.
 883
 884 <!-- ##### FUNCTION gtk_editable_claim_selection ##### -->
 885 <para>
 886 Claim or disclaim ownership of the PRIMARY X selection.
 887 </para>
 888
 889 @editable: a #GtkEditable widget.
 890 @claim: if %TRUE, claim the selection, otherwise, disclaim it.
 891 @time: the timestamp for claiming the selection.
 892
 893 <!-- ##### FUNCTION gtk_font_selection_dialog_set_filter ##### -->
 894 <para>
 895 Sets one of the two font filters, to limit the fonts shown.
 896 </para>
 897
 898 @fsd: a #GtkFontSelectionDialog.
 899 @filter_type: which of the two font filters to set, either
 900 #GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
 901 can be changed by the user, but the base filter is permanent.
 902 @font_type: the types of font to be shown. This is a bitwise combination of
 903 #GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
 904 or #GTK_FONT_ALL to show all three font types.
 905 @foundries: a NULL-terminated array of strings containing foundry names which
 906 will be shown, or NULL to show all foundries.
 907 @weights: a NULL-terminated array of strings containing weight names which
 908 will be shown, or NULL to show all weights.
 909 @slants: a NULL-terminated array of strings containing slant names which
 910 will be shown, or NULL to show all slants.
 911 @setwidths: a NULL-terminated array of strings containing setwidth names which
 912 will be shown, or NULL to show all setwidths.
 913 @spacings: a NULL-terminated array of strings containing spacings which
 914 will be shown, or NULL to show all spacings.
 915 @charsets: a NULL-terminated array of strings containing charset names which
 916 will be shown, or NULL to show all charsets.
 917
 918 <!-- ##### FUNCTION gtk_font_selection_set_filter ##### -->
 919 <para>
 920 Sets one of the two font filters, to limit the fonts shown.
 921 </para>
 922
 923 @fontsel: a #GtkFontSelection.
 924 @filter_type: which of the two font filters to set, either
 925 #GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
 926 can be changed by the user, but the base filter is permanent.
 927 @font_type: the types of font to be shown. This is a bitwise combination of
 928 #GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
 929 or #GTK_FONT_ALL to show all three font types.
 930 @foundries: a NULL-terminated array of strings containing foundry names which
 931 will be shown, or NULL to show all foundries.
 932 @weights: a NULL-terminated array of strings containing weight names which
 933 will be shown, or NULL to show all weights.
 934 @slants: a NULL-terminated array of strings containing slant names which
 935 will be shown, or NULL to show all slants.
 936 @setwidths: a NULL-terminated array of strings containing setwidth names which
 937 will be shown, or NULL to show all setwidths.
 938 @spacings: a NULL-terminated array of strings containing spacings which
 939 will be shown, or NULL to show all spacings.
 940 @charsets: a NULL-terminated array of strings containing charset names which
 941 will be shown, or NULL to show all charsets.
 942
 943 <!-- ##### FUNCTION gtk_identifier_get_type ##### -->
 944 <para>
 945 Get the type of GtkIdentifier.
 946 </para>
 947
 948 @Returns: GtkType -- the enumerated type of something.
 949
 950 <!-- ##### FUNCTION gtk_label_set_markup_with_accel ##### -->
 951 <para>
 952
 953 </para>
 954
 955 @label:
 956 @str:
 957 @Returns:
 958
 959 <!-- ##### FUNCTION gtk_list_store_set_cell ##### -->
 960 <para>
 961
 962 </para>
 963
 964 @store:
 965 @iter:
 966 @column:
 967 @value:
 968
 969 <!-- ##### FUNCTION gtk_menu_ensure_uline_accel_group ##### -->
 970 <para>
 971
 972 </para>
 973
 974 @menu:
 975 @Returns:
 976
 977 <!-- ##### FUNCTION gtk_menu_get_uline_accel_group ##### -->
 978 <para>
 979
 980 </para>
 981
 982 @menu:
 983 @Returns:
 984
 985 <!-- ##### FUNCTION gtk_object_arg_get ##### -->
 986 <para>
 987 Private function to get an argument and argument info from an object.
 988 </para>
 989
 990 @object: the object whose argument should be retrieved.
 991 @arg: the argument, for the name on input, the rest is filled on output.
 992 @info: a #GtkArgInfo structure to optionally fill in.
 993
 994 <!-- ##### FUNCTION gtk_object_arg_get_info ##### -->
 995 <para>
 996 Query information about an argument type.
 997 </para>
 998
 999 @object_type: type of object to query about.
1000 @arg_name: name of the argument.
1001 @info_p: pointer to be filled in with a pointer to the GtkArgInfo.
1002 @Returns: an error message, or NULL on success.
1003 It is the caller's responsibility to call g_free() in the event of error.
1004
1005 <!-- ##### FUNCTION gtk_object_arg_set ##### -->
1006 <para>
1007 Private function to set an argument and argument info to an object.
1008 </para>
1009
1010 @object: the object whose argument should be set.
1011 @arg: the argument.
1012 @info: infomation about this type of argument in general.
1013
1014 <!-- ##### FUNCTION gtk_object_args_collect ##### -->
1015 <para>
1016 Private: Gets an array of #GtkArgs from a va_list C structure.
1017 </para>
1018
1019 @object_type: the type of object to collect arguments for.
1020 @arg_list_p: pointer to be filled in with a list of parsed arguments.
1021 @info_list_p: optional pointer for a returned list #GtkArgInfos.
1022 @first_arg_name: name of first argument.
1023 @var_args: value of first argument, followed by more key/value pairs,
1024 terminated by NULL.
1025 @Returns: an error message, or NULL on success.
1026 It is the caller's responsibility to call g_free() in the event of error.
1027
1028 <!-- ##### FUNCTION gtk_object_class_add_signals ##### -->
1029 <para>
1030 Add an array of signals to a #GtkObjectClass.
1031 Usually this is called when registering a new type of object.
1032 </para>
1033
1034 @klass: the object class to append signals to.
1035 @signals: the signals to append.
1036 @nsignals: the number of signals being appended.
1037
1038 <!-- ##### FUNCTION gtk_object_class_user_signal_new ##### -->
1039 <para>
1040 Define a signal-handler for a new signal on an already defined
1041 object.
1042 </para>
1043 <para>
1044 See the signal documentation for more general information.
1045 </para>
1046
1047 @klass: the object class to define the signal for.
1048 @name: the name of the signal.
1049 @signal_flags: the default emission behavior for the signal.
1050 See gtk_signal_new().
1051 @marshaller: a function that will take an array of GtkArgs
1052 and invoke the appropriate handler with the normal calling
1053 conventions.
1054 @return_val: specify the return-value type for the signal
1055 (or GTK_TYPE_NONE for no return-value).
1056 @nparams: specify the number of parameters the signal
1057 receives from the caller of gtk_signal_emit().
1058 @Varargs: list of nparams #GtkTypes to pass to the signal handlers.
1059 @Returns: the signal id.  (See #GtkSignals)
1060
1061 <!-- ##### FUNCTION gtk_object_class_user_signal_newv ##### -->
1062 <para>
1063 Define a signal-handler for a new signal on an already defined
1064 object.
1065 </para>
1066
1067 @klass: the object class to define the signal for.
1068 @name: the name of the signal.
1069 @signal_flags: the default emission behavior for the signal.
1070 See gtk_signal_new().
1071 @marshaller: takes a GtkObject, a #GtkSignalFunc, and an array
1072 of arguments, and invokes the function using the appropriate
1073 calling conventions.  Usually just select a function
1074 out of gtkmarshal.h.
1075 @return_val: specify the return-value type for the signal (possibly
1076 #GTK_TYPE_NONE).
1077 @nparams: specify the number of parameters the signal
1078 receives from the caller of gtk_signal_emit().
1079 @params: array of #GtkTypes the signal handlers for this signal
1080 should have in their prototype (of length nparams).
1081 @Returns: the signal id.  (See #GtkSignals)
1082
1083 <!-- ##### FUNCTION gtk_object_constructed ##### -->
1084 <para>
1085 Mark an allocated object as constructed.
1086 This is used for situations
1087 that require precise control of the construction process.
1088 </para>
1089 <para>
1090 This is done when gtk_object_default_construct() is inadequate.
1091 In #GtkCList the need arises because #GtkCList does construction work that
1092 must happen <emphasis>after</emphasis> its derivers.  This work
1093 cannot be done in an initializer function, so an alternate
1094 constructor is mandatory.  It calls gtk_object_constructed() to
1095 indicate it has done its job, so that no other constructor will
1096 be invoked.
1097 </para>
1098 <para>
1099 Normally this function is just automatically run from
1100 gtk_object_default_construct().
1101 </para>
1102
1103 @object: object which has been constructed.  This is usually
1104 done automatically by gtk_object_new() and gtk_object_newv().
1105
1106 <!-- ##### FUNCTION gtk_object_default_construct ##### -->
1107 <para>
1108 This function is called to construct arguments that haven't been initialized
1109 but have the #GTK_ARG_CONSTRUCT flag set.
1110 </para>
1111 <para>
1112 All number arguments are set to 0.  All pointers and strings
1113 are set to NULL.
1114 </para>
1115 <para>
1116 Normally invoked by gtk_object_new() automatically; gtk_type_new() can
1117 be used to bypass it.
1118 </para>
1119
1120 @object: the object to initialize.
1121
1122 <!-- ##### FUNCTION gtk_object_getv ##### -->
1123 <para>
1124 Gets an array of argument values from an object.
1125 </para>
1126
1127 @object: the object to get arguments from.
1128 @n_args: the number of arguments to query.
1129 @args: the arguments to fill in.
1130
1131 <!-- ##### FUNCTION gtk_object_newv ##### -->
1132 <para>
1133 Construct an object with an array of arguments.
1134 </para>
1135
1136 @object_type: the type of the object to create.
1137 @n_args: the number of arguments to set.
1138 @args: an array of n_args arguments (which are name and value pairs).
1139 @Returns: the new GtkObject.
1140
1141 <!-- ##### FUNCTION gtk_object_query_args ##### -->
1142 <para>
1143 Get all the arguments that may be used for a given type.
1144 </para>
1145 <para>
1146 In Java, this type of mechanism is called
1147 <wordasword>introspection</wordasword>.  It is used by applications
1148 like Glade, that have to determine what can be done to an object
1149 at run-time.
1150 </para>
1151
1152 @class_type: the GtkType of the ObjectClass
1153 (returned from GTK_OBJECT_CLASS(class)-&gt;type for example).
1154 @arg_flags: if non-NULL, obtains the #GtkArgFlags that apply to
1155 each argument.  You must g_free() this if you request it.
1156 @n_args: the number of arguments is returned in this field.
1157 @Returns: an array of arguments, that you must deallocate with g_free().
1158
1159 <!-- ##### FUNCTION gtk_object_setv ##### -->
1160 <para>
1161 Set an array of arguments.
1162 </para>
1163
1164 @object: the object whose arguments should be set.
1165 @n_args: the number of arguments to set.
1166 @args: the desired values, as an array of #GtkArgs (which contain
1167 the names, types, and values of the arguments).
1168
1169 <!-- ##### FUNCTION gtk_paned_compute_position ##### -->
1170 <para>
1171 Internal function used by #GtkHPaned and #GtkVPaned
1172 </para>
1173
1174 @paned:
1175 @allocation:
1176 @child1_req:
1177 @child2_req:
1178
1179 <!-- ##### FUNCTION gtk_paned_set_handle_size ##### -->
1180 <para>
1181 Set the the handle size to @size x @size pixels.
1182 </para>
1183
1184 @paned: a paned widget
1185 @size: the size in pixels
1186
1187 <!-- ##### FUNCTION gtk_pattern_match ##### -->
1188 <para>
1189
1190 </para>
1191
1192 @pspec:
1193 @string_length:
1194 @string:
1195 @string_reversed:
1196 @Returns:
1197
1198 <!-- ##### FUNCTION gtk_pattern_match_simple ##### -->
1199 <para>
1200
1201 </para>
1202
1203 @pattern:
1204 @string:
1205 @Returns:
1206
1207 <!-- ##### FUNCTION gtk_pattern_match_string ##### -->
1208 <para>
1209
1210 </para>
1211
1212 @pspec:
1213 @string:
1214 @Returns:
1215
1216 <!-- ##### FUNCTION gtk_pattern_spec_free_segs ##### -->
1217 <para>
1218
1219 </para>
1220
1221 @pspec:
1222
1223 <!-- ##### FUNCTION gtk_pattern_spec_init ##### -->
1224 <para>
1225
1226 </para>
1227
1228 @pspec:
1229 @pattern:
1230
1231 <!-- ##### FUNCTION gtk_rc_init ##### -->
1232 <para>
1233 Internal function.
1234 </para>
1235
1236
1237 <!-- ##### FUNCTION gtk_ruler_draw_pos ##### -->
1238 <para>
1239
1240 </para>
1241
1242 @ruler: the gtkruler
1243
1244 <!-- ##### FUNCTION gtk_ruler_draw_ticks ##### -->
1245 <para>
1246
1247 </para>
1248
1249 @ruler: the gtkruler
1250
1251 <!-- ##### FUNCTION gtk_signal_add_emission_hook ##### -->
1252 <para>
1253 Add an emission hook for a type of signal, for any object.
1254 </para>
1255
1256 @signal_id: the type of signal to hook for.
1257 @hook_func: the function to invoke to handle the emission hook.
1258 @data: the user data passed in to hook_func.
1259 @Returns: the id (that you may pass as a parameter
1260 to gtk_signal_remove_emission_hook()).
1261 @i:
1262 @h:
1263 @d:
1264
1265 <!-- ##### FUNCTION gtk_signal_add_emission_hook_full ##### -->
1266 <para>
1267 Add an emission hook for a type of signal, for any object.
1268 (with control of what happens when the hook is
1269 destroyed).
1270 </para>
1271
1272 @signal_id: the type of signal add the hook for.
1273 @hook_func: the function to invoke to handle the hook.
1274 @data: the user data passed in to hook_func.
1275 @destroy: a function to invoke when the hook is destroyed,
1276 to clean up any allocation done just for this
1277 signal handler.
1278 @Returns: the id (that you may pass as a parameter
1279 to gtk_signal_remove_emission_hook()).
1280
1281 <!-- ##### FUNCTION gtk_signal_handler_pending_by_id ##### -->
1282 <para>
1283 Returns whether a connection id is valid (and optionally not blocked).
1284 </para>
1285
1286 @object: the object to search for the desired handler.
1287 @handler_id: the connection id.
1288 @may_be_blocked: whether it is acceptable to return a blocked
1289 handler.
1290 @Returns: TRUE if the signal exists and wasn't blocked,
1291 unless #may_be_blocked was specified.  FALSE otherwise.
1292
1293 <!-- ##### FUNCTION gtk_signal_handlers_destroy ##### -->
1294 <para>
1295 Destroy all the signal handlers connected to an object.
1296 This is done automatically when the object is destroyed.
1297 </para>
1298 <para>
1299 This function is labeled private.
1300 </para>
1301
1302 @object: the object whose signal handlers should be destroyed.
1303
1304 <!-- ##### FUNCTION gtk_signal_init ##### -->
1305 <para>
1306
1307 </para>
1308
1309
1310 <!-- ##### FUNCTION gtk_signal_n_emissions ##### -->
1311 <para>
1312 Find out the recursion depth of emissions for a particular type
1313 of signal and object.  (So it will
1314 always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified)
1315 This is a way to avoid recursion:  you can see if
1316 you are currently running in that signal handler and emit it only
1317 if you are.
1318 </para>
1319 <para>Another way to look at it is that this number increases
1320 by one when #gtk_signal_emit(), et al, are called,
1321 and decreases by one when #gtk_signal_emit() returns.
1322 </para>
1323
1324 @object: the object with the signal handler.
1325 @signal_id: the signal id.
1326 @Returns: the recursion depth of emissions of this signal for this
1327 object.
1328
1329 <!-- ##### FUNCTION gtk_signal_n_emissions_by_name ##### -->
1330 <para>
1331 Find out the recursion depth of emissions for a particular type
1332 of signal and object.  Just like gtk_signal_n_emissions()
1333 except it will lookup the signal id for you.
1334 </para>
1335
1336 @object: the object with the signal handler.
1337 @name: the signal name.
1338 @Returns: the recursion depth of emissions of this signal for this
1339 object.
1340
1341 <!-- ##### FUNCTION gtk_signal_query ##### -->
1342 <para>
1343 Obtain information about a signal.
1344 </para>
1345
1346 @signal_id: the signal type identifier.
1347 @Returns: a pointer to a GtkSignalQuery structure
1348 which contains all the information, or NULL.
1349 The pointer is allocated just for you:  you must g_free() it.
1350
1351 <!-- ##### FUNCTION gtk_signal_remove_emission_hook ##### -->
1352 <para>
1353 Delete an emission hook. (see gtk_signal_add_emission_hook())
1354 </para>
1355
1356 @signal_id: the id of the signal type.
1357 @hook_id: the id of the emission handler, returned by add_emission_hook().
1358 @i:
1359 @h:
1360
1361 <!-- ##### FUNCTION gtk_signal_set_funcs ##### -->
1362 <para>
1363 These set default functions to call when the user didn't
1364 supply a function when connecting.  (These are rarely
1365 used, and probably only for language bindings)
1366 </para>
1367 <para>
1368 By default, there are no such functions.
1369 </para>
1370
1371 @marshal_func: the function to invoke on every handlers for which there
1372 isn't a function pointer.  May be NULL.
1373 @destroy_func: the function to invoke when each hook is destroyed.
1374 May be NULL.
1375
1376 <!-- ##### FUNCTION gtk_spin_button_set_shadow_type ##### -->
1377 <para>
1378 Creates a border around the arrows of a #GtkSpinButton. The type of border is determined by @shadow_type.
1379 </para>
1380
1381 @spin_button: a #GtkSpinButton
1382 @shadow_type: the new border type.
1383
1384 <!-- ##### FUNCTION gtk_trace_referencing ##### -->
1385 <para>
1386 Private: print debugging information while doing a gtk_object_ref() or
1387 a gtk_object_unref().
1388 </para>
1389
1390 @object: object to reference or unreference.
1391 @func: name of caller's function to print (used within macros).
1392 @dummy: unused.
1393 @line: line number (used within macros).
1394 @do_ref: whether to reference or unreference.
1395
1396 <!-- ##### FUNCTION gtk_tree_model_ref_iter ##### -->
1397 <para>
1398
1399 </para>
1400
1401 @tree_model:
1402 @iter:
1403
1404 <!-- ##### FUNCTION gtk_tree_model_unref_iter ##### -->
1405 <para>
1406
1407 </para>
1408
1409 @tree_model:
1410 @iter:
1411
1412 <!-- ##### FUNCTION gtk_tree_store_set_cell ##### -->
1413 <para>
1414
1415 </para>
1416
1417 @tree_store:
1418 @iter:
1419 @column:
1420 @value:
1421
1422 <!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
1423 <para>
1424 Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make
1425 sure that it's okay to cast something of that @klass into a @cast_type.
1426 </para>
1427
1428 @klass: GtkTypeClass*
1429 @cast_type: GtkType
1430 @Returns: Always return @klass.
1431
1432 <!-- ##### FUNCTION gtk_type_check_object_cast ##### -->
1433 <para>
1434 Given a pointer to a GtkTypeObject @type_object, and a GtkType @cast_type,
1435 make sure that it's okay to cast @type_object into a @cast_type.
1436 </para>
1437
1438 @type_object: GtkTypeObject*
1439 @cast_type: GtkType
1440 @Returns: the same GtkTypeObject* as @type_object
1441
1442 <!-- ##### FUNCTION gtk_type_children_types ##### -->
1443 <para>
1444 Return the pointer to the type's children's types.
1445 </para>
1446
1447 @type: GtkType
1448 @Returns: pointer to a GList
1449
1450 <!-- ##### FUNCTION gtk_type_describe_heritage ##### -->
1451 <para>
1452 Print the types @type inherits from.
1453 </para>
1454
1455 @type: GtkType
1456
1457 <!-- ##### FUNCTION gtk_type_describe_tree ##### -->
1458 <para>
1459 Given a @type, describe all of its children, and their children.  Only
1460 show the size if @show_size is true.
1461 </para>
1462
1463 @type: GtkType
1464 @show_size: gboolean
1465
1466 <!-- ##### FUNCTION gtk_type_free ##### -->
1467 <para>
1468 Given the type of an object and a pointer to it, the object is freed.
1469 </para>
1470
1471 @type: GtkType
1472 @mem: gpointer to the object
1473
1474 <!-- ##### FUNCTION gtk_type_get_varargs_type ##### -->
1475 <para>
1476 Get the varargs type associated with @foreign_type
1477 </para>
1478
1479 @foreign_type: GtkType
1480 @Returns: GtkType
1481
1482 <!-- ##### FUNCTION gtk_type_parent_class ##### -->
1483 <para>
1484 Return the class of the parent.  Initialize the class if necessary.
1485 Return NULL if anything goes wrong.
1486 </para>
1487
1488 @type: GtkType
1489 @Returns: gpointer to the klass.
1490
1491 <!-- ##### FUNCTION gtk_type_query ##### -->
1492 <para>
1493 Given a type, return various interesting parameters of the type.
1494 </para>
1495
1496 @type: GtkType
1497 @Returns: GtkTypeQuery*
1498
1499 <!-- ##### FUNCTION gtk_type_register_enum ##### -->
1500 <para>
1501 Register a new set of enum @values and give them the name in
1502 @type_name.
1503 </para>
1504
1505 @type_name: must not be null.
1506 @values: GtkEnumValue*
1507 @Returns:
1508
1509 <!-- ##### FUNCTION gtk_type_register_flags ##### -->
1510 <para>
1511 Register a new set of flags @values and give them the name in
1512 @type_name.
1513 </para>
1514
1515 @type_name: must not be null.
1516 @values: GtkFlagValue*
1517 @Returns:
1518
1519 <!-- ##### FUNCTION gtk_type_set_chunk_alloc ##### -->
1520 <para>
1521 Set the mem_chunk size so it will hold @n_chunks of the objects of that @type.
1522 </para>
1523
1524 @type: There must be an unlocked TypeNode associated with this type otherwise nothing happens.
1525 @n_chunks:
1526
1527 <!-- ##### FUNCTION gtk_type_set_varargs_type ##### -->
1528 <para>
1529 Set the varargs type for a fundamental type @foreign_type.
1530 </para>
1531
1532 @foreign_type: Must be a GtkType with a sequence number of zero.  Must not be a
1533 fundamental type.
1534 @varargs_type: Must be a GtkType which is either structured or flag, or NONE.
1535
1536 <!-- ##### FUNCTION gtk_widget_activate_mnemonic ##### -->
1537 <para>
1538
1539 </para>
1540
1541 @widget:
1542 @group_cycling:
1543 @Returns:
1544
1545 <!-- ##### FUNCTION gtk_widget_popup ##### -->
1546 <para>
1547
1548 </para>
1549
1550 @widget:
1551 @x:
1552 @y:
1553
1554 <!-- ##### FUNCTION gtk_window_activate_mnemonic ##### -->
1555 <para>
1556
1557 </para>
1558
1559 @window:
1560 @keyval:
1561 @modifier:
1562 @Returns:
1563
1564 <!-- ##### FUNCTION gtk_window_get_default_accel_group ##### -->
1565 <para>
1566
1567 </para>
1568
1569 @window:
1570 @Returns:
1571