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

   1 <!-- ##### SECTION ./tmpl/gtkarg.sgml:Long_Description ##### -->
   2 <para>
   3 All the functions in here are marked a Non-public.
   4 We describe it anyway because it is occasionally useful
   5 to understand how the work is done.
   6 </para>
   7 <para>
   8 Arguments are a way of describing a named parameter to a function.
   9 They have two important roles within gtk+:
  10 <itemizedlist>
  11 <listitem>
  12 <para>
  13 they describe <wordasword>object properties</wordasword>.
  14 This means that they present an interface to get and set a named-type
  15 for any type of object in a consistent way.
  16 (All the relevant functions to do this start with gtk_object_set
  17 or gtk_object_get).
  18 </para>
  19 </listitem>
  20 <listitem>
  21 <para>
  22 they describe <wordasword>signal arguments</wordasword>.
  23 This is a lot less often needed but still useful.
  24 Usually if you are just emitting or creating a particular signal
  25 it is more convenient to just use gtk_signal_emit() or gtk_signal_new().
  26 However if you are writing a function to emit or create an arbitrary
  27 signal, you must use gtk_signal_emitv() or gtk_signal_newv().
  28 </para>
  29 </listitem>
  30 </itemizedlist>
  31 </para>
  32
  33
  34 <!-- ##### SECTION ./tmpl/gtkarg.sgml:See_Also ##### -->
  35 <para>
  36 #GtkObject.
  37 </para>
  38
  39
  40 <!-- ##### SECTION ./tmpl/gtkarg.sgml:Short_Description ##### -->
  41 Utility function to manipulate lists of named, typed arguments.
  42
  43
  44 <!-- ##### SECTION ./tmpl/gtkarg.sgml:Title ##### -->
  45 Implementation of Object Properties
  46
  47
  48 <!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Long_Description ##### -->
  49 <para>
  50
  51 </para>
  52
  53
  54 <!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:See_Also ##### -->
  55 <para>
  56
  57 </para>
  58
  59
  60 <!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Short_Description ##### -->
  61
  62
  63
  64 <!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Title ##### -->
  65 GtkCellRendererTextPixbuf
  66
  67
  68 <!-- ##### SECTION ./tmpl/gtkdata.sgml:Long_Description ##### -->
  69 <para>
  70 The #GtkData object is a very simple object intended to be used as a base
  71 class for objects which contain data (i.e. the 'Model' in the object-oriented
  72 Model/View/Controller framework).
  73 </para>
  74 <para>
  75 Currently it is not very useful since all it provides is a "disconnect" signal.
  76 This signal could be emitted by a #GtkData subclass to notify any 'Views'
  77 that they should disconnect from the #GtkData (the 'Model'), possibly just
  78 before the #GtkData is destroyed.
  79 </para>
  80
  81
  82 <!-- ##### SECTION ./tmpl/gtkdata.sgml:See_Also ##### -->
  83 <para>
  84
  85 </para>
  86
  87
  88 <!-- ##### SECTION ./tmpl/gtkdata.sgml:Short_Description ##### -->
  89 abstract base class for objects containing data.
  90
  91
  92 <!-- ##### SECTION ./tmpl/gtkdata.sgml:Title ##### -->
  93 GtkData
  94
  95
  96 <!-- ##### SECTION ./tmpl/gtkdebug.sgml:Title ##### -->
  97 Debugging
  98
  99
 100 <!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Title ##### -->
 101 gtkenums.sgml
 102
 103
 104 <!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Title ##### -->
 105 GtkIMContextSimple
 106
 107
 108 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Long_Description ##### -->
 109 <refsect2>
 110 <title>What are Signal Marshallers?</title>
 111 <para>
 112 Marshals are functions which all have the same prototype:
 113 they take a #GtkObject, a #GtkSignalFunc, a #gpointer,
 114 and an array of argument values.
 115 The functions are names gtk_marshall_RETURNTYPE__PARAMTYPE1_PARAMTYPE2....
 116 </para>
 117 <para>
 118 They then call a native function:  the GtkObject is the first
 119 parameter passed in.  The arguments are passed in the native
 120 calling convention:  chars, shorts, ints, longs may be packed
 121 on the stack, or tucked in registers:  it doesn't matter
 122 because the same calling convention will be generated
 123 inside the gtkmarshal code as is expected where you define
 124 your handlers.
 125 </para>
 126 <para>
 127 So the function named:
 128 <programlisting>
 129 gtk_marshal_BOOL__POINTER_INT_INT_UINT(GtkObject*, GtkSignalFunc, gpointer, GtkArg*);
 130 </programlisting>
 131 will call the #GtkSignalFunc assuming it was a function with signature:
 132 <programlisting>
 133 gboolean sigfunc(gpointer,gint,gint,guint);
 134 </programlisting>
 135 </para>
 136 </refsect2>
 137 <refsect2>
 138 <title>Writing Custom Marshals</title>
 139 <para>
 140 Marshals are primarily used as arguments to gtk_signal_new().
 141 Sometimes, you may find that a marshaller you need isn't available
 142 in the standard list.  Then you have to write your own.
 143 </para>
 144 <para>
 145 If you wish to define a signal with a new type of argument list.
 146 Suppose you want 2 pointers and 2 integers.
 147 You would write:
 148 <programlisting>
 149 typedef int (*GtkSignal_INT__POINTER_POINTER_INT_INT)(
 150                         gpointer, gpointer, gint, gint
 151 );
 152
 153 void marshal_INT__POINTER_POINTER_INT_INT(GtkObject*    object,
 154                                            GtkSignalFunc func,
 155                                            gpointer      func_data,
 156                                            GtkArg*       args)
 157 {
 158         GtkSignal_NONE__POINTER_POINTER_INT_INT rfunc;
 159         gint* return_val;
 160         return_val = GTK_RETLOC_INT(args[4]);
 161         rfunc = (GtkSignal_INT__POINTER_POINTER_INT_INT)func;
 162         *return_val = (*rfunc)(object,
 163                                GTK_VALUE_POINTER(args[0]),
 164                                GTK_VALUE_POINTER(args[1]),
 165                                GTK_VALUE_INT(args[2]),
 166                                GTK_VALUE_INT(args[3]),
 167                                func_data);
 168 }
 169 </programlisting>
 170 </para>
 171 </refsect2>
 172
 173
 174 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:See_Also ##### -->
 175 <para>
 176 <variablelist>
 177
 178 <varlistentry>
 179 <term>#GtkSignal</term>
 180 <listitem><para>The signal handling functions (of which marshallers are
 181 really an implementation detail).</para></listitem>
 182 </varlistentry>
 183
 184 </variablelist>
 185 </para>
 186
 187
 188 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Short_Description ##### -->
 189 Functions to adapt C structures to native calling convention.
 190
 191
 192 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Title ##### -->
 193 Signal Marshallers
 194
 195
 196 <!-- ##### SECTION ./tmpl/gtkprivate.sgml:Title ##### -->
 197 Private Information
 198
 199
 200 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Long_Description ##### -->
 201 <para>
 202
 203 </para>
 204
 205
 206 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:See_Also ##### -->
 207 <para>
 208
 209 </para>
 210
 211
 212 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Short_Description ##### -->
 213
 214
 215
 216 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Title ##### -->
 217 GtkModelSimple
 218
 219
 220 <!-- ##### MACRO GTK_CLIST_CHILD_HAS_FOCUS ##### -->
 221 <para>
 222 A macro to check whether a child widget of the CList
 223 has the focus.
 224 </para>
 225
 226 @clist: The #GtkCList widget to check.
 227
 228 <!-- ##### MACRO GTK_HAVE_CONTAINER_FOCUS_ADJUSTMENTS ##### -->
 229 <para>
 230
 231 </para>
 232
 233
 234 <!-- ##### MACRO GTK_ICON_SIZE_BUTTON ##### -->
 235 <para>
 236
 237 </para>
 238
 239
 240 <!-- ##### MACRO GTK_ICON_SIZE_DIALOG ##### -->
 241 <para>
 242
 243 </para>
 244
 245
 246 <!-- ##### MACRO GTK_ICON_SIZE_LARGE_TOOLBAR ##### -->
 247 <para>
 248
 249 </para>
 250
 251
 252 <!-- ##### MACRO GTK_ICON_SIZE_MENU ##### -->
 253 <para>
 254
 255 </para>
 256
 257
 258 <!-- ##### MACRO GTK_ICON_SIZE_SMALL_TOOLBAR ##### -->
 259 <para>
 260
 261 </para>
 262
 263
 264 <!-- ##### MACRO GTK_OBJECT_CONSTRUCTED ##### -->
 265 <para>
 266 Test whether a GtkObject's arguments have been prepared.
 267 </para>
 268
 269 @obj: the object to examine.
 270
 271 <!-- ##### MACRO GTK_OBJECT_NSIGNALS ##### -->
 272 <para>
 273 Get the number of signals defined by this object.
 274 </para>
 275
 276 @obj: the object to query.
 277
 278 <!-- ##### MACRO GTK_OBJECT_SIGNALS ##### -->
 279 <para>
 280 Get the array of signals defined for this object.
 281 </para>
 282
 283 @obj: the object to fetch the signals from.
 284
 285 <!-- ##### MACRO GTK_STOCK_BUTTON_APPLY ##### -->
 286 <para>
 287
 288 </para>
 289
 290
 291 <!-- ##### MACRO GTK_STOCK_BUTTON_CANCEL ##### -->
 292 <para>
 293
 294 </para>
 295
 296
 297 <!-- ##### MACRO GTK_STOCK_BUTTON_CLOSE ##### -->
 298 <para>
 299
 300 </para>
 301
 302
 303 <!-- ##### MACRO GTK_STOCK_BUTTON_NO ##### -->
 304 <para>
 305
 306 </para>
 307
 308
 309 <!-- ##### MACRO GTK_STOCK_BUTTON_OK ##### -->
 310 <para>
 311
 312 </para>
 313
 314
 315 <!-- ##### MACRO GTK_STOCK_BUTTON_YES ##### -->
 316 <para>
 317
 318 </para>
 319
 320
 321 <!-- ##### MACRO GTK_TREE_SELECTION ##### -->
 322 <para>
 323 A macro that returns a GList that contains the selection of the root tree of @obj.
 324 </para>
 325
 326 @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.
 327
 328 <!-- ##### MACRO GTK_TYPE_FLAT_FIRST ##### -->
 329 <para>
 330 The first "flat" (no struct) enumerated type value.
 331 </para>
 332
 333
 334 <!-- ##### MACRO GTK_TYPE_FLAT_LAST ##### -->
 335 <para>
 336 The last "flat" (no struct) enumerated type value.
 337 </para>
 338
 339
 340 <!-- ##### MACRO GTK_TYPE_IDENTIFIER ##### -->
 341 <para>
 342 Hide the name of gtk_identifier_get_type
 343 </para>
 344
 345
 346 <!-- ##### MACRO GTK_TYPE_MAKE ##### -->
 347 <para>
 348 Combine a fundemantal type and a sequence number to create a gtk type.
 349 </para>
 350
 351 @parent_t:
 352 @seqno:
 353
 354 <!-- ##### MACRO GTK_TYPE_NUM_BUILTINS ##### -->
 355 <para>
 356 No idea.
 357 </para>
 358
 359
 360 <!-- ##### MACRO GTK_TYPE_SEQNO ##### -->
 361 <para>
 362 Convert a gtk type into its sequence number
 363 </para>
 364
 365 @type:
 366
 367 <!-- ##### MACRO GTK_TYPE_STRUCTURED_FIRST ##### -->
 368 <para>
 369 The first structured enumerated type value.
 370 </para>
 371
 372
 373 <!-- ##### MACRO GTK_TYPE_STRUCTURED_LAST ##### -->
 374 <para>
 375 The last structured enumerated type value.
 376 </para>
 377
 378
 379 <!-- ##### MACRO GTK_TYPE_TREE_COLUMN ##### -->
 380 <para>
 381
 382 </para>
 383
 384
 385 <!-- ##### MACRO GTK_VALUE_ARGS ##### -->
 386 <para>
 387 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS
 388 </para>
 389
 390 @a:
 391
 392 <!-- ##### MACRO GTK_VALUE_CALLBACK ##### -->
 393 <para>
 394 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK
 395 </para>
 396
 397 @a:
 398
 399 <!-- ##### MACRO GTK_VALUE_C_CALLBACK ##### -->
 400 <para>
 401 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK
 402 </para>
 403
 404 @a:
 405
 406 <!-- ##### MACRO GTK_VALUE_FOREIGN ##### -->
 407 <para>
 408 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
 409 </para>
 410
 411 @a:
 412
 413 <!-- ##### USER_FUNCTION GValueCompareFunc ##### -->
 414 <para>
 415
 416 </para>
 417
 418 @a:
 419 @b:
 420 @Returns:
 421
 422 <!-- ##### STRUCT GtkAccelEntry ##### -->
 423 <para>
 424 This is a private struct used by GTK+ internally, don't worry about it.
 425 </para>
 426
 427 @accel_group:
 428 @accelerator_key:
 429 @accelerator_mods:
 430 @accel_flags:
 431 @object:
 432 @signal_id:
 433
 434 <!-- ##### ARG GtkAccelLabel:accel-widget ##### -->
 435 <para>
 436 The widget whose accelerators are to be shown by the #GtkAccelLabel.
 437 </para>
 438
 439
 440 <!-- ##### ARG GtkAccelLabel:accel-width ##### -->
 441 <para>
 442
 443 </para>
 444
 445
 446 <!-- ##### USER_FUNCTION GtkArgGetFunc ##### -->
 447 <para>
 448 Define a function pointer.  Deprecated.
 449 </para>
 450
 451 @object:
 452 @arg:
 453 @arg_id:
 454
 455 <!-- ##### STRUCT GtkArgInfo ##### -->
 456 <para>
 457 A structure containing information about the argument.
 458 Returned by gtk_arg_get_info().
 459 </para>
 460
 461 @class_type: if the argument is an object, this is the object class type.
 462 @name: the name of the argument.
 463 @type: the type of the argument; it may be an object's type
 464 or a fundamental type.
 465 @arg_flags: flags applicable to the argument (i.e. readable, writable,
 466 and whether it needs to be constructed).
 467 @full_name: the object name and argument name separated by ::,
 468 e.g. "GtkObject::user_data" or "GtkButton::label".
 469 @arg_id: the unique argument identified.
 470 @seq_id: ???
 471
 472 <!-- ##### USER_FUNCTION GtkArgSetFunc ##### -->
 473 <para>
 474 Define a function pointer.  Deprecated.
 475 </para>
 476
 477 @object:
 478 @arg:
 479 @arg_id:
 480
 481 <!-- ##### STRUCT GtkCellRendererTextPixbuf ##### -->
 482 <para>
 483
 484 </para>
 485
 486 @parent:
 487
 488 <!-- ##### ARG GtkColorSelection:previous-alpha ##### -->
 489 <para>
 490
 491 </para>
 492
 493
 494 <!-- ##### ARG GtkColorSelection:previous-color ##### -->
 495 <para>
 496
 497 </para>
 498
 499
 500 <!-- ##### SIGNAL GtkContainer::focus ##### -->
 501 <para>
 502
 503 </para>
 504
 505 @container: the object which received the signal.
 506 @direction:
 507 @Returns:
 508
 509 <!-- ##### ARG GtkContainer:reallocate-redraws ##### -->
 510 <para>
 511
 512 </para>
 513
 514
 515 <!-- ##### STRUCT GtkData ##### -->
 516 <para>
 517 The #GtkData-struct struct contains no public fields.
 518 </para>
 519
 520
 521 <!-- ##### SIGNAL GtkData::disconnect ##### -->
 522 <para>
 523 Emitted to notify any views on the #GtkData object to disconnect from it,
 524 possibly because the #GtkData object is about to be destroyed.
 525 </para>
 526
 527 @data: the object which received the signal.
 528
 529 <!-- ##### SIGNAL GtkEditable::activate ##### -->
 530 <para>
 531 Indicates that the user has activated the widget
 532 in some fashion. Generally, this will be done
 533 with a keystroke. (The default binding for this
 534 action is Return for #GtkEntry and
 535 Control-Return for #GtkText.)
 536 </para>
 537
 538 @editable: the object which received the signal.
 539
 540 <!-- ##### SIGNAL GtkEditable::changed ##### -->
 541 <para>
 542 Indicates that the user has changed the contents
 543 of the widget.
 544 </para>
 545
 546 @editable: the object which received the signal.
 547
 548 <!-- ##### SIGNAL GtkEditable::copy-clipboard ##### -->
 549 <para>
 550 An action signal. Causes the characters in the current selection to
 551 be copied to the clipboard.
 552 </para>
 553
 554 @editable: the object which received the signal.
 555
 556 <!-- ##### SIGNAL GtkEditable::cut-clipboard ##### -->
 557 <para>
 558 An action signal. Causes the characters in the current
 559 selection to be copied to the clipboard and then deleted from
 560 the widget.
 561 </para>
 562
 563 @editable: the object which received the signal.
 564
 565 <!-- ##### SIGNAL GtkEditable::delete-text ##### -->
 566 <para>
 567 This signal is emitted when text is deleted from
 568 the widget by the user. The default handler for
 569 this signal will normally be responsible for inserting
 570 the text, so by connecting to this signal and then
 571 stopping the signal with gtk_signal_emit_stop(), it
 572 is possible to modify the inserted text, or prevent
 573 it from being inserted entirely. The @start_pos
 574 and @end_pos parameters are interpreted as for
 575 gtk_editable_delete_text()
 576 </para>
 577
 578 @editable: the object which received the signal.
 579 @start_pos: the starting position.
 580 @end_pos: the end position.
 581
 582 <!-- ##### SIGNAL GtkEditable::insert-text ##### -->
 583 <para>
 584 This signal is emitted when text is inserted into
 585 the widget by the user. The default handler for
 586 this signal will normally be responsible for inserting
 587 the text, so by connecting to this signal and then
 588 stopping the signal with gtk_signal_emit_stop(), it
 589 is possible to modify the inserted text, or prevent
 590 it from being inserted entirely.
 591 </para>
 592
 593 @editable: the object which received the signal.
 594 @new_text: the new text to insert.
 595 @new_text_length: the length of the new text.
 596 @position: the position at which to insert the new text.
 597            this is an in-out paramter. After the signal
 598            emission is finished, it should point after
 599            the newly inserted text.
 600
 601 <!-- ##### SIGNAL GtkEditable::kill-char ##### -->
 602 <para>
 603 An action signal. Delete a single character.
 604 </para>
 605
 606 @editable: the object which received the signal.
 607 @direction: the direction in which to delete. Positive
 608    indicates forward deletion, negative, backwards deletion.
 609
 610 <!-- ##### SIGNAL GtkEditable::kill-line ##### -->
 611 <para>
 612 An action signal. Delete a single line.
 613 </para>
 614
 615 @editable: the object which received the signal.
 616 @direction: the direction in which to delete. Positive
 617    indicates forward deletion, negative, backwards deletion.
 618
 619 <!-- ##### SIGNAL GtkEditable::kill-word ##### -->
 620 <para>
 621 An action signal. Delete a single word.
 622 </para>
 623
 624 @editable: the object which received the signal.
 625 @direction: the direction in which to delete. Positive
 626    indicates forward deletion, negative, backwards deletion.
 627
 628 <!-- ##### SIGNAL GtkEditable::move-cursor ##### -->
 629 <para>
 630 An action signal. Move the cursor position.
 631 </para>
 632
 633 @editable: the object which received the signal.
 634 @x: horizontal distance to move the cursor.
 635 @y: vertical distance to move the cursor.
 636
 637 <!-- ##### SIGNAL GtkEditable::move-page ##### -->
 638 <para>
 639 An action signal. Move the cursor by pages.
 640 </para>
 641
 642 @editable: the object which received the signal.
 643 @x: Number of pages to move the cursor horizontally.
 644 @y: Number of pages to move the cursor vertically.
 645
 646 <!-- ##### SIGNAL GtkEditable::move-to-column ##### -->
 647 <para>
 648 An action signal. Move the cursor to the given column.
 649 </para>
 650
 651 @editable: the object which received the signal.
 652 @column: the column to move to. (A negative value indicates
 653          the last column)
 654
 655 <!-- ##### SIGNAL GtkEditable::move-to-row ##### -->
 656 <para>
 657 An action signal. Move the cursor to the given row.
 658 </para>
 659
 660 @editable: the object which received the signal.
 661 @row: the row to move to. (A negative value indicates
 662       the last row)
 663
 664 <!-- ##### SIGNAL GtkEditable::move-word ##### -->
 665 <para>
 666 An action signal. Move the cursor by words.
 667 </para>
 668
 669 @editable: the object which received the signal.
 670 @num_words: The number of words to move the
 671 cursor. (Can be negative).
 672
 673 <!-- ##### SIGNAL GtkEditable::paste-clipboard ##### -->
 674 <para>
 675 An action signal. Causes the contents of the clipboard to
 676 be pasted into the editable widget at the current cursor
 677 position.
 678 </para>
 679
 680 @editable: the object which received the signal.
 681
 682 <!-- ##### SIGNAL GtkEditable::set-editable ##### -->
 683 <para>
 684 Determines if the user can edit the text in the editable
 685 widget or not. This is meant to be overriden by
 686 child classes and should not generally useful to
 687 applications.
 688 </para>
 689
 690 @editable: the object which received the signal.
 691 @is_editable: %TRUE if the user is allowed to edit the text
 692   in the widget.
 693
 694 <!-- ##### ARG GtkEditable:editable ##### -->
 695 <para>
 696 A boolean indicating whether the widget is editable by
 697 the user.
 698 </para>
 699
 700
 701 <!-- ##### ARG GtkEditable:text-position ##### -->
 702 <para>
 703 The position of the cursor.
 704 </para>
 705
 706
 707 <!-- ##### USER_FUNCTION GtkEmissionHook ##### -->
 708 <para>
 709 A simple function pointer to get invoked when the
 710 signal is emitted.  This allows you tie a hook to the signal type,
 711 so that it will trap all emissions of that signal, from any object.
 712 </para>
 713 <para>
 714 You may not attach these to signals created with the
 715 #GTK_RUN_NO_HOOKS flag.
 716 </para>
 717
 718 @object:
 719 @signal_id:
 720 @n_params:
 721 @params:
 722 @data:
 723 @Returns:
 724
 725 <!-- ##### ENUM GtkFontFilterType ##### -->
 726 <para>
 727 A set of bit flags used to specify the filter being set
 728 when calling gtk_font_selection_dialog_set_filter() or
 729 gtk_font_selection_set_filter().
 730 </para>
 731
 732 @GTK_FONT_FILTER_BASE: the base filter, which can't be changed by the user.
 733 @GTK_FONT_FILTER_USER: the user filter, which can be changed from within the
 734 'Filter' page of the #GtkFontSelection widget.
 735
 736 <!-- ##### ENUM GtkFontType ##### -->
 737 <para>
 738 A set of bit flags used to specify the type of fonts shown
 739 when calling gtk_font_selection_dialog_set_filter() or
 740 gtk_font_selection_set_filter().
 741 </para>
 742
 743 @GTK_FONT_BITMAP: bitmap fonts.
 744 @GTK_FONT_SCALABLE: scalable fonts.
 745 @GTK_FONT_SCALABLE_BITMAP: scaled bitmap fonts.
 746 @GTK_FONT_ALL: a bitwise combination of all of the above.
 747
 748 <!-- ##### ARG GtkHScale:adjustment ##### -->
 749 <para>
 750 the #GtkAdjustment which sets the range of the scale.
 751 </para>
 752
 753
 754 <!-- ##### ARG GtkHScrollbar:adjustment ##### -->
 755 <para>
 756
 757 </para>
 758
 759
 760 <!-- ##### STRUCT GtkIMContextSimple ##### -->
 761 <para>
 762
 763 </para>
 764
 765 @object:
 766 @tables:
 767 @compose_buffer:
 768 @tentative_match:
 769 @tentative_match_len:
 770
 771 <!-- ##### USER_FUNCTION GtkImageLoader ##### -->
 772 <para>
 773 A GtkImageLoader is used to load a filename found in
 774 a RC file.
 775 </para>
 776
 777 @window: the window for creating image
 778 @colormap: the colormap for this image
 779 @mask: a pointer to the location to store the mask
 780 @transparent_color: the transparent color for the image
 781 @filename: filename to load
 782 @Returns: a #GtkPixmap representing @filename
 783
 784 <!-- ##### ARG GtkLabel:accel-keyval ##### -->
 785 <para>
 786
 787 </para>
 788
 789
 790 <!-- ##### ARG GtkObject:object-signal ##### -->
 791 <para>
 792 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
 793 the signal to the object, so that the user data and objects
 794 and swapped when the signal handler is invoked.
 795 </para>
 796 <para>
 797 This is useful for handlers that are primarily notifying
 798 other objects and could just invoke an already existing function
 799 if the parameters were swapped.
 800 See gtk_signal_connect_object() for more details.
 801 </para>
 802
 803
 804 <!-- ##### ARG GtkObject:object-signal-after ##### -->
 805 <para>
 806 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
 807 the signal to the object, so that the user data and objects
 808 and swapped when the signal handler is invoked,
 809 and so that the handler is invoked after all others.
 810 </para>
 811 <para>
 812 See gtk_signal_connect_object_after() for more details.
 813 </para>
 814
 815
 816 <!-- ##### ARG GtkObject:signal ##### -->
 817 <para>
 818 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
 819 the signal to the object.
 820 </para>
 821
 822
 823 <!-- ##### ARG GtkObject:signal-after ##### -->
 824 <para>
 825 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
 826 the signal to the object, so that the signal is always run
 827 after other user handlers and the default handler.
 828 </para>
 829
 830
 831 <!-- ##### ARG GtkPacker:default-border-width ##### -->
 832 <para>
 833
 834 </para>
 835
 836
 837 <!-- ##### ARG GtkPacker:default-ipad-x ##### -->
 838 <para>
 839
 840 </para>
 841
 842
 843 <!-- ##### ARG GtkPacker:default-ipad-y ##### -->
 844 <para>
 845
 846 </para>
 847
 848
 849 <!-- ##### ARG GtkPacker:default-pad-x ##### -->
 850 <para>
 851
 852 </para>
 853
 854
 855 <!-- ##### ARG GtkPacker:default-pad-y ##### -->
 856 <para>
 857
 858 </para>
 859
 860
 861 <!-- ##### ARG GtkPacker:spacing ##### -->
 862 <para>
 863
 864 </para>
 865
 866
 867 <!-- ##### ARG GtkPaned:handle-size ##### -->
 868 <para>
 869
 870 </para>
 871
 872
 873 <!-- ##### STRUCT GtkPatternSpec ##### -->
 874 <para>
 875
 876 </para>
 877
 878 @match_type:
 879 @pattern_length:
 880 @pattern:
 881 @pattern_reversed:
 882 @user_data:
 883 @seq_id:
 884
 885 <!-- ##### ENUM GtkPrivateFlags ##### -->
 886 <para>
 887
 888 </para>
 889
 890 @PRIVATE_GTK_USER_STYLE:
 891 @PRIVATE_GTK_RESIZE_PENDING:
 892 @PRIVATE_GTK_RESIZE_NEEDED:
 893 @PRIVATE_GTK_LEAVE_PENDING:
 894 @PRIVATE_GTK_HAS_SHAPE_MASK:
 895 @PRIVATE_GTK_IN_REPARENT:
 896 @PRIVATE_GTK_DIRECTION_SET:
 897 @PRIVATE_GTK_DIRECTION_LTR:
 898
 899 <!-- ##### ARG GtkScrolledWindow:shadow ##### -->
 900 <para>
 901
 902 </para>
 903
 904
 905 <!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
 906 <para>
 907 A function which you can use to clean up when the
 908 signal handler is destroyed.
 909 </para>
 910 <para>
 911 For example, if your handler requires a few variables
 912 that you made into a struct and allocated (using g_new()
 913 or something), then you will probably want to free
 914 it as soon as the hook is destroyed.  This will
 915 allow you to do that. (For this in particular
 916 it is convenient to pass g_free() as a #GtkSignalDestroy
 917 function).
 918 </para>
 919
 920 @data: The user data associated with the hook that is being
 921 destroyed.
 922
 923 <!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
 924 <para>
 925 This is currently a hack left in for a scheme wrapper library.
 926 It may be removed.
 927 </para>
 928 <para>
 929 Don't use it.
 930 </para>
 931
 932 @object: The object which emits the signal.
 933 @data: The user data associated with the hook.
 934 @nparams: The number of parameters to the function.
 935 @args: The actual values of the arguments.
 936 @arg_types: The types of the arguments.
 937 @return_type: The type of the return value from the function
 938 or #GTK_TYPE_NONE for no return value.
 939
 940 <!-- ##### STRUCT GtkSignalQuery ##### -->
 941 <para>
 942 This structure contains all the information about a particular
 943 signal:  its name, the type it affects, the signature of the handlers,
 944 and its unique identifying integer.
 945 </para>
 946
 947 @object_type:
 948 @signal_id:
 949 @signal_name:
 950 @is_user_signal:
 951 @signal_flags:
 952 @return_val:
 953 @nparams:
 954 @params:
 955
 956 <!-- ##### ARG GtkSpinButton:shadow-type ##### -->
 957 <para>
 958 the type of border that surrounds the arrows of a spin button.
 959 </para>
 960
 961
 962 <!-- ##### STRUCT GtkStatusbarMsg ##### -->
 963 <para>
 964 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.
 965 </para>
 966
 967 @text:
 968 @context_id:
 969 @message_id:
 970
 971 <!-- ##### ARG GtkTextTag:justify ##### -->
 972 <para>
 973 A #GtkJustification for the text. This is only used when the tag is
 974 applied to the first character in a paragraph.
 975 </para>
 976
 977
 978 <!-- ##### ARG GtkTextTag:left-wrapped-line-margin ##### -->
 979 <para>
 980 Pixel width of the left margin of the text for lines after the first
 981 line in a wrapped paragraph.
 982 </para>
 983
 984
 985 <!-- ##### ARG GtkTextTag:left-wrapped-line-margin-set ##### -->
 986 <para>
 987
 988 </para>
 989
 990
 991 <!-- ##### ARG GtkTextTag:offset ##### -->
 992 <para>
 993 Pixels to offset the text horizontally or vertically, useful to
 994 produce superscript and subscript.
 995 </para>
 996
 997
 998 <!-- ##### ARG GtkTextView:justify ##### -->
 999 <para>
1000
1001 </para>
1002
1003
1004 <!-- ##### ENUM GtkTreeSelectionMode ##### -->
1005 <para>
1006
1007 </para>
1008
1009 @GTK_TREE_SELECTION_SINGLE:
1010 @GTK_TREE_SELECTION_MULTI:
1011
1012 <!-- ##### ARG GtkVScale:adjustment ##### -->
1013 <para>
1014 the #GtkAdjustment which sets the range of the scale.
1015 </para>
1016
1017
1018 <!-- ##### ARG GtkVScrollbar:adjustment ##### -->
1019 <para>
1020
1021 </para>
1022
1023
1024 <!-- ##### SIGNAL GtkWidget::activate-mnemonic ##### -->
1025 <para>
1026
1027 </para>
1028
1029 @widget: the object which received the signal.
1030 @arg1:
1031 @Returns:
1032
1033 <!-- ##### SIGNAL GtkWidget::debug-msg ##### -->
1034 <para>
1035
1036 </para>
1037
1038 @widget: the object which received the signal.
1039 @message:
1040
1041 <!-- ##### SIGNAL GtkWidget::draw ##### -->
1042 <para>
1043
1044 </para>
1045
1046 @widget: the object which received the signal.
1047 @area:
1048
1049 <!-- ##### SIGNAL GtkWidget::draw-default ##### -->
1050 <para>
1051
1052 </para>
1053
1054 @widget: the object which received the signal.
1055
1056 <!-- ##### SIGNAL GtkWidget::draw-focus ##### -->
1057 <para>
1058
1059 </para>
1060
1061 @widget: the object which received the signal.
1062
1063 <!-- ##### ARG GtkWidget:height ##### -->
1064 <para>
1065
1066 </para>
1067
1068
1069 <!-- ##### ARG GtkWidget:width ##### -->
1070 <para>
1071
1072 </para>
1073
1074
1075 <!-- ##### ARG GtkWidget:x ##### -->
1076 <para>
1077
1078 </para>
1079
1080
1081 <!-- ##### ARG GtkWidget:y ##### -->
1082 <para>
1083
1084 </para>
1085
1086
1087 <!-- ##### ARG GtkWindow:auto-shrink ##### -->
1088 <para>
1089 If the window shrinks automatically when widgets within it shrink.
1090 </para>
1091
1092
1093 <!-- ##### ARG GtkWindow:icon-list ##### -->
1094 <para>
1095
1096 </para>
1097
1098
1099 <!-- ##### FUNCTION gtk_accel_group_create_add ##### -->
1100 <para>
1101
1102 </para>
1103
1104 @class_type:
1105 @signal_flags:
1106 @handler_offset:
1107 @Returns:
1108
1109 <!-- ##### FUNCTION gtk_accel_group_create_remove ##### -->
1110 <para>
1111
1112 </para>
1113
1114 @class_type:
1115 @signal_flags:
1116 @handler_offset:
1117 @Returns:
1118
1119 <!-- ##### FUNCTION gtk_accel_group_entries_from_object ##### -->
1120 <para>
1121
1122 </para>
1123
1124 @object:
1125 @Returns:
1126
1127 <!-- ##### FUNCTION gtk_accel_group_get_entry ##### -->
1128 <para>
1129
1130 </para>
1131
1132 @accel_group:
1133 @accel_key:
1134 @accel_mods:
1135 @Returns:
1136
1137 <!-- ##### FUNCTION gtk_accel_group_handle_add ##### -->
1138 <para>
1139
1140 </para>
1141
1142 @object:
1143 @accel_signal_id:
1144 @accel_group:
1145 @accel_key:
1146 @accel_mods:
1147 @accel_flags:
1148
1149 <!-- ##### FUNCTION gtk_accel_group_handle_remove ##### -->
1150 <para>
1151
1152 </para>
1153
1154 @object:
1155 @accel_group:
1156 @accel_key:
1157 @accel_mods:
1158
1159 <!-- ##### FUNCTION gtk_accel_group_lock_entry ##### -->
1160 <para>
1161
1162 </para>
1163
1164 @accel_group:
1165 @accel_key:
1166 @accel_mods:
1167
1168 <!-- ##### FUNCTION gtk_accel_group_unlock_entry ##### -->
1169 <para>
1170
1171 </para>
1172
1173 @accel_group:
1174 @accel_key:
1175 @accel_mods:
1176
1177 <!-- ##### FUNCTION gtk_accel_groups_from_object ##### -->
1178 <para>
1179
1180 </para>
1181
1182 @object:
1183 @Returns:
1184
1185 <!-- ##### FUNCTION gtk_arg_copy ##### -->
1186 <para>
1187 It will either copy data into an existing argument or allocate a new argument
1188 and copy the data.  Strings are duplicated.  All other pointers and
1189 values are copied (shallowly-- that is the pointers themselves are
1190 copied, not the data they point to.)
1191 </para>
1192 <para>
1193 You should call gtk_arg_reset() on dest_arg before calling this
1194 if the argument may contain string data that you want freed.
1195 </para>
1196
1197 @src_arg: the argument to duplicate.
1198 @dest_arg: the argument to copy over (or NULL to create a new #GtkArg).
1199 @Returns: the new #GtkArg (or dest_arg, if it was not NULL).
1200
1201 <!-- ##### FUNCTION gtk_arg_free ##### -->
1202 <para>
1203 Frees the argument, and optionally its contents.
1204 </para>
1205
1206 @arg: the argument to free.
1207 @free_contents: whether to free the string, if it is a string.
1208
1209 <!-- ##### FUNCTION gtk_arg_get_info ##### -->
1210 <para>
1211 Private: get information about an argument.
1212 </para>
1213
1214 @object_type: the type of object.
1215 @arg_info_hash_table: the hashtable of #GtkArgInfos.
1216 @arg_name: the name of the argument to lookup.
1217 @info_p: the argument info.
1218 @Returns: an error message on failure, or NULL otherwise.
1219
1220 <!-- ##### FUNCTION gtk_arg_info_equal ##### -->
1221 <para>
1222 A #GCompareFunc for hashing #GtkArgInfos.
1223 </para>
1224
1225 @arg_info_1: a #GtkArgInfo.
1226 @arg_info_2: a #GtkArgInfo.
1227 @Returns: whether the arguments are the same.
1228
1229 <!-- ##### FUNCTION gtk_arg_info_hash ##### -->
1230 <para>
1231 A #GHashFunc for hashing #GtkArgInfos.
1232 </para>
1233
1234 @arg_info: a #GtkArgInfo.
1235 @Returns: a hash value for that #GtkArgInfo.
1236
1237 <!-- ##### FUNCTION gtk_arg_name_strip_type ##### -->
1238 <para>
1239 Given a fully qualified argument name (e.g. "GtkButton::label")
1240 it returns just the argument name (e.g. "label") unless
1241 the argument name was invalid, in which case it returns NULL.
1242 </para>
1243
1244 @arg_name: the fully-qualified argument name.
1245 @Returns: the base argument name.
1246
1247 <!-- ##### FUNCTION gtk_arg_new ##### -->
1248 <para>
1249 Creates a new argument of a certain type, set to 0 or NULL.
1250 </para>
1251
1252 @arg_type: the type of the argument.
1253 @Returns: the newly created #GtkArg.
1254
1255 <!-- ##### FUNCTION gtk_arg_reset ##### -->
1256 <para>
1257
1258 </para>
1259
1260 @arg:
1261
1262 <!-- ##### FUNCTION gtk_arg_to_valueloc ##### -->
1263 <para>
1264
1265 </para>
1266
1267 @arg:
1268 @value_pointer:
1269
1270 <!-- ##### FUNCTION gtk_arg_type_new_static ##### -->
1271 <para>
1272 Create a new argument registered with a class.
1273 </para>
1274
1275 @base_class_type: the basic type having the arguments, almost alway
1276 GTK_TYPE_OBJECT, except if your defining a different type argument
1277 that gets a different namespace.  #GtkContainer does this to define
1278 per-child arguments of the container.
1279 @arg_name: name of the argument to create.  (must be a static constant string)
1280 @class_n_args_offset: offset into the base class structure that tells
1281 the number of arguments.
1282 @arg_info_hash_table: hashtable of #GtkArgInfos.
1283 @arg_type: type of the argument.
1284 @arg_flags: flags of the argument.
1285 @arg_id: ???
1286 @Returns: the new #GtkArgInfo.
1287
1288 <!-- ##### FUNCTION gtk_arg_values_equal ##### -->
1289 <para>
1290
1291 </para>
1292
1293 @arg1:
1294 @arg2:
1295 @Returns:
1296
1297 <!-- ##### FUNCTION gtk_args_collect ##### -->
1298 <para>
1299 Private:  given a hashtable of argument information it takes a vararg
1300 list and parses it into arguments (in the form of lists of #GtkArgs
1301 and lists of #GtkArgInfos.
1302 </para>
1303 <para>
1304 The list of arguments starts with first_arg_name then the first argument's
1305 value.  Followed by any number of additional name/argument pairs,
1306 terminated with NULL.
1307 </para>
1308
1309 @object_type: the type of object we are collecting arguments for.
1310 @arg_info_hash_table: a hashtable mapping from names of arguments
1311 to their #GtkArgInfos.
1312 @arg_list_p: a returned list of arguments obtained from parsing the
1313 varargs.
1314 @info_list_p: a returned list of the #GtkArgInfos.
1315 @first_arg_name: the name of the first argument.
1316 @var_args: a va_list containing the value of the first argument,
1317 followed by name/value pairs, followed by NULL.
1318 @Returns: an error message on failure, or NULL otherwise.
1319
1320 <!-- ##### FUNCTION gtk_args_collect_cleanup ##### -->
1321 <para>
1322 Private: erase lists of arguments returned from gtk_args_collect().
1323 </para>
1324
1325 @arg_list: arg_list_p returned from gtk_args_collect().
1326 @info_list: info_list_p returned from gtk_args_collect().
1327
1328 <!-- ##### FUNCTION gtk_args_query ##### -->
1329 <para>
1330 Private: from a class type and its arginfo hashtable,
1331 get an array of #GtkArgs that this object accepts.
1332 </para>
1333
1334 @class_type: the class type.
1335 @arg_info_hash_table: the hashtable of #GtkArgInfos.
1336 @arg_flags: returned array of argument flags.
1337 @n_args_p: the number of arguments this object accepts.
1338 @Returns: the array of arguments (or NULL on error).
1339
1340 <!-- ##### FUNCTION gtk_button_box_child_requisition ##### -->
1341 <para>\r
1342 This is an internally used function and should never be called from an\r
1343 application.\r
1344 </para>
1345
1346 @widget:
1347 @nvis_children:
1348 @width:
1349 @height:
1350
1351 <!-- ##### FUNCTION gtk_button_box_get_child_ipadding_default ##### -->
1352 <para>\r
1353 The internal padding of a button is the amount of space between the outside\r
1354 of the button and the widget it contains. This function gets the default\r
1355 amount of horizontal and vertical padding, placing the results in @ipad_x\r
1356 and @ipad_y, respectively.\r
1357 </para>
1358
1359 @ipad_x: the default horizontal internal button padding.
1360 @ipad_y: the default vertical internal button padding.
1361
1362 <!-- ##### FUNCTION gtk_button_box_get_child_size_default ##### -->
1363 <para>\r
1364 Retrieves the default minimum width and height for all button boxes, and\r
1365 places the values in @min_width and @min_height, respectively.\r
1366 </para>
1367
1368 @min_width: the default minimum width of a child widget.
1369 @min_height: the default minimum height of a child widget.
1370
1371 <!-- ##### FUNCTION gtk_button_box_set_child_ipadding_default ##### -->
1372 <para>\r
1373 Sets the default number of pixels that pad each button in every button box.\r
1374 </para>
1375
1376 @ipad_x: new default horizontal padding.
1377 @ipad_y: new default vertical padding.
1378
1379 <!-- ##### FUNCTION gtk_button_box_set_child_size_default ##### -->
1380 <para>\r
1381 Sets the default size of child buttons.\r
1382 </para>
1383
1384 @min_width: minimum default width for child buttons.
1385 @min_height: minimum default height for child buttons.
1386
1387 <!-- ##### FUNCTION gtk_button_new_accel ##### -->
1388 <para>
1389
1390 </para>
1391
1392 @uline_label:
1393 @accel_group:
1394 @Returns:
1395
1396 <!-- ##### FUNCTION gtk_button_new_stock ##### -->
1397 <para>
1398
1399 </para>
1400
1401 @stock_id:
1402 @accel_group:
1403 @Returns:
1404
1405 <!-- ##### FUNCTION gtk_cell_renderer_event ##### -->
1406 <para>
1407
1408 </para>
1409
1410 @cell:
1411 @event:
1412 @widget:
1413 @path:
1414 @background_area:
1415 @cell_area:
1416 @flags:
1417 @Returns:
1418
1419 <!-- ##### FUNCTION gtk_cell_renderer_text_pixbuf_new ##### -->
1420 <para>
1421
1422 </para>
1423
1424 @Returns:
1425
1426 <!-- ##### FUNCTION gtk_clist_construct ##### -->
1427 <para>
1428 Initializes a previously allocated #GtkCList widget for use.  This should not
1429 normally be used to create a #GtkCList widget.  Use gtk_clist_new() instead.
1430 </para>
1431
1432 @clist: A pointer to an uninitialized #GtkCList widget.
1433 @columns: The number of columns the #GtkCList should have.
1434 @titles: An array of strings that should be used as the titles i
1435 of the columns.  There should be enough strings in the array for
1436 the number of columns specified.
1437
1438 <!-- ##### FUNCTION gtk_color_selection_get_old_color ##### -->
1439 <para>
1440
1441 </para>
1442
1443 @colorsel:
1444 @color:
1445
1446 <!-- ##### FUNCTION gtk_color_selection_get_use_opacity ##### -->
1447 <para>
1448
1449 </para>
1450
1451 @colorsel:
1452 @Returns:
1453
1454 <!-- ##### FUNCTION gtk_color_selection_get_use_palette ##### -->
1455 <para>
1456
1457 </para>
1458
1459 @colorsel:
1460 @Returns:
1461
1462 <!-- ##### FUNCTION gtk_color_selection_set_old_color ##### -->
1463 <para>
1464
1465 </para>
1466
1467 @colorsel:
1468 @color:
1469
1470 <!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
1471 <para>
1472 Controls whether opacity can be set with the #GtkColorSelection.
1473 If this functionality is enabled, the necessary additional widgets
1474 are added to the #GtkColorSelection and the opacity value can be
1475 retrieved via the fourth value in the color array returned by
1476 the gtk_color_selection_get_color() function.
1477 </para>
1478
1479 @colorsel: a #GtkColorSelection.
1480 @use_opacity: a boolean indicating whether the opacity selection
1481 is enabled.
1482
1483 <!-- ##### FUNCTION gtk_color_selection_set_use_opacity ##### -->
1484 <para>
1485
1486 </para>
1487
1488 @colorsel:
1489 @use_opacity:
1490
1491 <!-- ##### FUNCTION gtk_color_selection_set_use_palette ##### -->
1492 <para>
1493
1494 </para>
1495
1496 @colorsel:
1497 @use_palette:
1498
1499 <!-- ##### FUNCTION gtk_container_add_child_arg_type ##### -->
1500 <para>
1501
1502 </para>
1503
1504 @arg_name:
1505 @arg_type:
1506 @arg_flags:
1507 @arg_id:
1508
1509 <!-- ##### FUNCTION gtk_container_add_with_args ##### -->
1510 <para>
1511
1512 </para>
1513
1514 @container:
1515 @widget:
1516 @first_arg_name:
1517 @Varargs:
1518
1519 <!-- ##### FUNCTION gtk_container_addv ##### -->
1520 <para>
1521
1522 </para>
1523
1524 @container:
1525 @widget:
1526 @n_args:
1527 @args:
1528
1529 <!-- ##### FUNCTION gtk_container_arg_get ##### -->
1530 <para>
1531
1532 </para>
1533
1534 @container:
1535 @child:
1536 @arg:
1537 @info:
1538
1539 <!-- ##### FUNCTION gtk_container_arg_set ##### -->
1540 <para>
1541
1542 </para>
1543
1544 @container:
1545 @child:
1546 @arg:
1547 @info:
1548
1549 <!-- ##### FUNCTION gtk_container_child_arg_get_info ##### -->
1550 <para>
1551
1552 </para>
1553
1554 @object_type:
1555 @arg_name:
1556 @info_p:
1557 @Returns:
1558
1559 <!-- ##### FUNCTION gtk_container_child_args_collect ##### -->
1560 <para>
1561
1562 </para>
1563
1564 @object_type:
1565 @arg_list_p:
1566 @info_list_p:
1567 @first_arg_name:
1568 @args:
1569 @Returns:
1570
1571 <!-- ##### FUNCTION gtk_container_child_getv ##### -->
1572 <para>
1573
1574 </para>
1575
1576 @container:
1577 @child:
1578 @n_args:
1579 @args:
1580
1581 <!-- ##### FUNCTION gtk_container_child_setv ##### -->
1582 <para>
1583
1584 </para>
1585
1586 @container:
1587 @child:
1588 @n_args:
1589 @args:
1590
1591 <!-- ##### FUNCTION gtk_container_dequeue_resize_handler ##### -->
1592 <para>
1593
1594 </para>
1595
1596 @container:
1597
1598 <!-- ##### FUNCTION gtk_container_focus ##### -->
1599 <para>
1600
1601 </para>
1602
1603 @container:
1604 @direction:
1605 @Returns:
1606
1607 <!-- ##### FUNCTION gtk_container_query_child_args ##### -->
1608 <para>
1609
1610 </para>
1611
1612 @class_type:
1613 @arg_flags:
1614 @nargs:
1615 @Returns:
1616
1617 <!-- ##### FUNCTION gtk_ctree_construct ##### -->
1618 <para>
1619 This function is not usually used by users.
1620 </para>
1621
1622 @ctree:
1623 @columns:
1624 @tree_column:
1625 @titles:
1626
1627 <!-- ##### FUNCTION gtk_drag_dest_handle_event ##### -->
1628 <para>
1629 Internal function.
1630 </para>
1631
1632 @toplevel:
1633 @event:
1634
1635 <!-- ##### FUNCTION gtk_drag_source_handle_event ##### -->
1636 <para>
1637 Internal function.
1638 </para>
1639
1640 @widget:
1641 @event:
1642
1643 <!-- ##### FUNCTION gtk_editable_changed ##### -->
1644 <para>
1645 Causes the "changed" signal to be emitted.
1646 </para>
1647
1648 @editable: a #GtkEditable widget.
1649
1650 <!-- ##### FUNCTION gtk_editable_claim_selection ##### -->
1651 <para>
1652 Claim or disclaim ownership of the PRIMARY X selection.
1653 </para>
1654
1655 @editable: a #GtkEditable widget.
1656 @claim: if %TRUE, claim the selection, otherwise, disclaim it.
1657 @time: the timestamp for claiming the selection.
1658
1659 <!-- ##### FUNCTION gtk_font_selection_dialog_set_filter ##### -->
1660 <para>
1661 Sets one of the two font filters, to limit the fonts shown.
1662 </para>
1663
1664 @fsd: a #GtkFontSelectionDialog.
1665 @filter_type: which of the two font filters to set, either
1666 #GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
1667 can be changed by the user, but the base filter is permanent.
1668 @font_type: the types of font to be shown. This is a bitwise combination of
1669 #GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
1670 or #GTK_FONT_ALL to show all three font types.
1671 @foundries: a NULL-terminated array of strings containing foundry names which
1672 will be shown, or NULL to show all foundries.
1673 @weights: a NULL-terminated array of strings containing weight names which
1674 will be shown, or NULL to show all weights.
1675 @slants: a NULL-terminated array of strings containing slant names which
1676 will be shown, or NULL to show all slants.
1677 @setwidths: a NULL-terminated array of strings containing setwidth names which
1678 will be shown, or NULL to show all setwidths.
1679 @spacings: a NULL-terminated array of strings containing spacings which
1680 will be shown, or NULL to show all spacings.
1681 @charsets: a NULL-terminated array of strings containing charset names which
1682 will be shown, or NULL to show all charsets.
1683
1684 <!-- ##### FUNCTION gtk_font_selection_set_filter ##### -->
1685 <para>
1686 Sets one of the two font filters, to limit the fonts shown.
1687 </para>
1688
1689 @fontsel: a #GtkFontSelection.
1690 @filter_type: which of the two font filters to set, either
1691 #GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
1692 can be changed by the user, but the base filter is permanent.
1693 @font_type: the types of font to be shown. This is a bitwise combination of
1694 #GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
1695 or #GTK_FONT_ALL to show all three font types.
1696 @foundries: a NULL-terminated array of strings containing foundry names which
1697 will be shown, or NULL to show all foundries.
1698 @weights: a NULL-terminated array of strings containing weight names which
1699 will be shown, or NULL to show all weights.
1700 @slants: a NULL-terminated array of strings containing slant names which
1701 will be shown, or NULL to show all slants.
1702 @setwidths: a NULL-terminated array of strings containing setwidth names which
1703 will be shown, or NULL to show all setwidths.
1704 @spacings: a NULL-terminated array of strings containing spacings which
1705 will be shown, or NULL to show all spacings.
1706 @charsets: a NULL-terminated array of strings containing charset names which
1707 will be shown, or NULL to show all charsets.
1708
1709 <!-- ##### FUNCTION gtk_identifier_get_type ##### -->
1710 <para>
1711 Get the type of GtkIdentifier.
1712 </para>
1713
1714 @Returns: GtkType -- the enumerated type of something.
1715
1716 <!-- ##### FUNCTION gtk_image_menu_item_add_image ##### -->
1717 <para>
1718
1719 </para>
1720
1721 @image_menu_item:
1722 @child:
1723
1724 <!-- ##### FUNCTION gtk_image_menu_item_get_type ##### -->
1725 <para>
1726
1727 </para>
1728
1729 @Returns:
1730
1731 <!-- ##### FUNCTION gtk_label_set_markup_with_accel ##### -->
1732 <para>
1733
1734 </para>
1735
1736 @label:
1737 @str:
1738 @Returns:
1739
1740 <!-- ##### FUNCTION gtk_list_store_new_with_types ##### -->
1741 <para>
1742
1743 </para>
1744
1745 @n_columns:
1746 @Varargs:
1747 @Returns:
1748
1749 <!-- ##### FUNCTION gtk_list_store_set_cell ##### -->
1750 <para>
1751
1752 </para>
1753
1754 @store:
1755 @iter:
1756 @column:
1757 @value:
1758
1759 <!-- ##### FUNCTION gtk_list_store_set_column_type ##### -->
1760 <para>
1761
1762 </para>
1763
1764 @store:
1765 @column:
1766 @type:
1767
1768 <!-- ##### FUNCTION gtk_list_store_set_n_columns ##### -->
1769 <para>
1770
1771 </para>
1772
1773 @store:
1774 @n_columns:
1775
1776 <!-- ##### FUNCTION gtk_menu_ensure_uline_accel_group ##### -->
1777 <para>
1778
1779 </para>
1780
1781 @menu:
1782 @Returns:
1783
1784 <!-- ##### FUNCTION gtk_menu_get_uline_accel_group ##### -->
1785 <para>
1786
1787 </para>
1788
1789 @menu:
1790 @Returns:
1791
1792 <!-- ##### FUNCTION gtk_menu_item_configure ##### -->
1793 <para>
1794 Sets whether the menu item should show a submenu indicator, which is a right
1795 arrow.
1796 </para>
1797
1798 @menu_item: the menu item
1799 @show_toggle_indicator: unused
1800 @show_submenu_indicator: whether to show the arrow or not
1801
1802 <!-- ##### MACRO gtk_notebook_set_page ##### -->
1803 <para>
1804 </para>
1805
1806 @notebook:
1807 @page_num:
1808
1809 <!-- ##### FUNCTION gtk_object_arg_get ##### -->
1810 <para>
1811 Private function to get an argument and argument info from an object.
1812 </para>
1813
1814 @object: the object whose argument should be retrieved.
1815 @arg: the argument, for the name on input, the rest is filled on output.
1816 @info: a #GtkArgInfo structure to optionally fill in.
1817
1818 <!-- ##### FUNCTION gtk_object_arg_get_info ##### -->
1819 <para>
1820 Query information about an argument type.
1821 </para>
1822
1823 @object_type: type of object to query about.
1824 @arg_name: name of the argument.
1825 @info_p: pointer to be filled in with a pointer to the GtkArgInfo.
1826 @Returns: an error message, or NULL on success.
1827 It is the caller's responsibility to call g_free() in the event of error.
1828
1829 <!-- ##### FUNCTION gtk_object_arg_set ##### -->
1830 <para>
1831 Private function to set an argument and argument info to an object.
1832 </para>
1833
1834 @object: the object whose argument should be set.
1835 @arg: the argument.
1836 @info: infomation about this type of argument in general.
1837
1838 <!-- ##### FUNCTION gtk_object_args_collect ##### -->
1839 <para>
1840 Private: Gets an array of #GtkArgs from a va_list C structure.
1841 </para>
1842
1843 @object_type: the type of object to collect arguments for.
1844 @arg_list_p: pointer to be filled in with a list of parsed arguments.
1845 @info_list_p: optional pointer for a returned list #GtkArgInfos.
1846 @first_arg_name: name of first argument.
1847 @var_args: value of first argument, followed by more key/value pairs,
1848 terminated by NULL.
1849 @Returns: an error message, or NULL on success.
1850 It is the caller's responsibility to call g_free() in the event of error.
1851
1852 <!-- ##### FUNCTION gtk_object_class_add_signals ##### -->
1853 <para>
1854 Add an array of signals to a #GtkObjectClass.
1855 Usually this is called when registering a new type of object.
1856 </para>
1857
1858 @klass: the object class to append signals to.
1859 @signals: the signals to append.
1860 @nsignals: the number of signals being appended.
1861
1862 <!-- ##### FUNCTION gtk_object_class_user_signal_new ##### -->
1863 <para>
1864 Define a signal-handler for a new signal on an already defined
1865 object.
1866 </para>
1867 <para>
1868 See the signal documentation for more general information.
1869 </para>
1870
1871 @klass: the object class to define the signal for.
1872 @name: the name of the signal.
1873 @signal_flags: the default emission behavior for the signal.
1874 See gtk_signal_new().
1875 @marshaller: a function that will take an array of GtkArgs
1876 and invoke the appropriate handler with the normal calling
1877 conventions.
1878 @return_val: specify the return-value type for the signal
1879 (or GTK_TYPE_NONE for no return-value).
1880 @nparams: specify the number of parameters the signal
1881 receives from the caller of gtk_signal_emit().
1882 @Varargs: list of nparams #GtkTypes to pass to the signal handlers.
1883 @Returns: the signal id.  (See #GtkSignals)
1884
1885 <!-- ##### FUNCTION gtk_object_class_user_signal_newv ##### -->
1886 <para>
1887 Define a signal-handler for a new signal on an already defined
1888 object.
1889 </para>
1890
1891 @klass: the object class to define the signal for.
1892 @name: the name of the signal.
1893 @signal_flags: the default emission behavior for the signal.
1894 See gtk_signal_new().
1895 @marshaller: takes a GtkObject, a #GtkSignalFunc, and an array
1896 of arguments, and invokes the function using the appropriate
1897 calling conventions.  Usually just select a function
1898 out of gtkmarshal.h.
1899 @return_val: specify the return-value type for the signal (possibly
1900 #GTK_TYPE_NONE).
1901 @nparams: specify the number of parameters the signal
1902 receives from the caller of gtk_signal_emit().
1903 @params: array of #GtkTypes the signal handlers for this signal
1904 should have in their prototype (of length nparams).
1905 @Returns: the signal id.  (See #GtkSignals)
1906
1907 <!-- ##### FUNCTION gtk_object_constructed ##### -->
1908 <para>
1909 Mark an allocated object as constructed.
1910 This is used for situations
1911 that require precise control of the construction process.
1912 </para>
1913 <para>
1914 This is done when gtk_object_default_construct() is inadequate.
1915 In #GtkCList the need arises because #GtkCList does construction work that
1916 must happen <emphasis>after</emphasis> its derivers.  This work
1917 cannot be done in an initializer function, so an alternate
1918 constructor is mandatory.  It calls gtk_object_constructed() to
1919 indicate it has done its job, so that no other constructor will
1920 be invoked.
1921 </para>
1922 <para>
1923 Normally this function is just automatically run from
1924 gtk_object_default_construct().
1925 </para>
1926
1927 @object: object which has been constructed.  This is usually
1928 done automatically by gtk_object_new() and gtk_object_newv().
1929
1930 <!-- ##### FUNCTION gtk_object_default_construct ##### -->
1931 <para>
1932 This function is called to construct arguments that haven't been initialized
1933 but have the #GTK_ARG_CONSTRUCT flag set.
1934 </para>
1935 <para>
1936 All number arguments are set to 0.  All pointers and strings
1937 are set to NULL.
1938 </para>
1939 <para>
1940 Normally invoked by gtk_object_new() automatically; gtk_type_new() can
1941 be used to bypass it.
1942 </para>
1943
1944 @object: the object to initialize.
1945
1946 <!-- ##### FUNCTION gtk_object_getv ##### -->
1947 <para>
1948 Gets an array of argument values from an object.
1949 </para>
1950
1951 @object: the object to get arguments from.
1952 @n_args: the number of arguments to query.
1953 @args: the arguments to fill in.
1954
1955 <!-- ##### FUNCTION gtk_object_newv ##### -->
1956 <para>
1957 Construct an object with an array of arguments.
1958 </para>
1959
1960 @object_type: the type of the object to create.
1961 @n_args: the number of arguments to set.
1962 @args: an array of n_args arguments (which are name and value pairs).
1963 @Returns: the new GtkObject.
1964
1965 <!-- ##### FUNCTION gtk_object_query_args ##### -->
1966 <para>
1967 Get all the arguments that may be used for a given type.
1968 </para>
1969 <para>
1970 In Java, this type of mechanism is called
1971 <wordasword>introspection</wordasword>.  It is used by applications
1972 like Glade, that have to determine what can be done to an object
1973 at run-time.
1974 </para>
1975
1976 @class_type: the GtkType of the ObjectClass
1977 (returned from GTK_OBJECT_CLASS(class)-&gt;type for example).
1978 @arg_flags: if non-NULL, obtains the #GtkArgFlags that apply to
1979 each argument.  You must g_free() this if you request it.
1980 @n_args: the number of arguments is returned in this field.
1981 @Returns: an array of arguments, that you must deallocate with g_free().
1982
1983 <!-- ##### FUNCTION gtk_object_setv ##### -->
1984 <para>
1985 Set an array of arguments.
1986 </para>
1987
1988 @object: the object whose arguments should be set.
1989 @n_args: the number of arguments to set.
1990 @args: the desired values, as an array of #GtkArgs (which contain
1991 the names, types, and values of the arguments).
1992
1993 <!-- ##### FUNCTION gtk_paned_compute_position ##### -->
1994 <para>
1995 Internal function used by #GtkHPaned and #GtkVPaned
1996 </para>
1997
1998 @paned:
1999 @allocation:
2000 @child1_req:
2001 @child2_req:
2002
2003 <!-- ##### FUNCTION gtk_paned_set_handle_size ##### -->
2004 <para>
2005 Set the the handle size to @size x @size pixels.
2006 </para>
2007
2008 @paned: a paned widget
2009 @size: the size in pixels
2010
2011 <!-- ##### FUNCTION gtk_pattern_match ##### -->
2012 <para>
2013
2014 </para>
2015
2016 @pspec:
2017 @string_length:
2018 @string:
2019 @string_reversed:
2020 @Returns:
2021
2022 <!-- ##### FUNCTION gtk_pattern_match_simple ##### -->
2023 <para>
2024
2025 </para>
2026
2027 @pattern:
2028 @string:
2029 @Returns:
2030
2031 <!-- ##### FUNCTION gtk_pattern_match_string ##### -->
2032 <para>
2033
2034 </para>
2035
2036 @pspec:
2037 @string:
2038 @Returns:
2039
2040 <!-- ##### FUNCTION gtk_pattern_spec_free_segs ##### -->
2041 <para>
2042
2043 </para>
2044
2045 @pspec:
2046
2047 <!-- ##### FUNCTION gtk_pattern_spec_init ##### -->
2048 <para>
2049
2050 </para>
2051
2052 @pspec:
2053 @pattern:
2054
2055 <!-- ##### FUNCTION gtk_rc_init ##### -->
2056 <para>
2057 Internal function.
2058 </para>
2059
2060
2061 <!-- ##### FUNCTION gtk_rc_load_image ##### -->
2062 <para>
2063 Internal function. Loads an image using the current
2064 image loader.
2065 </para>
2066
2067 @colormap: the colormap to use for the image
2068 @transparent_color: the transparent color for the image
2069 @filename: the filename of the image file
2070 @Returns: a #GtkPixmap representing @filename
2071
2072 <!-- ##### FUNCTION gtk_rc_set_image_loader ##### -->
2073 <para>
2074 Sets the function that GTK+ will use to load images
2075 </para>
2076
2077 @loader: the #GtkImageLoader to use
2078
2079 <!-- ##### FUNCTION gtk_ruler_draw_pos ##### -->
2080 <para>
2081
2082 </para>
2083
2084 @ruler: the gtkruler
2085
2086 <!-- ##### FUNCTION gtk_ruler_draw_ticks ##### -->
2087 <para>
2088
2089 </para>
2090
2091 @ruler: the gtkruler
2092
2093 <!-- ##### FUNCTION gtk_settings_get_global ##### -->
2094 <para>
2095
2096 </para>
2097
2098 @Returns:
2099
2100 <!-- ##### FUNCTION gtk_signal_add_emission_hook ##### -->
2101 <para>
2102 Add an emission hook for a type of signal, for any object.
2103 </para>
2104
2105 @signal_id: the type of signal to hook for.
2106 @hook_func: the function to invoke to handle the emission hook.
2107 @data: the user data passed in to hook_func.
2108 @Returns: the id (that you may pass as a parameter
2109 to gtk_signal_remove_emission_hook()).
2110 @i:
2111 @h:
2112 @d:
2113
2114 <!-- ##### FUNCTION gtk_signal_add_emission_hook_full ##### -->
2115 <para>
2116 Add an emission hook for a type of signal, for any object.
2117 (with control of what happens when the hook is
2118 destroyed).
2119 </para>
2120
2121 @signal_id: the type of signal add the hook for.
2122 @hook_func: the function to invoke to handle the hook.
2123 @data: the user data passed in to hook_func.
2124 @destroy: a function to invoke when the hook is destroyed,
2125 to clean up any allocation done just for this
2126 signal handler.
2127 @Returns: the id (that you may pass as a parameter
2128 to gtk_signal_remove_emission_hook()).
2129
2130 <!-- ##### FUNCTION gtk_signal_handler_pending_by_id ##### -->
2131 <para>
2132 Returns whether a connection id is valid (and optionally not blocked).
2133 </para>
2134
2135 @object: the object to search for the desired handler.
2136 @handler_id: the connection id.
2137 @may_be_blocked: whether it is acceptable to return a blocked
2138 handler.
2139 @Returns: TRUE if the signal exists and wasn't blocked,
2140 unless #may_be_blocked was specified.  FALSE otherwise.
2141
2142 <!-- ##### FUNCTION gtk_signal_handlers_destroy ##### -->
2143 <para>
2144 Destroy all the signal handlers connected to an object.
2145 This is done automatically when the object is destroyed.
2146 </para>
2147 <para>
2148 This function is labeled private.
2149 </para>
2150
2151 @object: the object whose signal handlers should be destroyed.
2152
2153 <!-- ##### FUNCTION gtk_signal_init ##### -->
2154 <para>
2155
2156 </para>
2157
2158
2159 <!-- ##### FUNCTION gtk_signal_n_emissions ##### -->
2160 <para>
2161 Find out the recursion depth of emissions for a particular type
2162 of signal and object.  (So it will
2163 always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified)
2164 This is a way to avoid recursion:  you can see if
2165 you are currently running in that signal handler and emit it only
2166 if you are.
2167 </para>
2168 <para>Another way to look at it is that this number increases
2169 by one when #gtk_signal_emit(), et al, are called,
2170 and decreases by one when #gtk_signal_emit() returns.
2171 </para>
2172
2173 @object: the object with the signal handler.
2174 @signal_id: the signal id.
2175 @Returns: the recursion depth of emissions of this signal for this
2176 object.
2177
2178 <!-- ##### FUNCTION gtk_signal_n_emissions_by_name ##### -->
2179 <para>
2180 Find out the recursion depth of emissions for a particular type
2181 of signal and object.  Just like gtk_signal_n_emissions()
2182 except it will lookup the signal id for you.
2183 </para>
2184
2185 @object: the object with the signal handler.
2186 @name: the signal name.
2187 @Returns: the recursion depth of emissions of this signal for this
2188 object.
2189
2190 <!-- ##### FUNCTION gtk_signal_query ##### -->
2191 <para>
2192 Obtain information about a signal.
2193 </para>
2194
2195 @signal_id: the signal type identifier.
2196 @Returns: a pointer to a GtkSignalQuery structure
2197 which contains all the information, or NULL.
2198 The pointer is allocated just for you:  you must g_free() it.
2199
2200 <!-- ##### FUNCTION gtk_signal_remove_emission_hook ##### -->
2201 <para>
2202 Delete an emission hook. (see gtk_signal_add_emission_hook())
2203 </para>
2204
2205 @signal_id: the id of the signal type.
2206 @hook_id: the id of the emission handler, returned by add_emission_hook().
2207 @i:
2208 @h:
2209
2210 <!-- ##### FUNCTION gtk_signal_set_funcs ##### -->
2211 <para>
2212 These set default functions to call when the user didn't
2213 supply a function when connecting.  (These are rarely
2214 used, and probably only for language bindings)
2215 </para>
2216 <para>
2217 By default, there are no such functions.
2218 </para>
2219
2220 @marshal_func: the function to invoke on every handlers for which there
2221 isn't a function pointer.  May be NULL.
2222 @destroy_func: the function to invoke when each hook is destroyed.
2223 May be NULL.
2224
2225 <!-- ##### FUNCTION gtk_spin_button_set_shadow_type ##### -->
2226 <para>
2227 Creates a border around the arrows of a #GtkSpinButton. The type of border is determined by @shadow_type.
2228 </para>
2229
2230 @spin_button: a #GtkSpinButton
2231 @shadow_type: the new border type.
2232
2233 <!-- ##### FUNCTION gtk_stock_list_items ##### -->
2234 <para>
2235
2236 </para>
2237
2238 @Returns:
2239
2240 <!-- ##### FUNCTION gtk_text_buffer_paste_primary ##### -->
2241 <para>
2242
2243 </para>
2244
2245 @buffer:
2246 @override_location:
2247 @default_editable:
2248
2249 <!-- ##### FUNCTION gtk_text_iter_reorder ##### -->
2250 <para>
2251
2252 </para>
2253
2254 @first:
2255 @second:
2256
2257 <!-- ##### FUNCTION gtk_text_iter_spew ##### -->
2258 <para>
2259
2260 </para>
2261
2262 @iter:
2263 @desc:
2264
2265 <!-- ##### FUNCTION gtk_text_view_set_text_window_size ##### -->
2266 <para>
2267
2268 </para>
2269
2270 @text_view:
2271 @width:
2272 @height:
2273
2274 <!-- ##### FUNCTION gtk_trace_referencing ##### -->
2275 <para>
2276 Private: print debugging information while doing a gtk_object_ref() or
2277 a gtk_object_unref().
2278 </para>
2279
2280 @object: object to reference or unreference.
2281 @func: name of caller's function to print (used within macros).
2282 @dummy: unused.
2283 @line: line number (used within macros).
2284 @do_ref: whether to reference or unreference.
2285
2286 <!-- ##### FUNCTION gtk_tree_model_ref_iter ##### -->
2287 <para>
2288
2289 </para>
2290
2291 @tree_model:
2292 @iter:
2293
2294 <!-- ##### FUNCTION gtk_tree_model_sort_set_compare ##### -->
2295 <para>
2296
2297 </para>
2298
2299 @tree_model_sort:
2300 @func:
2301
2302 <!-- ##### FUNCTION gtk_tree_model_sort_set_sort_column ##### -->
2303 <para>
2304
2305 </para>
2306
2307 @tree_model_sort:
2308 @sort_col:
2309
2310 <!-- ##### FUNCTION gtk_tree_model_unref_iter ##### -->
2311 <para>
2312
2313 </para>
2314
2315 @tree_model:
2316 @iter:
2317
2318 <!-- ##### FUNCTION gtk_tree_store_new_with_types ##### -->
2319 <para>
2320
2321 </para>
2322
2323 @n_columns:
2324 @Varargs:
2325 @Returns:
2326
2327 <!-- ##### FUNCTION gtk_tree_store_set_cell ##### -->
2328 <para>
2329
2330 </para>
2331
2332 @tree_store:
2333 @iter:
2334 @column:
2335 @value:
2336
2337 <!-- ##### FUNCTION gtk_tree_store_set_column_type ##### -->
2338 <para>
2339
2340 </para>
2341
2342 @tree_store:
2343 @column:
2344 @type:
2345 @store:
2346
2347 <!-- ##### FUNCTION gtk_tree_store_set_n_columns ##### -->
2348 <para>
2349
2350 </para>
2351
2352 @tree_store:
2353 @n_columns:
2354
2355 <!-- ##### FUNCTION gtk_tree_view_column_set_cell_data ##### -->
2356 <para>
2357
2358 </para>
2359
2360 @tree_column:
2361 @tree_model:
2362 @iter:
2363
2364 <!-- ##### FUNCTION gtk_tree_view_column_set_width ##### -->
2365 <para>
2366
2367 </para>
2368
2369 @tree_column:
2370 @width:
2371 @size:
2372
2373 <!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
2374 <para>
2375 Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make
2376 sure that it's okay to cast something of that @klass into a @cast_type.
2377 </para>
2378
2379 @klass: GtkTypeClass*
2380 @cast_type: GtkType
2381 @Returns: Always return @klass.
2382
2383 <!-- ##### FUNCTION gtk_type_check_object_cast ##### -->
2384 <para>
2385 Given a pointer to a GtkTypeObject @type_object, and a GtkType @cast_type,
2386 make sure that it's okay to cast @type_object into a @cast_type.
2387 </para>
2388
2389 @type_object: GtkTypeObject*
2390 @cast_type: GtkType
2391 @Returns: the same GtkTypeObject* as @type_object
2392
2393 <!-- ##### FUNCTION gtk_type_children_types ##### -->
2394 <para>
2395 Return the pointer to the type's children's types.
2396 </para>
2397
2398 @type: GtkType
2399 @Returns: pointer to a GList
2400
2401 <!-- ##### FUNCTION gtk_type_describe_heritage ##### -->
2402 <para>
2403 Print the types @type inherits from.
2404 </para>
2405
2406 @type: GtkType
2407
2408 <!-- ##### FUNCTION gtk_type_describe_tree ##### -->
2409 <para>
2410 Given a @type, describe all of its children, and their children.  Only
2411 show the size if @show_size is true.
2412 </para>
2413
2414 @type: GtkType
2415 @show_size: gboolean
2416
2417 <!-- ##### FUNCTION gtk_type_free ##### -->
2418 <para>
2419 Given the type of an object and a pointer to it, the object is freed.
2420 </para>
2421
2422 @type: GtkType
2423 @mem: gpointer to the object
2424
2425 <!-- ##### FUNCTION gtk_type_get_varargs_type ##### -->
2426 <para>
2427 Get the varargs type associated with @foreign_type
2428 </para>
2429
2430 @foreign_type: GtkType
2431 @Returns: GtkType
2432
2433 <!-- ##### FUNCTION gtk_type_parent_class ##### -->
2434 <para>
2435 Return the class of the parent.  Initialize the class if necessary.
2436 Return NULL if anything goes wrong.
2437 </para>
2438
2439 @type: GtkType
2440 @Returns: gpointer to the klass.
2441
2442 <!-- ##### FUNCTION gtk_type_query ##### -->
2443 <para>
2444 Given a type, return various interesting parameters of the type.
2445 </para>
2446
2447 @type: GtkType
2448 @Returns: GtkTypeQuery*
2449
2450 <!-- ##### FUNCTION gtk_type_register_enum ##### -->
2451 <para>
2452 Register a new set of enum @values and give them the name in
2453 @type_name.
2454 </para>
2455
2456 @type_name: must not be null.
2457 @values: GtkEnumValue*
2458 @Returns:
2459
2460 <!-- ##### FUNCTION gtk_type_register_flags ##### -->
2461 <para>
2462 Register a new set of flags @values and give them the name in
2463 @type_name.
2464 </para>
2465
2466 @type_name: must not be null.
2467 @values: GtkFlagValue*
2468 @Returns:
2469
2470 <!-- ##### FUNCTION gtk_type_set_chunk_alloc ##### -->
2471 <para>
2472 Set the mem_chunk size so it will hold @n_chunks of the objects of that @type.
2473 </para>
2474
2475 @type: There must be an unlocked TypeNode associated with this type otherwise nothing happens.
2476 @n_chunks:
2477
2478 <!-- ##### FUNCTION gtk_type_set_varargs_type ##### -->
2479 <para>
2480 Set the varargs type for a fundamental type @foreign_type.
2481 </para>
2482
2483 @foreign_type: Must be a GtkType with a sequence number of zero.  Must not be a
2484 fundamental type.
2485 @varargs_type: Must be a GtkType which is either structured or flag, or NONE.
2486
2487 <!-- ##### FUNCTION gtk_widget_activate_mnemonic ##### -->
2488 <para>
2489
2490 </para>
2491
2492 @widget:
2493 @group_cycling:
2494 @Returns:
2495
2496 <!-- ##### FUNCTION gtk_widget_pop_style ##### -->
2497 <para>
2498
2499 </para>
2500
2501
2502 <!-- ##### FUNCTION gtk_widget_popup ##### -->
2503 <para>
2504
2505 </para>
2506
2507 @widget:
2508 @x:
2509 @y:
2510
2511 <!-- ##### FUNCTION gtk_widget_push_style ##### -->
2512 <para>
2513
2514 </para>
2515
2516 @style:
2517
2518 <!-- ##### FUNCTION gtk_widget_set_default_style ##### -->
2519 <para>
2520
2521 </para>
2522
2523 @style:
2524
2525 <!-- ##### FUNCTION gtk_window_activate_mnemonic ##### -->
2526 <para>
2527
2528 </para>
2529
2530 @window:
2531 @keyval:
2532 @modifier:
2533 @Returns:
2534
2535 <!-- ##### FUNCTION gtk_window_get_default_accel_group ##### -->
2536 <para>
2537
2538 </para>
2539
2540 @window:
2541 @Returns:
2542
2543 <!-- ##### FUNCTION gtk_window_get_resizeable ##### -->
2544 <para>
2545
2546 </para>
2547
2548 @window:
2549 @Returns:
2550
2551 <!-- ##### FUNCTION gtk_window_set_decorations_hint ##### -->
2552 <para>
2553
2554 </para>
2555
2556 @window:
2557 @decorations:
2558
2559 <!-- ##### FUNCTION gtk_window_set_functions_hint ##### -->
2560 <para>
2561
2562 </para>
2563
2564 @window:
2565 @functions:
2566
2567 <!-- ##### FUNCTION gtk_window_set_resizeable ##### -->
2568 <para>
2569
2570 </para>
2571
2572 @window:
2573 @setting:
2574 @resizeable:
2575