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