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/gtkmarshal.sgml:Long_Description ##### -->
 105 <refsect2>
 106 <title>What are Signal Marshallers?</title>
 107 <para>
 108 Marshals are functions which all have the same prototype:
 109 they take a #GtkObject, a #GtkSignalFunc, a #gpointer,
 110 and an array of argument values.
 111 The functions are names gtk_marshall_RETURNTYPE__PARAMTYPE1_PARAMTYPE2....
 112 </para>
 113 <para>
 114 They then call a native function:  the GtkObject is the first
 115 parameter passed in.  The arguments are passed in the native
 116 calling convention:  chars, shorts, ints, longs may be packed
 117 on the stack, or tucked in registers:  it doesn't matter
 118 because the same calling convention will be generated
 119 inside the gtkmarshal code as is expected where you define
 120 your handlers.
 121 </para>
 122 <para>
 123 So the function named:
 124 <programlisting>
 125 gtk_marshal_BOOL__POINTER_INT_INT_UINT(GtkObject*, GtkSignalFunc, gpointer, GtkArg*);
 126 </programlisting>
 127 will call the #GtkSignalFunc assuming it was a function with signature:
 128 <programlisting>
 129 gboolean sigfunc(gpointer,gint,gint,guint);
 130 </programlisting>
 131 </para>
 132 </refsect2>
 133 <refsect2>
 134 <title>Writing Custom Marshals</title>
 135 <para>
 136 Marshals are primarily used as arguments to gtk_signal_new().
 137 Sometimes, you may find that a marshaller you need isn't available
 138 in the standard list.  Then you have to write your own.
 139 </para>
 140 <para>
 141 If you wish to define a signal with a new type of argument list.
 142 Suppose you want 2 pointers and 2 integers.
 143 You would write:
 144 <programlisting>
 145 typedef int (*GtkSignal_INT__POINTER_POINTER_INT_INT)(
 146                         gpointer, gpointer, gint, gint
 147 );
 148
 149 void marshal_INT__POINTER_POINTER_INT_INT(GtkObject*    object,
 150                                            GtkSignalFunc func,
 151                                            gpointer      func_data,
 152                                            GtkArg*       args)
 153 {
 154         GtkSignal_NONE__POINTER_POINTER_INT_INT rfunc;
 155         gint* return_val;
 156         return_val = GTK_RETLOC_INT(args[4]);
 157         rfunc = (GtkSignal_INT__POINTER_POINTER_INT_INT)func;
 158         *return_val = (*rfunc)(object,
 159                                GTK_VALUE_POINTER(args[0]),
 160                                GTK_VALUE_POINTER(args[1]),
 161                                GTK_VALUE_INT(args[2]),
 162                                GTK_VALUE_INT(args[3]),
 163                                func_data);
 164 }
 165 </programlisting>
 166 </para>
 167 </refsect2>
 168
 169
 170 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:See_Also ##### -->
 171 <para>
 172 <variablelist>
 173
 174 <varlistentry>
 175 <term>#GtkSignal</term>
 176 <listitem><para>The signal handling functions (of which marshallers are
 177 really an implementation detail).</para></listitem>
 178 </varlistentry>
 179
 180 </variablelist>
 181 </para>
 182
 183
 184 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Short_Description ##### -->
 185 Functions to adapt C structures to native calling convention.
 186
 187
 188 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Title ##### -->
 189 Signal Marshallers
 190
 191
 192 <!-- ##### SECTION ./tmpl/gtkpacker.sgml:Long_Description ##### -->
 193 <para>
 194
 195 </para>
 196
 197
 198 <!-- ##### SECTION ./tmpl/gtkpacker.sgml:See_Also ##### -->
 199 <para>
 200
 201 </para>
 202
 203
 204 <!-- ##### SECTION ./tmpl/gtkpacker.sgml:Short_Description ##### -->
 205
 206
 207
 208 <!-- ##### SECTION ./tmpl/gtkpacker.sgml:Title ##### -->
 209 GtkPacker
 210
 211
 212 <!-- ##### SECTION ./tmpl/gtkprivate.sgml:Title ##### -->
 213 Private Information
 214
 215
 216 <!-- ##### SECTION ./tmpl/gtkthemes.sgml:Long_Description ##### -->
 217 <para>
 218
 219 </para>
 220
 221
 222 <!-- ##### SECTION ./tmpl/gtkthemes.sgml:See_Also ##### -->
 223 <para>
 224
 225 </para>
 226
 227
 228 <!-- ##### SECTION ./tmpl/gtkthemes.sgml:Short_Description ##### -->
 229
 230
 231
 232 <!-- ##### SECTION ./tmpl/gtkthemes.sgml:Stability_Level ##### -->
 233
 234
 235
 236 <!-- ##### SECTION ./tmpl/gtkthemes.sgml:Title ##### -->
 237 Themes
 238
 239
 240 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Long_Description ##### -->
 241 <para>
 242
 243 </para>
 244
 245
 246 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:See_Also ##### -->
 247 <para>
 248
 249 </para>
 250
 251
 252 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Short_Description ##### -->
 253
 254
 255
 256 <!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Title ##### -->
 257 GtkModelSimple
 258
 259
 260 <!-- ##### MACRO GTK_CLIST_CHILD_HAS_FOCUS ##### -->
 261 <para>
 262 A macro to check whether a child widget of the CList
 263 has the focus.
 264 </para>
 265
 266 @clist: The #GtkCList widget to check.
 267
 268 <!-- ##### MACRO GTK_ICON_SIZE_BUTTON ##### -->
 269 <para>
 270
 271 </para>
 272
 273
 274 <!-- ##### MACRO GTK_ICON_SIZE_DIALOG ##### -->
 275 <para>
 276
 277 </para>
 278
 279
 280 <!-- ##### MACRO GTK_ICON_SIZE_LARGE_TOOLBAR ##### -->
 281 <para>
 282
 283 </para>
 284
 285
 286 <!-- ##### MACRO GTK_ICON_SIZE_MENU ##### -->
 287 <para>
 288
 289 </para>
 290
 291
 292 <!-- ##### MACRO GTK_ICON_SIZE_SMALL_TOOLBAR ##### -->
 293 <para>
 294
 295 </para>
 296
 297
 298 <!-- ##### MACRO GTK_IS_TIPS_QUERY ##### -->
 299 <para>
 300
 301 </para>
 302
 303 @obj:
 304
 305 <!-- ##### MACRO GTK_IS_TIPS_QUERY_CLASS ##### -->
 306 <para>
 307
 308 </para>
 309
 310 @klass:
 311
 312 <!-- ##### MACRO GTK_OBJECT_CONNECTED ##### -->
 313 <para>
 314 Tests whether a #GtkObject has had a signal connected to it.
 315 </para>
 316
 317 @obj: the object to examine.
 318
 319 <!-- ##### MACRO GTK_OBJECT_CONSTRUCTED ##### -->
 320 <para>
 321 Test whether a GtkObject's arguments have been prepared.
 322 </para>
 323
 324 @obj: the object to examine.
 325
 326 <!-- ##### MACRO GTK_OBJECT_DESTROYED ##### -->
 327 <para>
 328 Test whether a GtkObject has had gtk_object_destroy() invoked on it.
 329 </para>
 330
 331 @obj: the object to examine.
 332
 333 <!-- ##### MACRO GTK_OBJECT_NSIGNALS ##### -->
 334 <para>
 335 Get the number of signals defined by this object.
 336 </para>
 337
 338 @obj: the object to query.
 339
 340 <!-- ##### MACRO GTK_OBJECT_SET_FLAGS ##### -->
 341 <para>
 342 Turns on certain object flags.  (Private)
 343 </para>
 344
 345 @obj: the object to affect.
 346 @flag: the flags to set.
 347
 348 <!-- ##### MACRO GTK_OBJECT_SIGNALS ##### -->
 349 <para>
 350 Get the array of signals defined for this object.
 351 </para>
 352
 353 @obj: the object to fetch the signals from.
 354
 355 <!-- ##### MACRO GTK_OBJECT_UNSET_FLAGS ##### -->
 356 <para>
 357 Turns off certain object flags.  (Private)
 358 </para>
 359
 360 @obj: the object to affect.
 361 @flag: the flags to unset.
 362
 363 <!-- ##### MACRO GTK_PRINT_SETTINGS_NUM_COPIES ##### -->
 364 <para>
 365
 366 </para>
 367
 368
 369 <!-- ##### MACRO GTK_PRINT_SETTINGS_PRINT_TO_FILE ##### -->
 370 <para>
 371
 372 </para>
 373
 374
 375 <!-- ##### MACRO GTK_STOCK_BUTTON_APPLY ##### -->
 376 <para>
 377
 378 </para>
 379
 380
 381 <!-- ##### MACRO GTK_STOCK_BUTTON_CANCEL ##### -->
 382 <para>
 383
 384 </para>
 385
 386
 387 <!-- ##### MACRO GTK_STOCK_BUTTON_CLOSE ##### -->
 388 <para>
 389
 390 </para>
 391
 392
 393 <!-- ##### MACRO GTK_STOCK_BUTTON_NO ##### -->
 394 <para>
 395
 396 </para>
 397
 398
 399 <!-- ##### MACRO GTK_STOCK_BUTTON_OK ##### -->
 400 <para>
 401
 402 </para>
 403
 404
 405 <!-- ##### MACRO GTK_STOCK_BUTTON_YES ##### -->
 406 <para>
 407
 408 </para>
 409
 410
 411 <!-- ##### MACRO GTK_TIPS_QUERY ##### -->
 412 <para>
 413
 414 </para>
 415
 416 @obj:
 417
 418 <!-- ##### MACRO GTK_TIPS_QUERY_CLASS ##### -->
 419 <para>
 420
 421 </para>
 422
 423 @klass:
 424
 425 <!-- ##### MACRO GTK_TIPS_QUERY_GET_CLASS ##### -->
 426 <para>
 427
 428 </para>
 429
 430 @obj:
 431
 432 <!-- ##### MACRO GTK_TREE_MODEL_GET_IFACE ##### -->
 433 <para>
 434
 435 </para>
 436
 437 @obj:
 438
 439 <!-- ##### MACRO GTK_TREE_SELECTION ##### -->
 440 <para>
 441 A macro that returns a GList that contains the selection of the root tree of @obj.
 442 </para>
 443
 444 @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.
 445
 446 <!-- ##### MACRO GTK_TYPE_FLAT_FIRST ##### -->
 447 <para>
 448 The first "flat" (no struct) enumerated type value.
 449 </para>
 450
 451
 452 <!-- ##### MACRO GTK_TYPE_FLAT_LAST ##### -->
 453 <para>
 454 The last "flat" (no struct) enumerated type value.
 455 </para>
 456
 457
 458 <!-- ##### MACRO GTK_TYPE_IDENTIFIER ##### -->
 459 <para>
 460 Hide the name of gtk_identifier_get_type
 461 </para>
 462
 463
 464 <!-- ##### MACRO GTK_TYPE_MAKE ##### -->
 465 <para>
 466 Combine a fundemantal type and a sequence number to create a gtk type.
 467 </para>
 468
 469 @parent_t:
 470 @seqno:
 471
 472 <!-- ##### MACRO GTK_TYPE_NUM_BUILTINS ##### -->
 473 <para>
 474 No idea.
 475 </para>
 476
 477
 478 <!-- ##### MACRO GTK_TYPE_SEQNO ##### -->
 479 <para>
 480 Convert a gtk type into its sequence number
 481 </para>
 482
 483 @type:
 484
 485 <!-- ##### MACRO GTK_TYPE_STRUCTURED_FIRST ##### -->
 486 <para>
 487 The first structured enumerated type value.
 488 </para>
 489
 490
 491 <!-- ##### MACRO GTK_TYPE_STRUCTURED_LAST ##### -->
 492 <para>
 493 The last structured enumerated type value.
 494 </para>
 495
 496
 497 <!-- ##### MACRO GTK_TYPE_TIPS_QUERY ##### -->
 498 <para>
 499
 500 </para>
 501
 502
 503 <!-- ##### MACRO GTK_TYPE_TREE_COLUMN ##### -->
 504 <para>
 505
 506 </para>
 507
 508
 509 <!-- ##### MACRO GTK_TYPE_TREE_VIEW_COLUMN ##### -->
 510 <para>
 511
 512 </para>
 513
 514
 515 <!-- ##### MACRO GTK_VALUE_ARGS ##### -->
 516 <para>
 517 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS
 518 </para>
 519
 520 @a:
 521
 522 <!-- ##### MACRO GTK_VALUE_CALLBACK ##### -->
 523 <para>
 524 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK
 525 </para>
 526
 527 @a:
 528
 529 <!-- ##### MACRO GTK_VALUE_C_CALLBACK ##### -->
 530 <para>
 531 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK
 532 </para>
 533
 534 @a:
 535
 536 <!-- ##### MACRO GTK_VALUE_FOREIGN ##### -->
 537 <para>
 538 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
 539 </para>
 540
 541 @a:
 542
 543 <!-- ##### USER_FUNCTION GValueCompareFunc ##### -->
 544 <para>
 545
 546 </para>
 547
 548 @a:
 549 @b:
 550 @Returns:
 551
 552 <!-- ##### ARG GtkAboutDialog:link-color ##### -->
 553 <para>
 554
 555 </para>
 556
 557
 558 <!-- ##### ARG GtkAboutDialog:name ##### -->
 559 <para>
 560
 561 </para>
 562
 563
 564 <!-- ##### STRUCT GtkAccelEntry ##### -->
 565 <para>
 566 This is a private struct used by GTK+ internally, don't worry about it.
 567 </para>
 568
 569 @accel_group:
 570 @accelerator_key:
 571 @accelerator_mods:
 572 @accel_flags:
 573 @object:
 574 @signal_id:
 575
 576 <!-- ##### ARG GtkAccelLabel:accel-object ##### -->
 577 <para>
 578
 579 </para>
 580
 581
 582 <!-- ##### ARG GtkAccelLabel:accel-width ##### -->
 583 <para>
 584
 585 </para>
 586
 587
 588 <!-- ##### USER_FUNCTION GtkAccelMapNotify ##### -->
 589 <para>
 590
 591 </para>
 592
 593 @data:
 594 @accel_path_quark:
 595 @accel_key:
 596 @accel_mods:
 597 @accel_group:
 598 @old_accel_key:
 599 @old_accel_mods:
 600
 601 <!-- ##### SIGNAL GtkAction::connect-proxy ##### -->
 602 <para>
 603
 604 </para>
 605
 606 @action: the object which received the signal.
 607 @widget:
 608
 609 <!-- ##### SIGNAL GtkAction::disconnect-proxy ##### -->
 610 <para>
 611
 612 </para>
 613
 614 @action: the object which received the signal.
 615 @widget:
 616
 617 <!-- ##### USER_FUNCTION GtkArgGetFunc ##### -->
 618 <para>
 619 Define a function pointer.  Deprecated.
 620 </para>
 621
 622 @object:
 623 @arg:
 624 @arg_id:
 625
 626 <!-- ##### STRUCT GtkArgInfo ##### -->
 627 <para>
 628 A structure containing information about the argument.
 629 Returned by gtk_arg_get_info().
 630 </para>
 631
 632 @class_type: if the argument is an object, this is the object class type.
 633 @name: the name of the argument.
 634 @type: the type of the argument; it may be an object's type
 635 or a fundamental type.
 636 @arg_flags: flags applicable to the argument (i.e. readable, writable,
 637 and whether it needs to be constructed).
 638 @full_name: the object name and argument name separated by ::,
 639 e.g. "GtkObject::user_data" or "GtkButton::label".
 640 @arg_id: the unique argument identified.
 641 @seq_id: ???
 642
 643 <!-- ##### USER_FUNCTION GtkArgSetFunc ##### -->
 644 <para>
 645 Define a function pointer.  Deprecated.
 646 </para>
 647
 648 @object:
 649 @arg:
 650 @arg_id:
 651
 652 <!-- ##### STRUCT GtkBuilderClass ##### -->
 653 <para>
 654
 655 </para>
 656
 657 @get_type_from_name: Looks up a type by name. The default
 658   implementation applies heuristics to map type names to
 659   <function>_get_type</function> function names, e.g.
 660   GtkHBox to gtk_hbox_get_type(). This virtual function
 661   is provided to allow language bindings to intercept the
 662   type resolution process.
 663
 664 <!-- ##### STRUCT GtkCellRendererTextPixbuf ##### -->
 665 <para>
 666
 667 </para>
 668
 669 @parent:
 670
 671 <!-- ##### ARG GtkCellView:use-fg ##### -->
 672 <para>
 673
 674 </para>
 675
 676
 677 <!-- ##### ARG GtkColorSelection:previous-alpha ##### -->
 678 <para>
 679
 680 </para>
 681
 682
 683 <!-- ##### ARG GtkColorSelection:previous-color ##### -->
 684 <para>
 685
 686 </para>
 687
 688
 689 <!-- ##### SIGNAL GtkComboBox::popup-hide ##### -->
 690 <para>
 691
 692 </para>
 693
 694 @combobox: the object which received the signal.
 695
 696 <!-- ##### SIGNAL GtkComboBox::popup-show ##### -->
 697 <para>
 698
 699 </para>
 700
 701 @combobox: the object which received the signal.
 702
 703 <!-- ##### ARG GtkComboBox:appearance ##### -->
 704 <para>
 705
 706 </para>
 707
 708
 709 <!-- ##### ARG GtkComboBox:row-separator-column ##### -->
 710 <para>
 711
 712 </para>
 713
 714
 715 <!-- ##### SIGNAL GtkContainer::focus ##### -->
 716 <para>
 717
 718 </para>
 719
 720 @container: the object which received the signal.
 721 @direction:
 722 @Returns:
 723
 724 <!-- ##### ARG GtkContainer:reallocate-redraws ##### -->
 725 <para>
 726
 727 </para>
 728
 729
 730 <!-- ##### STRUCT GtkData ##### -->
 731 <para>
 732 The #GtkData-struct struct contains no public fields.
 733 </para>
 734
 735
 736 <!-- ##### SIGNAL GtkData::disconnect ##### -->
 737 <para>
 738 Emitted to notify any views on the #GtkData object to disconnect from it,
 739 possibly because the #GtkData object is about to be destroyed.
 740 </para>
 741
 742 @data: the object which received the signal.
 743
 744 <!-- ##### SIGNAL GtkEditable::activate ##### -->
 745 <para>
 746 Indicates that the user has activated the widget
 747 in some fashion. Generally, this will be done
 748 with a keystroke. (The default binding for this
 749 action is Return for #GtkEntry and
 750 Control-Return for #GtkText.)
 751 </para>
 752
 753 @editable: the object which received the signal.
 754
 755 <!-- ##### SIGNAL GtkEditable::copy-clipboard ##### -->
 756 <para>
 757 An action signal. Causes the characters in the current selection to
 758 be copied to the clipboard.
 759 </para>
 760
 761 @editable: the object which received the signal.
 762
 763 <!-- ##### SIGNAL GtkEditable::cut-clipboard ##### -->
 764 <para>
 765 An action signal. Causes the characters in the current
 766 selection to be copied to the clipboard and then deleted from
 767 the widget.
 768 </para>
 769
 770 @editable: the object which received the signal.
 771
 772 <!-- ##### SIGNAL GtkEditable::kill-char ##### -->
 773 <para>
 774 An action signal. Delete a single character.
 775 </para>
 776
 777 @editable: the object which received the signal.
 778 @direction: the direction in which to delete. Positive
 779    indicates forward deletion, negative, backwards deletion.
 780
 781 <!-- ##### SIGNAL GtkEditable::kill-line ##### -->
 782 <para>
 783 An action signal. Delete a single line.
 784 </para>
 785
 786 @editable: the object which received the signal.
 787 @direction: the direction in which to delete. Positive
 788    indicates forward deletion, negative, backwards deletion.
 789
 790 <!-- ##### SIGNAL GtkEditable::kill-word ##### -->
 791 <para>
 792 An action signal. Delete a single word.
 793 </para>
 794
 795 @editable: the object which received the signal.
 796 @direction: the direction in which to delete. Positive
 797    indicates forward deletion, negative, backwards deletion.
 798
 799 <!-- ##### SIGNAL GtkEditable::move-cursor ##### -->
 800 <para>
 801 An action signal. Move the cursor position.
 802 </para>
 803
 804 @editable: the object which received the signal.
 805 @x: horizontal distance to move the cursor.
 806 @y: vertical distance to move the cursor.
 807
 808 <!-- ##### SIGNAL GtkEditable::move-page ##### -->
 809 <para>
 810 An action signal. Move the cursor by pages.
 811 </para>
 812
 813 @editable: the object which received the signal.
 814 @x: Number of pages to move the cursor horizontally.
 815 @y: Number of pages to move the cursor vertically.
 816
 817 <!-- ##### SIGNAL GtkEditable::move-to-column ##### -->
 818 <para>
 819 An action signal. Move the cursor to the given column.
 820 </para>
 821
 822 @editable: the object which received the signal.
 823 @column: the column to move to. (A negative value indicates
 824          the last column)
 825
 826 <!-- ##### SIGNAL GtkEditable::move-to-row ##### -->
 827 <para>
 828 An action signal. Move the cursor to the given row.
 829 </para>
 830
 831 @editable: the object which received the signal.
 832 @row: the row to move to. (A negative value indicates
 833       the last row)
 834
 835 <!-- ##### SIGNAL GtkEditable::move-word ##### -->
 836 <para>
 837 An action signal. Move the cursor by words.
 838 </para>
 839
 840 @editable: the object which received the signal.
 841 @num_words: The number of words to move the
 842 cursor. (Can be negative).
 843
 844 <!-- ##### SIGNAL GtkEditable::paste-clipboard ##### -->
 845 <para>
 846 An action signal. Causes the contents of the clipboard to
 847 be pasted into the editable widget at the current cursor
 848 position.
 849 </para>
 850
 851 @editable: the object which received the signal.
 852
 853 <!-- ##### SIGNAL GtkEditable::set-editable ##### -->
 854 <para>
 855 Determines if the user can edit the text in the editable
 856 widget or not. This is meant to be overriden by
 857 child classes and should not generally useful to
 858 applications.
 859 </para>
 860
 861 @editable: the object which received the signal.
 862 @is_editable: %TRUE if the user is allowed to edit the text
 863   in the widget.
 864
 865 <!-- ##### ARG GtkEditable:editable ##### -->
 866 <para>
 867 A boolean indicating whether the widget is editable by
 868 the user.
 869 </para>
 870
 871
 872 <!-- ##### ARG GtkEditable:text-position ##### -->
 873 <para>
 874 The position of the cursor.
 875 </para>
 876
 877
 878 <!-- ##### USER_FUNCTION GtkEmissionHook ##### -->
 879 <para>
 880 A simple function pointer to get invoked when the
 881 signal is emitted.  This allows you tie a hook to the signal type,
 882 so that it will trap all emissions of that signal, from any object.
 883 </para>
 884 <para>
 885 You may not attach these to signals created with the
 886 #GTK_RUN_NO_HOOKS flag.
 887 </para>
 888
 889 @object:
 890 @signal_id:
 891 @n_params:
 892 @params:
 893 @data:
 894 @Returns:
 895
 896 <!-- ##### SIGNAL GtkEntry::changed ##### -->
 897 <para>
 898
 899 </para>
 900
 901 @entry: the object which received the signal.
 902
 903 <!-- ##### SIGNAL GtkEntry::delete-text ##### -->
 904 <para>
 905
 906 </para>
 907
 908 @entry: the object which received the signal.
 909 @arg1:
 910 @arg2:
 911
 912 <!-- ##### SIGNAL GtkEntry::insert-text ##### -->
 913 <para>
 914
 915 </para>
 916
 917 @entry: the object which received the signal.
 918 @arg1:
 919 @arg2:
 920 @arg3:
 921
 922 <!-- ##### ARG GtkEntry:text-position ##### -->
 923 <para>
 924
 925 </para>
 926
 927
 928 <!-- ##### ARG GtkFileChooser:action ##### -->
 929 <para>
 930
 931 </para>
 932
 933
 934 <!-- ##### ARG GtkFileChooser:do-overwrite-confirmation ##### -->
 935 <para>
 936
 937 </para>
 938
 939
 940 <!-- ##### ARG GtkFileChooser:extra-widget ##### -->
 941 <para>
 942
 943 </para>
 944
 945
 946 <!-- ##### ARG GtkFileChooser:file-system ##### -->
 947 <para>
 948
 949 </para>
 950
 951
 952 <!-- ##### ARG GtkFileChooser:file-system-backend ##### -->
 953 <para>
 954
 955 </para>
 956
 957
 958 <!-- ##### ARG GtkFileChooser:filter ##### -->
 959 <para>
 960
 961 </para>
 962
 963
 964 <!-- ##### ARG GtkFileChooser:local-only ##### -->
 965 <para>
 966
 967 </para>
 968
 969
 970 <!-- ##### ARG GtkFileChooser:preview-widget ##### -->
 971 <para>
 972
 973 </para>
 974
 975
 976 <!-- ##### ARG GtkFileChooser:preview-widget-active ##### -->
 977 <para>
 978
 979 </para>
 980
 981
 982 <!-- ##### ARG GtkFileChooser:select-multiple ##### -->
 983 <para>
 984
 985 </para>
 986
 987
 988 <!-- ##### ARG GtkFileChooser:show-hidden ##### -->
 989 <para>
 990
 991 </para>
 992
 993
 994 <!-- ##### ARG GtkFileChooser:use-preview-label ##### -->
 995 <para>
 996
 997 </para>
 998
 999
1000 <!-- ##### ENUM GtkFontFilterType ##### -->
1001 <para>
1002 A set of bit flags used to specify the filter being set
1003 when calling gtk_font_selection_dialog_set_filter() or
1004 gtk_font_selection_set_filter().
1005 </para>
1006
1007 @GTK_FONT_FILTER_BASE: the base filter, which can't be changed by the user.
1008 @GTK_FONT_FILTER_USER: the user filter, which can be changed from within the
1009 'Filter' page of the #GtkFontSelection widget.
1010
1011 <!-- ##### ENUM GtkFontType ##### -->
1012 <para>
1013 A set of bit flags used to specify the type of fonts shown
1014 when calling gtk_font_selection_dialog_set_filter() or
1015 gtk_font_selection_set_filter().
1016 </para>
1017
1018 @GTK_FONT_BITMAP: bitmap fonts.
1019 @GTK_FONT_SCALABLE: scalable fonts.
1020 @GTK_FONT_SCALABLE_BITMAP: scaled bitmap fonts.
1021 @GTK_FONT_ALL: a bitwise combination of all of the above.
1022
1023 <!-- ##### ARG GtkHScale:adjustment ##### -->
1024 <para>
1025 the #GtkAdjustment which sets the range of the scale.
1026 </para>
1027
1028
1029 <!-- ##### ARG GtkHScrollbar:adjustment ##### -->
1030 <para>
1031
1032 </para>
1033
1034
1035 <!-- ##### STRUCT GtkIconViewPrivate ##### -->
1036 <para>
1037
1038 </para>
1039
1040
1041 <!-- ##### USER_FUNCTION GtkImageLoader ##### -->
1042 <para>
1043 A GtkImageLoader is used to load a filename found in
1044 a RC file.
1045 </para>
1046
1047 @window: the window for creating image
1048 @colormap: the colormap for this image
1049 @mask: a pointer to the location to store the mask
1050 @transparent_color: the transparent color for the image
1051 @filename: filename to load
1052 @Returns: a #GtkPixmap representing @filename
1053
1054 <!-- ##### STRUCT GtkImageMenuItemClass ##### -->
1055 <para>
1056
1057 </para>
1058
1059
1060 <!-- ##### ARG GtkLabel:accel-keyval ##### -->
1061 <para>
1062
1063 </para>
1064
1065
1066 <!-- ##### SIGNAL GtkMenuBar::cycle-focus ##### -->
1067 <para>
1068
1069 </para>
1070
1071 @menubar: the object which received the signal.
1072 @arg1:
1073
1074 <!-- ##### SIGNAL GtkNotebook::tab-added ##### -->
1075 <para>
1076
1077 </para>
1078
1079 @notebook: the object which received the signal.
1080 @arg1:
1081 @arg2:
1082
1083 <!-- ##### SIGNAL GtkNotebook::tab-removed ##### -->
1084 <para>
1085
1086 </para>
1087
1088 @notebook: the object which received the signal.
1089 @arg1:
1090 @arg2:
1091
1092 <!-- ##### SIGNAL GtkNotebook::tab-reordered ##### -->
1093 <para>
1094
1095 </para>
1096
1097 @notebook: the object which received the signal.
1098 @arg1:
1099 @arg2:
1100
1101 <!-- ##### ARG GtkObject:object-signal ##### -->
1102 <para>
1103 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
1104 the signal to the object, so that the user data and objects
1105 and swapped when the signal handler is invoked.
1106 </para>
1107 <para>
1108 This is useful for handlers that are primarily notifying
1109 other objects and could just invoke an already existing function
1110 if the parameters were swapped.
1111 See gtk_signal_connect_object() for more details.
1112 </para>
1113
1114
1115 <!-- ##### ARG GtkObject:object-signal-after ##### -->
1116 <para>
1117 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
1118 the signal to the object, so that the user data and objects
1119 and swapped when the signal handler is invoked,
1120 and so that the handler is invoked after all others.
1121 </para>
1122 <para>
1123 See gtk_signal_connect_object_after() for more details.
1124 </para>
1125
1126
1127 <!-- ##### ARG GtkObject:signal ##### -->
1128 <para>
1129 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
1130 the signal to the object.
1131 </para>
1132
1133
1134 <!-- ##### ARG GtkObject:signal-after ##### -->
1135 <para>
1136 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
1137 the signal to the object, so that the signal is always run
1138 after other user handlers and the default handler.
1139 </para>
1140
1141
1142 <!-- ##### SIGNAL GtkOldEditable::changed ##### -->
1143 <para>
1144
1145 </para>
1146
1147 @oldeditable: the object which received the signal.
1148
1149 <!-- ##### SIGNAL GtkOldEditable::delete-text ##### -->
1150 <para>
1151
1152 </para>
1153
1154 @oldeditable: the object which received the signal.
1155 @arg1:
1156 @arg2:
1157
1158 <!-- ##### SIGNAL GtkOldEditable::insert-text ##### -->
1159 <para>
1160
1161 </para>
1162
1163 @oldeditable: the object which received the signal.
1164 @arg1:
1165 @arg2:
1166 @arg3:
1167
1168 <!-- ##### STRUCT GtkPacker ##### -->
1169 <para>
1170
1171 </para>
1172
1173 @parent:
1174 @children:
1175 @spacing:
1176 @default_border_width:
1177 @default_pad_x:
1178 @default_pad_y:
1179 @default_i_pad_x:
1180 @default_i_pad_y:
1181
1182 <!-- ##### ARG GtkPacker:default-border-width ##### -->
1183 <para>
1184
1185 </para>
1186
1187
1188 <!-- ##### ARG GtkPacker:default-ipad-x ##### -->
1189 <para>
1190
1191 </para>
1192
1193
1194 <!-- ##### ARG GtkPacker:default-ipad-y ##### -->
1195 <para>
1196
1197 </para>
1198
1199
1200 <!-- ##### ARG GtkPacker:default-pad-x ##### -->
1201 <para>
1202
1203 </para>
1204
1205
1206 <!-- ##### ARG GtkPacker:default-pad-y ##### -->
1207 <para>
1208
1209 </para>
1210
1211
1212 <!-- ##### ARG GtkPacker:spacing ##### -->
1213 <para>
1214
1215 </para>
1216
1217
1218 <!-- ##### STRUCT GtkPackerChild ##### -->
1219 <para>
1220
1221 </para>
1222
1223 @widget:
1224 @anchor:
1225 @side:
1226 @options:
1227 @use_default:
1228 @border_width:
1229 @pad_x:
1230 @pad_y:
1231 @i_pad_x:
1232 @i_pad_y:
1233
1234 <!-- ##### ENUM GtkPackerOptions ##### -->
1235 <para>
1236
1237 </para>
1238
1239 @GTK_PACK_EXPAND:
1240 @GTK_FILL_X:
1241 @GTK_FILL_Y:
1242
1243 <!-- ##### STRUCT GtkPatternSpec ##### -->
1244 <para>
1245
1246 </para>
1247
1248 @match_type:
1249 @pattern_length:
1250 @pattern:
1251 @pattern_reversed:
1252 @user_data:
1253 @seq_id:
1254
1255 <!-- ##### ARG GtkPrintOperation:number-of-pages ##### -->
1256 <para>
1257
1258 </para>
1259
1260
1261 <!-- ##### ENUM GtkPrivateFlags ##### -->
1262 <para>
1263
1264 </para>
1265
1266 @PRIVATE_GTK_USER_STYLE:
1267 @PRIVATE_GTK_RESIZE_PENDING:
1268 @PRIVATE_GTK_RESIZE_NEEDED:
1269 @PRIVATE_GTK_LEAVE_PENDING:
1270 @PRIVATE_GTK_HAS_SHAPE_MASK:
1271 @PRIVATE_GTK_IN_REPARENT:
1272 @PRIVATE_GTK_DIRECTION_SET:
1273 @PRIVATE_GTK_DIRECTION_LTR:
1274
1275 <!-- ##### STRUCT GtkRcStyleClass ##### -->
1276 <para>
1277
1278 </para>
1279
1280
1281 <!-- ##### ARG GtkRecentChooser:filter ##### -->
1282 <para>
1283
1284 </para>
1285
1286
1287 <!-- ##### ARG GtkRecentChooser:limit ##### -->
1288 <para>
1289
1290 </para>
1291
1292
1293 <!-- ##### ARG GtkRecentChooser:local-only ##### -->
1294 <para>
1295
1296 </para>
1297
1298
1299 <!-- ##### ARG GtkRecentChooser:recent-manager ##### -->
1300 <para>
1301
1302 </para>
1303
1304
1305 <!-- ##### ARG GtkRecentChooser:select-multiple ##### -->
1306 <para>
1307
1308 </para>
1309
1310
1311 <!-- ##### ARG GtkRecentChooser:show-icons ##### -->
1312 <para>
1313
1314 </para>
1315
1316
1317 <!-- ##### ARG GtkRecentChooser:show-not-found ##### -->
1318 <para>
1319
1320 </para>
1321
1322
1323 <!-- ##### ARG GtkRecentChooser:show-private ##### -->
1324 <para>
1325
1326 </para>
1327
1328
1329 <!-- ##### ARG GtkRecentChooser:show-tips ##### -->
1330 <para>
1331
1332 </para>
1333
1334
1335 <!-- ##### ARG GtkRecentChooser:sort-type ##### -->
1336 <para>
1337
1338 </para>
1339
1340
1341 <!-- ##### ARG GtkScrolledWindow:shadow ##### -->
1342 <para>
1343
1344 </para>
1345
1346
1347 <!-- ##### ARG GtkSettings:gtk-menu-bar-popout-delay ##### -->
1348 <para>
1349
1350 </para>
1351
1352
1353 <!-- ##### ARG GtkSettings:gtk-menu-popout-delay ##### -->
1354 <para>
1355
1356 </para>
1357
1358
1359 <!-- ##### ARG GtkSettings:gtk-menu-submenu-hysteresis ##### -->
1360 <para>
1361
1362 </para>
1363
1364
1365 <!-- ##### STRUCT GtkSettingsClass ##### -->
1366 <para>
1367
1368 </para>
1369
1370
1371 <!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
1372 <para>
1373 A function which you can use to clean up when the
1374 signal handler is destroyed.
1375 </para>
1376 <para>
1377 For example, if your handler requires a few variables
1378 that you made into a struct and allocated (using g_new()
1379 or something), then you will probably want to free
1380 it as soon as the hook is destroyed.  This will
1381 allow you to do that. (For this in particular
1382 it is convenient to pass g_free() as a #GtkSignalDestroy
1383 function).
1384 </para>
1385
1386 @data: The user data associated with the hook that is being
1387 destroyed.
1388
1389 <!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
1390 <para>
1391 This is currently a hack left in for a scheme wrapper library.
1392 It may be removed.
1393 </para>
1394 <para>
1395 Don't use it.
1396 </para>
1397
1398 @object: The object which emits the signal.
1399 @data: The user data associated with the hook.
1400 @nparams: The number of parameters to the function.
1401 @args: The actual values of the arguments.
1402 @arg_types: The types of the arguments.
1403 @return_type: The type of the return value from the function
1404 or #GTK_TYPE_NONE for no return value.
1405
1406 <!-- ##### STRUCT GtkSignalQuery ##### -->
1407 <para>
1408 This structure contains all the information about a particular
1409 signal:  its name, the type it affects, the signature of the handlers,
1410 and its unique identifying integer.
1411 </para>
1412
1413 @object_type:
1414 @signal_id:
1415 @signal_name:
1416 @is_user_signal:
1417 @signal_flags:
1418 @return_val:
1419 @nparams:
1420 @params:
1421
1422 <!-- ##### STRUCT GtkStatusbarMsg ##### -->
1423 <para>
1424 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.
1425 </para>
1426
1427 @text:
1428 @context_id:
1429 @message_id:
1430
1431 <!-- ##### STRUCT GtkStyleClass ##### -->
1432 <para>
1433
1434 </para>
1435
1436 @parent_class:
1437 @realize:
1438 @unrealize:
1439 @copy:
1440 @clone:
1441 @init_from_rc:
1442 @set_background:
1443 @render_icon:
1444 @draw_hline:
1445 @draw_vline:
1446 @draw_shadow:
1447 @draw_polygon:
1448 @draw_arrow:
1449 @draw_diamond:
1450 @draw_string:
1451 @draw_box:
1452 @draw_flat_box:
1453 @draw_check:
1454 @draw_option:
1455 @draw_tab:
1456 @draw_shadow_gap:
1457 @draw_box_gap:
1458 @draw_extension:
1459 @draw_focus:
1460 @draw_slider:
1461 @draw_handle:
1462 @draw_expander:
1463 @draw_layout:
1464 @draw_resize_grip:
1465 @_gtk_reserved1:
1466 @_gtk_reserved2:
1467 @_gtk_reserved3:
1468 @_gtk_reserved4:
1469 @_gtk_reserved5:
1470 @_gtk_reserved6:
1471 @_gtk_reserved7:
1472 @_gtk_reserved8:
1473 @_gtk_reserved9:
1474 @_gtk_reserved10:
1475 @_gtk_reserved11:
1476 @_gtk_reserved12:
1477
1478 <!-- ##### STRUCT GtkTextBTreeNode ##### -->
1479 <para>
1480
1481 </para>
1482
1483
1484 <!-- ##### STRUCT GtkTextChildAnchorClass ##### -->
1485 <para>
1486
1487 </para>
1488
1489
1490 <!-- ##### ARG GtkTextTag:justify ##### -->
1491 <para>
1492 A #GtkJustification for the text. This is only used when the tag is
1493 applied to the first character in a paragraph.
1494 </para>
1495
1496
1497 <!-- ##### ARG GtkTextTag:left-wrapped-line-margin ##### -->
1498 <para>
1499 Pixel width of the left margin of the text for lines after the first
1500 line in a wrapped paragraph.
1501 </para>
1502
1503
1504 <!-- ##### ARG GtkTextTag:left-wrapped-line-margin-set ##### -->
1505 <para>
1506
1507 </para>
1508
1509
1510 <!-- ##### ARG GtkTextTag:offset ##### -->
1511 <para>
1512 Pixels to offset the text horizontally or vertically, useful to
1513 produce superscript and subscript.
1514 </para>
1515
1516
1517 <!-- ##### SIGNAL GtkTextView::move-focus ##### -->
1518 <para>
1519
1520 </para>
1521
1522 @textview: the object which received the signal.
1523 @arg1:
1524
1525 <!-- ##### ARG GtkTextView:height-lines ##### -->
1526 <para>
1527
1528 </para>
1529
1530
1531 <!-- ##### ARG GtkTextView:justify ##### -->
1532 <para>
1533
1534 </para>
1535
1536
1537 <!-- ##### ARG GtkTextView:width-columns ##### -->
1538 <para>
1539
1540 </para>
1541
1542
1543 <!-- ##### ARG GtkToolButton:show-label-horizontally ##### -->
1544 <para>
1545
1546 </para>
1547
1548
1549 <!-- ##### SIGNAL GtkToolbar::move-focus ##### -->
1550 <para>
1551
1552 </para>
1553
1554 @toolbar: the object which received the signal.
1555 @arg1:
1556 @Returns:
1557
1558 <!-- ##### ARG GtkToolbar:pack-end ##### -->
1559 <para>
1560
1561 </para>
1562
1563
1564 <!-- ##### STRUCT GtkTreeSelectionClass ##### -->
1565 <para>
1566
1567 </para>
1568
1569
1570 <!-- ##### ENUM GtkTreeSelectionMode ##### -->
1571 <para>
1572
1573 </para>
1574
1575 @GTK_TREE_SELECTION_SINGLE:
1576 @GTK_TREE_SELECTION_MULTI:
1577
1578 <!-- ##### SIGNAL GtkTreeView::focus-column-header ##### -->
1579 <para>
1580
1581 </para>
1582
1583 @treeview: the object which received the signal.
1584
1585 <!-- ##### USER_FUNCTION GtkTreeViewDraggableFunc ##### -->
1586 <para>
1587
1588 </para>
1589
1590 @tree_view:
1591 @context:
1592 @path:
1593 @user_data:
1594 @Returns:
1595
1596 <!-- ##### USER_FUNCTION GtkTreeViewDroppableFunc ##### -->
1597 <para>
1598
1599 </para>
1600
1601 @tree_view:
1602 @context:
1603 @path:
1604 @pos:
1605 @user_data:
1606 @Returns:
1607
1608 <!-- ##### SIGNAL GtkUIManager::changed ##### -->
1609 <para>
1610
1611 </para>
1612
1613 @uimanager: the object which received the signal.
1614
1615 <!-- ##### ARG GtkVScale:adjustment ##### -->
1616 <para>
1617 the #GtkAdjustment which sets the range of the scale.
1618 </para>
1619
1620
1621 <!-- ##### ARG GtkVScrollbar:adjustment ##### -->
1622 <para>
1623
1624 </para>
1625
1626
1627 <!-- ##### SIGNAL GtkWidget::activate-mnemonic ##### -->
1628 <para>
1629
1630 </para>
1631
1632 @widget: the object which received the signal.
1633 @arg1:
1634 @Returns:
1635
1636 <!-- ##### SIGNAL GtkWidget::add-accelerator ##### -->
1637 <para>
1638
1639 </para>
1640
1641 @widget: the object which received the signal.
1642 @accel_signal_id:
1643 @accel_group:
1644 @accel_key:
1645 @accel_mods:
1646 @accel_flags:
1647
1648 <!-- ##### SIGNAL GtkWidget::debug-msg ##### -->
1649 <para>
1650
1651 </para>
1652
1653 @widget: the object which received the signal.
1654 @message:
1655
1656 <!-- ##### SIGNAL GtkWidget::draw ##### -->
1657 <para>
1658
1659 </para>
1660
1661 @widget: the object which received the signal.
1662 @area:
1663
1664 <!-- ##### SIGNAL GtkWidget::draw-default ##### -->
1665 <para>
1666
1667 </para>
1668
1669 @widget: the object which received the signal.
1670
1671 <!-- ##### SIGNAL GtkWidget::draw-focus ##### -->
1672 <para>
1673
1674 </para>
1675
1676 @widget: the object which received the signal.
1677
1678 <!-- ##### SIGNAL GtkWidget::remove-accelerator ##### -->
1679 <para>
1680
1681 </para>
1682
1683 @widget: the object which received the signal.
1684 @accel_group:
1685 @accel_key:
1686 @accel_mods:
1687
1688 <!-- ##### ARG GtkWidget:height ##### -->
1689 <para>
1690
1691 </para>
1692
1693
1694 <!-- ##### ARG GtkWidget:width ##### -->
1695 <para>
1696
1697 </para>
1698
1699
1700 <!-- ##### ARG GtkWidget:x ##### -->
1701 <para>
1702
1703 </para>
1704
1705
1706 <!-- ##### ARG GtkWidget:y ##### -->
1707 <para>
1708
1709 </para>
1710
1711
1712 <!-- ##### SIGNAL GtkWindow::accels-changed ##### -->
1713 <para>
1714
1715 </para>
1716
1717 @window: the object which received the signal.
1718
1719 <!-- ##### SIGNAL GtkWindow::move-focus ##### -->
1720 <para>
1721
1722 </para>
1723
1724 @window: the object which received the signal.
1725 @arg1:
1726
1727 <!-- ##### ARG GtkWindow:auto-shrink ##### -->
1728 <para>
1729 If the window shrinks automatically when widgets within it shrink.
1730 </para>
1731
1732
1733 <!-- ##### ARG GtkWindow:icon-list ##### -->
1734 <para>
1735
1736 </para>
1737
1738
1739 <!-- ##### FUNCTION gtk_accel_group_add ##### -->
1740 <para>
1741
1742 </para>
1743
1744 @accel_group:
1745 @path:
1746 @accel_key:
1747 @accel_mods:
1748 @accel_flags:
1749 @object:
1750 @accel_signal:
1751
1752 <!-- ##### FUNCTION gtk_accel_group_attach ##### -->
1753 <para>
1754
1755 </para>
1756
1757 @accel_group:
1758 @object:
1759
1760 <!-- ##### FUNCTION gtk_accel_group_create_add ##### -->
1761 <para>
1762
1763 </para>
1764
1765 @class_type:
1766 @signal_flags:
1767 @handler_offset:
1768 @Returns:
1769
1770 <!-- ##### FUNCTION gtk_accel_group_create_remove ##### -->
1771 <para>
1772
1773 </para>
1774
1775 @class_type:
1776 @signal_flags:
1777 @handler_offset:
1778 @Returns:
1779
1780 <!-- ##### FUNCTION gtk_accel_group_detach ##### -->
1781 <para>
1782
1783 </para>
1784
1785 @accel_group:
1786 @object:
1787
1788 <!-- ##### FUNCTION gtk_accel_group_entries_from_object ##### -->
1789 <para>
1790
1791 </para>
1792
1793 @object:
1794 @Returns:
1795
1796 <!-- ##### FUNCTION gtk_accel_group_get_default ##### -->
1797 <para>
1798
1799 </para>
1800
1801 @Returns:
1802
1803 <!-- ##### FUNCTION gtk_accel_group_get_entry ##### -->
1804 <para>
1805
1806 </para>
1807
1808 @accel_group:
1809 @accel_key:
1810 @accel_mods:
1811 @Returns:
1812
1813 <!-- ##### FUNCTION gtk_accel_group_get_type ##### -->
1814 <para>
1815
1816 </para>
1817
1818 @Returns:
1819
1820 <!-- ##### FUNCTION gtk_accel_group_handle_add ##### -->
1821 <para>
1822
1823 </para>
1824
1825 @object:
1826 @accel_signal_id:
1827 @accel_group:
1828 @accel_key:
1829 @accel_mods:
1830 @accel_flags:
1831
1832 <!-- ##### FUNCTION gtk_accel_group_handle_remove ##### -->
1833 <para>
1834
1835 </para>
1836
1837 @object:
1838 @accel_group:
1839 @accel_key:
1840 @accel_mods:
1841
1842 <!-- ##### FUNCTION gtk_accel_group_lock_entry ##### -->
1843 <para>
1844
1845 </para>
1846
1847 @accel_group:
1848 @accel_key:
1849 @accel_mods:
1850
1851 <!-- ##### FUNCTION gtk_accel_group_remove ##### -->
1852 <para>
1853
1854 </para>
1855
1856 @accel_group:
1857 @accel_key:
1858 @accel_mods:
1859 @object:
1860
1861 <!-- ##### FUNCTION gtk_accel_group_unlock_entry ##### -->
1862 <para>
1863
1864 </para>
1865
1866 @accel_group:
1867 @accel_key:
1868 @accel_mods:
1869
1870 <!-- ##### FUNCTION gtk_accel_label_get_accel_object ##### -->
1871 <para>
1872
1873 </para>
1874
1875 @accel_label:
1876 @Returns:
1877
1878 <!-- ##### FUNCTION gtk_accel_label_set_accel_object ##### -->
1879 <para>
1880
1881 </para>
1882
1883 @accel_label:
1884 @accel_object:
1885
1886 <!-- ##### FUNCTION gtk_accel_map_add_notifer ##### -->
1887 <para>
1888
1889 </para>
1890
1891 @accel_path:
1892 @notify_data:
1893 @notify_func:
1894 @accel_group:
1895
1896 <!-- ##### FUNCTION gtk_accel_map_remove_notifer ##### -->
1897 <para>
1898
1899 </para>
1900
1901 @accel_path:
1902 @notify_data:
1903 @notify_func:
1904
1905 <!-- ##### FUNCTION gtk_arg_copy ##### -->
1906 <para>
1907 It will either copy data into an existing argument or allocate a new argument
1908 and copy the data.  Strings are duplicated.  All other pointers and
1909 values are copied (shallowly-- that is the pointers themselves are
1910 copied, not the data they point to.)
1911 </para>
1912 <para>
1913 You should call gtk_arg_reset() on dest_arg before calling this
1914 if the argument may contain string data that you want freed.
1915 </para>
1916
1917 @src_arg: the argument to duplicate.
1918 @dest_arg: the argument to copy over (or NULL to create a new #GtkArg).
1919 @Returns: the new #GtkArg (or dest_arg, if it was not NULL).
1920
1921 <!-- ##### FUNCTION gtk_arg_free ##### -->
1922 <para>
1923 Frees the argument, and optionally its contents.
1924 </para>
1925
1926 @arg: the argument to free.
1927 @free_contents: whether to free the string, if it is a string.
1928
1929 <!-- ##### FUNCTION gtk_arg_get_info ##### -->
1930 <para>
1931 Private: get information about an argument.
1932 </para>
1933
1934 @object_type: the type of object.
1935 @arg_info_hash_table: the hashtable of #GtkArgInfos.
1936 @arg_name: the name of the argument to lookup.
1937 @info_p: the argument info.
1938 @Returns: an error message on failure, or NULL otherwise.
1939
1940 <!-- ##### FUNCTION gtk_arg_info_equal ##### -->
1941 <para>
1942 A #GCompareFunc for hashing #GtkArgInfos.
1943 </para>
1944
1945 @arg_info_1: a #GtkArgInfo.
1946 @arg_info_2: a #GtkArgInfo.
1947 @Returns: whether the arguments are the same.
1948
1949 <!-- ##### FUNCTION gtk_arg_info_hash ##### -->
1950 <para>
1951 A #GHashFunc for hashing #GtkArgInfos.
1952 </para>
1953
1954 @arg_info: a #GtkArgInfo.
1955 @Returns: a hash value for that #GtkArgInfo.
1956
1957 <!-- ##### FUNCTION gtk_arg_name_strip_type ##### -->
1958 <para>
1959 Given a fully qualified argument name (e.g. "GtkButton::label")
1960 it returns just the argument name (e.g. "label") unless
1961 the argument name was invalid, in which case it returns NULL.
1962 </para>
1963
1964 @arg_name: the fully-qualified argument name.
1965 @Returns: the base argument name.
1966
1967 <!-- ##### FUNCTION gtk_arg_new ##### -->
1968 <para>
1969 Creates a new argument of a certain type, set to 0 or NULL.
1970 </para>
1971
1972 @arg_type: the type of the argument.
1973 @Returns: the newly created #GtkArg.
1974
1975 <!-- ##### FUNCTION gtk_arg_reset ##### -->
1976 <para>
1977
1978 </para>
1979
1980 @arg:
1981
1982 <!-- ##### FUNCTION gtk_arg_to_valueloc ##### -->
1983 <para>
1984
1985 </para>
1986
1987 @arg:
1988 @value_pointer:
1989
1990 <!-- ##### FUNCTION gtk_arg_type_new_static ##### -->
1991 <para>
1992 Create a new argument registered with a class.
1993 </para>
1994
1995 @base_class_type: the basic type having the arguments, almost alway
1996 GTK_TYPE_OBJECT, except if your defining a different type argument
1997 that gets a different namespace.  #GtkContainer does this to define
1998 per-child arguments of the container.
1999 @arg_name: name of the argument to create.  (must be a static constant string)
2000 @class_n_args_offset: offset into the base class structure that tells
2001 the number of arguments.
2002 @arg_info_hash_table: hashtable of #GtkArgInfos.
2003 @arg_type: type of the argument.
2004 @arg_flags: flags of the argument.
2005 @arg_id: ???
2006 @Returns: the new #GtkArgInfo.
2007
2008 <!-- ##### FUNCTION gtk_arg_values_equal ##### -->
2009 <para>
2010
2011 </para>
2012
2013 @arg1:
2014 @arg2:
2015 @Returns:
2016
2017 <!-- ##### FUNCTION gtk_args_collect ##### -->
2018 <para>
2019 Private:  given a hashtable of argument information it takes a vararg
2020 list and parses it into arguments (in the form of lists of #GtkArgs
2021 and lists of #GtkArgInfos.
2022 </para>
2023 <para>
2024 The list of arguments starts with first_arg_name then the first argument's
2025 value.  Followed by any number of additional name/argument pairs,
2026 terminated with NULL.
2027 </para>
2028
2029 @object_type: the type of object we are collecting arguments for.
2030 @arg_info_hash_table: a hashtable mapping from names of arguments
2031 to their #GtkArgInfos.
2032 @arg_list_p: a returned list of arguments obtained from parsing the
2033 varargs.
2034 @info_list_p: a returned list of the #GtkArgInfos.
2035 @first_arg_name: the name of the first argument.
2036 @var_args: a va_list containing the value of the first argument,
2037 followed by name/value pairs, followed by NULL.
2038 @Returns: an error message on failure, or NULL otherwise.
2039
2040 <!-- ##### FUNCTION gtk_args_collect_cleanup ##### -->
2041 <para>
2042 Private: erase lists of arguments returned from gtk_args_collect().
2043 </para>
2044
2045 @arg_list: arg_list_p returned from gtk_args_collect().
2046 @info_list: info_list_p returned from gtk_args_collect().
2047
2048 <!-- ##### FUNCTION gtk_args_query ##### -->
2049 <para>
2050 Private: from a class type and its arginfo hashtable,
2051 get an array of #GtkArgs that this object accepts.
2052 </para>
2053
2054 @class_type: the class type.
2055 @arg_info_hash_table: the hashtable of #GtkArgInfos.
2056 @arg_flags: returned array of argument flags.
2057 @n_args_p: the number of arguments this object accepts.
2058 @Returns: the array of arguments (or NULL on error).
2059
2060 <!-- ##### FUNCTION gtk_button_box_child_requisition ##### -->
2061 <para>\r
2062 This is an internally used function and should never be called from an\r
2063 application.\r
2064 </para>
2065
2066 @widget:
2067 @nvis_children:
2068 @width:
2069 @height:
2070
2071 <!-- ##### FUNCTION gtk_button_box_get_child_ipadding_default ##### -->
2072 <para>\r
2073 The internal padding of a button is the amount of space between the outside\r
2074 of the button and the widget it contains. This function gets the default\r
2075 amount of horizontal and vertical padding, placing the results in @ipad_x\r
2076 and @ipad_y, respectively.\r
2077 </para>
2078
2079 @ipad_x: the default horizontal internal button padding.
2080 @ipad_y: the default vertical internal button padding.
2081
2082 <!-- ##### FUNCTION gtk_button_box_get_child_size_default ##### -->
2083 <para>\r
2084 Retrieves the default minimum width and height for all button boxes, and\r
2085 places the values in @min_width and @min_height, respectively.\r
2086 </para>
2087
2088 @min_width: the default minimum width of a child widget.
2089 @min_height: the default minimum height of a child widget.
2090
2091 <!-- ##### FUNCTION gtk_button_box_set_child_ipadding_default ##### -->
2092 <para>\r
2093 Sets the default number of pixels that pad each button in every button box.\r
2094 </para>
2095
2096 @ipad_x: new default horizontal padding.
2097 @ipad_y: new default vertical padding.
2098
2099 <!-- ##### FUNCTION gtk_button_box_set_child_size_default ##### -->
2100 <para>\r
2101 Sets the default size of child buttons.\r
2102 </para>
2103
2104 @min_width: minimum default width for child buttons.
2105 @min_height: minimum default height for child buttons.
2106
2107 <!-- ##### FUNCTION gtk_button_new_accel ##### -->
2108 <para>
2109
2110 </para>
2111
2112 @uline_label:
2113 @accel_group:
2114 @Returns:
2115
2116 <!-- ##### FUNCTION gtk_button_new_stock ##### -->
2117 <para>
2118
2119 </para>
2120
2121 @stock_id:
2122 @accel_group:
2123 @Returns:
2124
2125 <!-- ##### FUNCTION gtk_cell_renderer_event ##### -->
2126 <para>
2127
2128 </para>
2129
2130 @cell:
2131 @event:
2132 @widget:
2133 @path:
2134 @background_area:
2135 @cell_area:
2136 @flags:
2137 @Returns:
2138
2139 <!-- ##### FUNCTION gtk_cell_renderer_text_pixbuf_new ##### -->
2140 <para>
2141
2142 </para>
2143
2144 @Returns:
2145
2146 <!-- ##### FUNCTION gtk_cell_view_get_use_fg ##### -->
2147 <para>
2148
2149 </para>
2150
2151 @cell_view:
2152 @Returns:
2153
2154 <!-- ##### FUNCTION gtk_cell_view_set_cell_data ##### -->
2155 <para>
2156
2157 </para>
2158
2159 @cell_view:
2160 @cellview:
2161
2162 <!-- ##### FUNCTION gtk_cell_view_set_use_fg ##### -->
2163 <para>
2164
2165 </para>
2166
2167 @cell_view:
2168 @use_fg:
2169
2170 <!-- ##### FUNCTION gtk_clist_construct ##### -->
2171 <para>
2172 Initializes a previously allocated #GtkCList widget for use.  This should not
2173 normally be used to create a #GtkCList widget.  Use gtk_clist_new() instead.
2174 </para>
2175
2176 @clist: A pointer to an uninitialized #GtkCList widget.
2177 @columns: The number of columns the #GtkCList should have.
2178 @titles: An array of strings that should be used as the titles i
2179 of the columns.  There should be enough strings in the array for
2180 the number of columns specified.
2181
2182 <!-- ##### FUNCTION gtk_color_selection_get_old_color ##### -->
2183 <para>
2184
2185 </para>
2186
2187 @colorsel:
2188 @color:
2189
2190 <!-- ##### FUNCTION gtk_color_selection_get_use_opacity ##### -->
2191 <para>
2192
2193 </para>
2194
2195 @colorsel:
2196 @Returns:
2197
2198 <!-- ##### FUNCTION gtk_color_selection_get_use_palette ##### -->
2199 <para>
2200
2201 </para>
2202
2203 @colorsel:
2204 @Returns:
2205
2206 <!-- ##### FUNCTION gtk_color_selection_set_old_color ##### -->
2207 <para>
2208
2209 </para>
2210
2211 @colorsel:
2212 @color:
2213
2214 <!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
2215 <para>
2216 Controls whether opacity can be set with the #GtkColorSelection.
2217 If this functionality is enabled, the necessary additional widgets
2218 are added to the #GtkColorSelection and the opacity value can be
2219 retrieved via the fourth value in the color array returned by
2220 the gtk_color_selection_get_color() function.
2221 </para>
2222
2223 @colorsel: a #GtkColorSelection.
2224 @use_opacity: a boolean indicating whether the opacity selection
2225 is enabled.
2226
2227 <!-- ##### FUNCTION gtk_color_selection_set_use_opacity ##### -->
2228 <para>
2229
2230 </para>
2231
2232 @colorsel:
2233 @use_opacity:
2234
2235 <!-- ##### FUNCTION gtk_color_selection_set_use_palette ##### -->
2236 <para>
2237
2238 </para>
2239
2240 @colorsel:
2241 @use_palette:
2242
2243 <!-- ##### FUNCTION gtk_combo_box_get_row_separator_column ##### -->
2244 <para>
2245
2246 </para>
2247
2248 @combo_box:
2249 @Returns:
2250
2251 <!-- ##### FUNCTION gtk_combo_box_set_row_separator_column ##### -->
2252 <para>
2253
2254 </para>
2255
2256 @combo_box:
2257 @column:
2258
2259 <!-- ##### FUNCTION gtk_container_add_child_arg_type ##### -->
2260 <para>
2261
2262 </para>
2263
2264 @arg_name:
2265 @arg_type:
2266 @arg_flags:
2267 @arg_id:
2268
2269 <!-- ##### FUNCTION gtk_container_add_with_args ##### -->
2270 <para>
2271
2272 </para>
2273
2274 @container:
2275 @widget:
2276 @first_arg_name:
2277 @Varargs:
2278
2279 <!-- ##### FUNCTION gtk_container_addv ##### -->
2280 <para>
2281
2282 </para>
2283
2284 @container:
2285 @widget:
2286 @n_args:
2287 @args:
2288
2289 <!-- ##### FUNCTION gtk_container_arg_get ##### -->
2290 <para>
2291
2292 </para>
2293
2294 @container:
2295 @child:
2296 @arg:
2297 @info:
2298
2299 <!-- ##### FUNCTION gtk_container_arg_set ##### -->
2300 <para>
2301
2302 </para>
2303
2304 @container:
2305 @child:
2306 @arg:
2307 @info:
2308
2309 <!-- ##### FUNCTION gtk_container_child_arg_get_info ##### -->
2310 <para>
2311
2312 </para>
2313
2314 @object_type:
2315 @arg_name:
2316 @info_p:
2317 @Returns:
2318
2319 <!-- ##### FUNCTION gtk_container_child_args_collect ##### -->
2320 <para>
2321
2322 </para>
2323
2324 @object_type:
2325 @arg_list_p:
2326 @info_list_p:
2327 @first_arg_name:
2328 @args:
2329 @Returns:
2330
2331 <!-- ##### FUNCTION gtk_container_child_getv ##### -->
2332 <para>
2333
2334 </para>
2335
2336 @container:
2337 @child:
2338 @n_args:
2339 @args:
2340
2341 <!-- ##### FUNCTION gtk_container_child_setv ##### -->
2342 <para>
2343
2344 </para>
2345
2346 @container:
2347 @child:
2348 @n_args:
2349 @args:
2350
2351 <!-- ##### FUNCTION gtk_container_dequeue_resize_handler ##### -->
2352 <para>
2353
2354 </para>
2355
2356 @container:
2357
2358 <!-- ##### FUNCTION gtk_container_focus ##### -->
2359 <para>
2360
2361 </para>
2362
2363 @container:
2364 @direction:
2365 @Returns:
2366
2367 <!-- ##### FUNCTION gtk_container_query_child_args ##### -->
2368 <para>
2369
2370 </para>
2371
2372 @class_type:
2373 @arg_flags:
2374 @nargs:
2375 @Returns:
2376
2377 <!-- ##### FUNCTION gtk_ctree_construct ##### -->
2378 <para>
2379 This function is not usually used by users.
2380 </para>
2381
2382 @ctree:
2383 @columns:
2384 @tree_column:
2385 @titles:
2386
2387 <!-- ##### FUNCTION gtk_decorated_window_calculate_frame_size ##### -->
2388 <para>
2389
2390 </para>
2391
2392 @window:
2393
2394 <!-- ##### FUNCTION gtk_decorated_window_init ##### -->
2395 <para>
2396
2397 </para>
2398
2399 @window:
2400
2401 <!-- ##### FUNCTION gtk_decorated_window_move_resize_window ##### -->
2402 <para>
2403
2404 </para>
2405
2406 @window:
2407 @x:
2408 @y:
2409 @width:
2410 @height:
2411
2412 <!-- ##### FUNCTION gtk_decorated_window_set_title ##### -->
2413 <para>
2414
2415 </para>
2416
2417 @window:
2418 @title:
2419
2420 <!-- ##### FUNCTION gtk_drag_dest_handle_event ##### -->
2421 <para>
2422 Internal function.
2423 </para>
2424
2425 @toplevel:
2426 @event:
2427
2428 <!-- ##### FUNCTION gtk_drag_source_handle_event ##### -->
2429 <para>
2430 Internal function.
2431 </para>
2432
2433 @widget:
2434 @event:
2435
2436 <!-- ##### FUNCTION gtk_editable_changed ##### -->
2437 <para>
2438 Causes the "changed" signal to be emitted.
2439 </para>
2440
2441 @editable: a #GtkEditable widget.
2442
2443 <!-- ##### FUNCTION gtk_editable_claim_selection ##### -->
2444 <para>
2445 Claim or disclaim ownership of the PRIMARY X selection.
2446 </para>
2447
2448 @editable: a #GtkEditable widget.
2449 @claim: if %TRUE, claim the selection, otherwise, disclaim it.
2450 @time: the timestamp for claiming the selection.
2451
2452 <!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
2453 <para>
2454
2455 </para>
2456
2457 @Returns:
2458
2459 <!-- ##### FUNCTION gtk_file_chooser_get_folder_mode ##### -->
2460 <para>
2461
2462 </para>
2463
2464 @chooser:
2465 @Returns:
2466
2467 <!-- ##### FUNCTION gtk_file_chooser_set_folder_mode ##### -->
2468 <para>
2469
2470 </para>
2471
2472 @chooser:
2473 @folder_mode:
2474
2475 <!-- ##### FUNCTION gtk_font_selection_dialog_set_filter ##### -->
2476 <para>
2477 Sets one of the two font filters, to limit the fonts shown.
2478 </para>
2479
2480 @fsd: a #GtkFontSelectionDialog.
2481 @filter_type: which of the two font filters to set, either
2482 #GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
2483 can be changed by the user, but the base filter is permanent.
2484 @font_type: the types of font to be shown. This is a bitwise combination of
2485 #GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
2486 or #GTK_FONT_ALL to show all three font types.
2487 @foundries: a NULL-terminated array of strings containing foundry names which
2488 will be shown, or NULL to show all foundries.
2489 @weights: a NULL-terminated array of strings containing weight names which
2490 will be shown, or NULL to show all weights.
2491 @slants: a NULL-terminated array of strings containing slant names which
2492 will be shown, or NULL to show all slants.
2493 @setwidths: a NULL-terminated array of strings containing setwidth names which
2494 will be shown, or NULL to show all setwidths.
2495 @spacings: a NULL-terminated array of strings containing spacings which
2496 will be shown, or NULL to show all spacings.
2497 @charsets: a NULL-terminated array of strings containing charset names which
2498 will be shown, or NULL to show all charsets.
2499
2500 <!-- ##### FUNCTION gtk_font_selection_set_filter ##### -->
2501 <para>
2502 Sets one of the two font filters, to limit the fonts shown.
2503 </para>
2504
2505 @fontsel: a #GtkFontSelection.
2506 @filter_type: which of the two font filters to set, either
2507 #GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
2508 can be changed by the user, but the base filter is permanent.
2509 @font_type: the types of font to be shown. This is a bitwise combination of
2510 #GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
2511 or #GTK_FONT_ALL to show all three font types.
2512 @foundries: a NULL-terminated array of strings containing foundry names which
2513 will be shown, or NULL to show all foundries.
2514 @weights: a NULL-terminated array of strings containing weight names which
2515 will be shown, or NULL to show all weights.
2516 @slants: a NULL-terminated array of strings containing slant names which
2517 will be shown, or NULL to show all slants.
2518 @setwidths: a NULL-terminated array of strings containing setwidth names which
2519 will be shown, or NULL to show all setwidths.
2520 @spacings: a NULL-terminated array of strings containing spacings which
2521 will be shown, or NULL to show all spacings.
2522 @charsets: a NULL-terminated array of strings containing charset names which
2523 will be shown, or NULL to show all charsets.
2524
2525 <!-- ##### FUNCTION gtk_icon_view_get_type ##### -->
2526 <para>
2527
2528 </para>
2529
2530 @Returns:
2531
2532 <!-- ##### FUNCTION gtk_identifier_get_type ##### -->
2533 <para>
2534 Get the type of GtkIdentifier.
2535 </para>
2536
2537 @Returns: GtkType -- the enumerated type of something.
2538
2539 <!-- ##### FUNCTION gtk_image_menu_item_add_image ##### -->
2540 <para>
2541
2542 </para>
2543
2544 @image_menu_item:
2545 @child:
2546
2547 <!-- ##### FUNCTION gtk_image_menu_item_get_type ##### -->
2548 <para>
2549
2550 </para>
2551
2552 @Returns:
2553
2554 <!-- ##### FUNCTION gtk_item_factory_dump_items ##### -->
2555 <para>
2556
2557 </para>
2558
2559 @path_pspec:
2560 @modified_only:
2561 @print_func:
2562 @func_data:
2563
2564 <!-- ##### FUNCTION gtk_item_factory_dump_rc ##### -->
2565 <para>
2566
2567 </para>
2568
2569 @file_name:
2570 @path_pspec:
2571 @modified_only:
2572
2573 <!-- ##### FUNCTION gtk_item_factory_parse_rc ##### -->
2574 <para>
2575
2576 </para>
2577
2578 @file_name:
2579
2580 <!-- ##### FUNCTION gtk_item_factory_parse_rc_scanner ##### -->
2581 <para>
2582
2583 </para>
2584
2585 @scanner:
2586
2587 <!-- ##### FUNCTION gtk_item_factory_parse_rc_string ##### -->
2588 <para>
2589
2590 </para>
2591
2592 @rc_string:
2593
2594 <!-- ##### FUNCTION gtk_item_factory_print_func ##### -->
2595 <para>
2596
2597 </para>
2598
2599 @FILE_pointer:
2600 @string:
2601
2602 <!-- ##### FUNCTION gtk_label_set_markup_with_accel ##### -->
2603 <para>
2604
2605 </para>
2606
2607 @label:
2608 @str:
2609 @Returns:
2610
2611 <!-- ##### FUNCTION gtk_list_store_move ##### -->
2612 <para>
2613
2614 </para>
2615
2616 @store:
2617 @iter:
2618 @position:
2619
2620 <!-- ##### FUNCTION gtk_list_store_new_with_types ##### -->
2621 <para>
2622
2623 </para>
2624
2625 @n_columns:
2626 @Varargs:
2627 @Returns:
2628
2629 <!-- ##### FUNCTION gtk_list_store_set_cell ##### -->
2630 <para>
2631
2632 </para>
2633
2634 @store:
2635 @iter:
2636 @column:
2637 @value:
2638
2639 <!-- ##### FUNCTION gtk_list_store_set_column_type ##### -->
2640 <para>
2641
2642 </para>
2643
2644 @store:
2645 @column:
2646 @type:
2647
2648 <!-- ##### FUNCTION gtk_list_store_set_n_columns ##### -->
2649 <para>
2650
2651 </para>
2652
2653 @store:
2654 @n_columns:
2655
2656 <!-- ##### FUNCTION gtk_menu_ensure_uline_accel_group ##### -->
2657 <para>
2658
2659 </para>
2660
2661 @menu:
2662 @Returns:
2663
2664 <!-- ##### FUNCTION gtk_menu_get_uline_accel_group ##### -->
2665 <para>
2666
2667 </para>
2668
2669 @menu:
2670 @Returns:
2671
2672 <!-- ##### FUNCTION gtk_menu_item_configure ##### -->
2673 <para>
2674 Sets whether the menu item should show a submenu indicator, which is a right
2675 arrow.
2676 </para>
2677
2678 @menu_item: the menu item
2679 @show_toggle_indicator: unused
2680 @show_submenu_indicator: whether to show the arrow or not
2681
2682 <!-- ##### FUNCTION gtk_menu_item_set_placement ##### -->
2683 <para>
2684 Specifies the placement of the submenu around the menu item. The placement
2685 is usually #GTK_LEFT_RIGHT for menu items in a popup menu and
2686 #GTK_TOP_BOTTOM in menu bars.
2687 </para>
2688 <para>
2689 This function is useless in usual applications.
2690 </para>
2691
2692 @menu_item: the menu item
2693 @placement: the submenu placement
2694
2695 <!-- ##### FUNCTION gtk_object_arg_get ##### -->
2696 <para>
2697 Private function to get an argument and argument info from an object.
2698 </para>
2699
2700 @object: the object whose argument should be retrieved.
2701 @arg: the argument, for the name on input, the rest is filled on output.
2702 @info: a #GtkArgInfo structure to optionally fill in.
2703
2704 <!-- ##### FUNCTION gtk_object_arg_get_info ##### -->
2705 <para>
2706 Query information about an argument type.
2707 </para>
2708
2709 @object_type: type of object to query about.
2710 @arg_name: name of the argument.
2711 @info_p: pointer to be filled in with a pointer to the GtkArgInfo.
2712 @Returns: an error message, or NULL on success.
2713 It is the caller's responsibility to call g_free() in the event of error.
2714
2715 <!-- ##### FUNCTION gtk_object_arg_set ##### -->
2716 <para>
2717 Private function to set an argument and argument info to an object.
2718 </para>
2719
2720 @object: the object whose argument should be set.
2721 @arg: the argument.
2722 @info: infomation about this type of argument in general.
2723
2724 <!-- ##### FUNCTION gtk_object_args_collect ##### -->
2725 <para>
2726 Private: Gets an array of #GtkArgs from a va_list C structure.
2727 </para>
2728
2729 @object_type: the type of object to collect arguments for.
2730 @arg_list_p: pointer to be filled in with a list of parsed arguments.
2731 @info_list_p: optional pointer for a returned list #GtkArgInfos.
2732 @first_arg_name: name of first argument.
2733 @var_args: value of first argument, followed by more key/value pairs,
2734 terminated by NULL.
2735 @Returns: an error message, or NULL on success.
2736 It is the caller's responsibility to call g_free() in the event of error.
2737
2738 <!-- ##### FUNCTION gtk_object_class_add_signals ##### -->
2739 <para>
2740 Add an array of signals to a #GtkObjectClass.
2741 Usually this is called when registering a new type of object.
2742 </para>
2743
2744 @klass: the object class to append signals to.
2745 @signals: the signals to append.
2746 @nsignals: the number of signals being appended.
2747
2748 <!-- ##### FUNCTION gtk_object_class_user_signal_new ##### -->
2749 <para>
2750 Define a signal-handler for a new signal on an already defined
2751 object.
2752 </para>
2753 <para>
2754 See the signal documentation for more general information.
2755 </para>
2756
2757 @klass: the object class to define the signal for.
2758 @name: the name of the signal.
2759 @signal_flags: the default emission behavior for the signal.
2760 See gtk_signal_new().
2761 @marshaller: a function that will take an array of GtkArgs
2762 and invoke the appropriate handler with the normal calling
2763 conventions.
2764 @return_val: specify the return-value type for the signal
2765 (or GTK_TYPE_NONE for no return-value).
2766 @nparams: specify the number of parameters the signal
2767 receives from the caller of gtk_signal_emit().
2768 @Varargs: list of nparams #GtkTypes to pass to the signal handlers.
2769 @Returns: the signal id.  (See #GtkSignals)
2770
2771 <!-- ##### FUNCTION gtk_object_class_user_signal_newv ##### -->
2772 <para>
2773 Define a signal-handler for a new signal on an already defined
2774 object.
2775 </para>
2776
2777 @klass: the object class to define the signal for.
2778 @name: the name of the signal.
2779 @signal_flags: the default emission behavior for the signal.
2780 See gtk_signal_new().
2781 @marshaller: takes a GtkObject, a #GtkSignalFunc, and an array
2782 of arguments, and invokes the function using the appropriate
2783 calling conventions.  Usually just select a function
2784 out of gtkmarshal.h.
2785 @return_val: specify the return-value type for the signal (possibly
2786 #GTK_TYPE_NONE).
2787 @nparams: specify the number of parameters the signal
2788 receives from the caller of gtk_signal_emit().
2789 @params: array of #GtkTypes the signal handlers for this signal
2790 should have in their prototype (of length nparams).
2791 @Returns: the signal id.  (See #GtkSignals)
2792
2793 <!-- ##### FUNCTION gtk_object_constructed ##### -->
2794 <para>
2795 Mark an allocated object as constructed.
2796 This is used for situations
2797 that require precise control of the construction process.
2798 </para>
2799 <para>
2800 This is done when gtk_object_default_construct() is inadequate.
2801 In #GtkCList the need arises because #GtkCList does construction work that
2802 must happen <emphasis>after</emphasis> its derivers.  This work
2803 cannot be done in an initializer function, so an alternate
2804 constructor is mandatory.  It calls gtk_object_constructed() to
2805 indicate it has done its job, so that no other constructor will
2806 be invoked.
2807 </para>
2808 <para>
2809 Normally this function is just automatically run from
2810 gtk_object_default_construct().
2811 </para>
2812
2813 @object: object which has been constructed.  This is usually
2814 done automatically by gtk_object_new() and gtk_object_newv().
2815
2816 <!-- ##### FUNCTION gtk_object_default_construct ##### -->
2817 <para>
2818 This function is called to construct arguments that haven't been initialized
2819 but have the #GTK_ARG_CONSTRUCT flag set.
2820 </para>
2821 <para>
2822 All number arguments are set to 0.  All pointers and strings
2823 are set to NULL.
2824 </para>
2825 <para>
2826 Normally invoked by gtk_object_new() automatically; gtk_type_new() can
2827 be used to bypass it.
2828 </para>
2829
2830 @object: the object to initialize.
2831
2832 <!-- ##### FUNCTION gtk_object_getv ##### -->
2833 <para>
2834 Gets an array of argument values from an object.
2835 </para>
2836
2837 @object: the object to get arguments from.
2838 @n_args: the number of arguments to query.
2839 @args: the arguments to fill in.
2840
2841 <!-- ##### FUNCTION gtk_object_newv ##### -->
2842 <para>
2843 Construct an object with an array of arguments.
2844 </para>
2845
2846 @object_type: the type of the object to create.
2847 @n_args: the number of arguments to set.
2848 @args: an array of n_args arguments (which are name and value pairs).
2849 @Returns: the new GtkObject.
2850
2851 <!-- ##### FUNCTION gtk_object_query_args ##### -->
2852 <para>
2853 Get all the arguments that may be used for a given type.
2854 </para>
2855 <para>
2856 In Java, this type of mechanism is called
2857 <wordasword>introspection</wordasword>.  It is used by applications
2858 like Glade, that have to determine what can be done to an object
2859 at run-time.
2860 </para>
2861
2862 @class_type: the GtkType of the ObjectClass
2863 (returned from GTK_OBJECT_CLASS(class)-&gt;type for example).
2864 @arg_flags: if non-NULL, obtains the #GtkArgFlags that apply to
2865 each argument.  You must g_free() this if you request it.
2866 @n_args: the number of arguments is returned in this field.
2867 @Returns: an array of arguments, that you must deallocate with g_free().
2868
2869 <!-- ##### FUNCTION gtk_object_setv ##### -->
2870 <para>
2871 Set an array of arguments.
2872 </para>
2873
2874 @object: the object whose arguments should be set.
2875 @n_args: the number of arguments to set.
2876 @args: the desired values, as an array of #GtkArgs (which contain
2877 the names, types, and values of the arguments).
2878
2879 <!-- ##### FUNCTION gtk_packer_add ##### -->
2880 <para>
2881
2882 </para>
2883
2884 @packer:
2885 @child:
2886 @side:
2887 @anchor:
2888 @options:
2889 @border_width:
2890 @pad_x:
2891 @pad_y:
2892 @i_pad_x:
2893 @i_pad_y:
2894
2895 <!-- ##### FUNCTION gtk_packer_add_defaults ##### -->
2896 <para>
2897
2898 </para>
2899
2900 @packer:
2901 @child:
2902 @side:
2903 @anchor:
2904 @options:
2905
2906 <!-- ##### MACRO gtk_packer_configure ##### -->
2907 <para>
2908
2909 </para>
2910
2911
2912 <!-- ##### FUNCTION gtk_packer_new ##### -->
2913 <para>
2914
2915 </para>
2916
2917 @Returns:
2918
2919 <!-- ##### FUNCTION gtk_packer_reorder_child ##### -->
2920 <para>
2921
2922 </para>
2923
2924 @packer:
2925 @child:
2926 @position:
2927
2928 <!-- ##### FUNCTION gtk_packer_set_child_packing ##### -->
2929 <para>
2930
2931 </para>
2932
2933 @packer:
2934 @child:
2935 @side:
2936 @anchor:
2937 @options:
2938 @border_width:
2939 @pad_x:
2940 @pad_y:
2941 @i_pad_x:
2942 @i_pad_y:
2943
2944 <!-- ##### FUNCTION gtk_packer_set_default_border_width ##### -->
2945 <para>
2946
2947 </para>
2948
2949 @packer:
2950 @border:
2951
2952 <!-- ##### FUNCTION gtk_packer_set_default_ipad ##### -->
2953 <para>
2954
2955 </para>
2956
2957 @packer:
2958 @i_pad_x:
2959 @i_pad_y:
2960
2961 <!-- ##### FUNCTION gtk_packer_set_default_pad ##### -->
2962 <para>
2963
2964 </para>
2965
2966 @packer:
2967 @pad_x:
2968 @pad_y:
2969
2970 <!-- ##### FUNCTION gtk_packer_set_spacing ##### -->
2971 <para>
2972
2973 </para>
2974
2975 @packer:
2976 @spacing:
2977
2978 <!-- ##### FUNCTION gtk_paned_compute_position ##### -->
2979 <para>
2980 Internal function used by #GtkHPaned and #GtkVPaned
2981 </para>
2982
2983 @paned:
2984 @allocation:
2985 @child1_req:
2986 @child2_req:
2987
2988 <!-- ##### MACRO gtk_paned_handle_size ##### -->
2989 <para>
2990 Old name for gtk_paned_set_handle_size().
2991 </para>
2992
2993
2994 <!-- ##### FUNCTION gtk_paned_set_handle_size ##### -->
2995 <para>
2996 Set the the handle size to @size x @size pixels.
2997 </para>
2998
2999 @paned: a paned widget
3000 @size: the size in pixels
3001
3002 <!-- ##### FUNCTION gtk_pattern_match ##### -->
3003 <para>
3004
3005 </para>
3006
3007 @pspec:
3008 @string_length:
3009 @string:
3010 @string_reversed:
3011 @Returns:
3012
3013 <!-- ##### FUNCTION gtk_pattern_match_simple ##### -->
3014 <para>
3015
3016 </para>
3017
3018 @pattern:
3019 @string:
3020 @Returns:
3021
3022 <!-- ##### FUNCTION gtk_pattern_match_string ##### -->
3023 <para>
3024
3025 </para>
3026
3027 @pspec:
3028 @string:
3029 @Returns:
3030
3031 <!-- ##### FUNCTION gtk_pattern_spec_free_segs ##### -->
3032 <para>
3033
3034 </para>
3035
3036 @pspec:
3037
3038 <!-- ##### FUNCTION gtk_pattern_spec_init ##### -->
3039 <para>
3040
3041 </para>
3042
3043 @pspec:
3044 @pattern:
3045
3046 <!-- ##### FUNCTION gtk_print_context_create_context ##### -->
3047 <para>
3048
3049 </para>
3050
3051 @context:
3052 @Returns:
3053
3054 <!-- ##### FUNCTION gtk_print_context_create_layout ##### -->
3055 <para>
3056
3057 </para>
3058
3059 @context:
3060 @Returns:
3061
3062 <!-- ##### FUNCTION gtk_print_context_get_cairo ##### -->
3063 <para>
3064
3065 </para>
3066
3067 @context:
3068 @Returns:
3069
3070 <!-- ##### FUNCTION gtk_print_context_get_fontmap ##### -->
3071 <para>
3072
3073 </para>
3074
3075 @context:
3076 @Returns:
3077
3078 <!-- ##### FUNCTION gtk_print_operation_set_nr_of_pages ##### -->
3079 <para>
3080
3081 </para>
3082
3083 @op:
3084 @n_pages:
3085
3086 <!-- ##### FUNCTION gtk_print_settings_get_num_copies ##### -->
3087 <para>
3088
3089 </para>
3090
3091 @settings:
3092 @Returns:
3093
3094 <!-- ##### FUNCTION gtk_print_settings_get_print_to_file ##### -->
3095 <para>
3096
3097 </para>
3098
3099 @settings:
3100 @Returns:
3101
3102 <!-- ##### FUNCTION gtk_print_settings_set_num_copies ##### -->
3103 <para>
3104
3105 </para>
3106
3107 @settings:
3108 @num_copies:
3109
3110 <!-- ##### FUNCTION gtk_print_settings_set_print_to_file ##### -->
3111 <para>
3112
3113 </para>
3114
3115 @settings:
3116 @print_to_file:
3117
3118 <!-- ##### FUNCTION gtk_rc_init ##### -->
3119 <para>
3120 Internal function.
3121 </para>
3122
3123
3124 <!-- ##### FUNCTION gtk_rc_load_image ##### -->
3125 <para>
3126 Internal function. Loads an image using the current
3127 image loader.
3128 </para>
3129
3130 @colormap: the colormap to use for the image
3131 @transparent_color: the transparent color for the image
3132 @filename: the filename of the image file
3133 @Returns: a #GtkPixmap representing @filename
3134
3135 <!-- ##### FUNCTION gtk_rc_set_image_loader ##### -->
3136 <para>
3137 Sets the function that GTK+ will use to load images
3138 </para>
3139
3140 @loader: the #GtkImageLoader to use
3141
3142 <!-- ##### FUNCTION gtk_ruler_draw_pos ##### -->
3143 <para>
3144
3145 </para>
3146
3147 @ruler: the gtkruler
3148
3149 <!-- ##### FUNCTION gtk_ruler_draw_ticks ##### -->
3150 <para>
3151
3152 </para>
3153
3154 @ruler: the gtkruler
3155
3156 <!-- ##### FUNCTION gtk_selection_incr_event ##### -->
3157 <para>
3158 Internal function.
3159 </para>
3160
3161 @window:
3162 @event:
3163 @Returns:
3164
3165 <!-- ##### FUNCTION gtk_selection_notify ##### -->
3166 <para>
3167 Internal function.
3168 </para>
3169
3170 @widget:
3171 @event:
3172 @Returns:
3173
3174 <!-- ##### FUNCTION gtk_selection_property_notify ##### -->
3175 <para>
3176 Internal function.
3177 </para>
3178
3179 @widget:
3180 @event:
3181 @Returns:
3182
3183 <!-- ##### FUNCTION gtk_selection_request ##### -->
3184 <para>
3185 Internal function.
3186 </para>
3187
3188 @widget:
3189 @event:
3190 @Returns:
3191
3192 <!-- ##### FUNCTION gtk_settings_get_global ##### -->
3193 <para>
3194
3195 </para>
3196
3197 @Returns:
3198
3199 <!-- ##### FUNCTION gtk_signal_add_emission_hook ##### -->
3200 <para>
3201 Add an emission hook for a type of signal, for any object.
3202 </para>
3203
3204 @signal_id: the type of signal to hook for.
3205 @hook_func: the function to invoke to handle the emission hook.
3206 @data: the user data passed in to hook_func.
3207 @Returns: the id (that you may pass as a parameter
3208 to gtk_signal_remove_emission_hook()).
3209 @i:
3210 @h:
3211 @d:
3212
3213 <!-- ##### FUNCTION gtk_signal_add_emission_hook_full ##### -->
3214 <para>
3215 Add an emission hook for a type of signal, for any object.
3216 (with control of what happens when the hook is
3217 destroyed).
3218 </para>
3219
3220 @signal_id: the type of signal add the hook for.
3221 @hook_func: the function to invoke to handle the hook.
3222 @data: the user data passed in to hook_func.
3223 @destroy: a function to invoke when the hook is destroyed,
3224 to clean up any allocation done just for this
3225 signal handler.
3226 @Returns: the id (that you may pass as a parameter
3227 to gtk_signal_remove_emission_hook()).
3228
3229 <!-- ##### FUNCTION gtk_signal_handler_pending_by_id ##### -->
3230 <para>
3231 Returns whether a connection id is valid (and optionally not blocked).
3232 </para>
3233
3234 @object: the object to search for the desired handler.
3235 @handler_id: the connection id.
3236 @may_be_blocked: whether it is acceptable to return a blocked
3237 handler.
3238 @Returns: TRUE if the signal exists and wasn't blocked,
3239 unless #may_be_blocked was specified.  FALSE otherwise.
3240
3241 <!-- ##### FUNCTION gtk_signal_handlers_destroy ##### -->
3242 <para>
3243 Destroy all the signal handlers connected to an object.
3244 This is done automatically when the object is destroyed.
3245 </para>
3246 <para>
3247 This function is labeled private.
3248 </para>
3249
3250 @object: the object whose signal handlers should be destroyed.
3251
3252 <!-- ##### FUNCTION gtk_signal_init ##### -->
3253 <para>
3254
3255 </para>
3256
3257
3258 <!-- ##### FUNCTION gtk_signal_n_emissions ##### -->
3259 <para>
3260 Find out the recursion depth of emissions for a particular type
3261 of signal and object.  (So it will
3262 always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified)
3263 This is a way to avoid recursion:  you can see if
3264 you are currently running in that signal handler and emit it only
3265 if you are.
3266 </para>
3267 <para>Another way to look at it is that this number increases
3268 by one when #gtk_signal_emit(), et al, are called,
3269 and decreases by one when #gtk_signal_emit() returns.
3270 </para>
3271
3272 @object: the object with the signal handler.
3273 @signal_id: the signal id.
3274 @Returns: the recursion depth of emissions of this signal for this
3275 object.
3276
3277 <!-- ##### FUNCTION gtk_signal_n_emissions_by_name ##### -->
3278 <para>
3279 Find out the recursion depth of emissions for a particular type
3280 of signal and object.  Just like gtk_signal_n_emissions()
3281 except it will lookup the signal id for you.
3282 </para>
3283
3284 @object: the object with the signal handler.
3285 @name: the signal name.
3286 @Returns: the recursion depth of emissions of this signal for this
3287 object.
3288
3289 <!-- ##### FUNCTION gtk_signal_query ##### -->
3290 <para>
3291 Obtain information about a signal.
3292 </para>
3293
3294 @signal_id: the signal type identifier.
3295 @Returns: a pointer to a GtkSignalQuery structure
3296 which contains all the information, or NULL.
3297 The pointer is allocated just for you:  you must g_free() it.
3298
3299 <!-- ##### FUNCTION gtk_signal_remove_emission_hook ##### -->
3300 <para>
3301 Delete an emission hook. (see gtk_signal_add_emission_hook())
3302 </para>
3303
3304 @signal_id: the id of the signal type.
3305 @hook_id: the id of the emission handler, returned by add_emission_hook().
3306 @i:
3307 @h:
3308
3309 <!-- ##### FUNCTION gtk_signal_set_funcs ##### -->
3310 <para>
3311 These set default functions to call when the user didn't
3312 supply a function when connecting.  (These are rarely
3313 used, and probably only for language bindings)
3314 </para>
3315 <para>
3316 By default, there are no such functions.
3317 </para>
3318
3319 @marshal_func: the function to invoke on every handlers for which there
3320 isn't a function pointer.  May be NULL.
3321 @destroy_func: the function to invoke when each hook is destroyed.
3322 May be NULL.
3323
3324 <!-- ##### FUNCTION gtk_spin_button_set_shadow_type ##### -->
3325 <para>
3326 Creates a border around the arrows of a #GtkSpinButton. The type of border is determined by @shadow_type.
3327 </para>
3328
3329 @spin_button: a #GtkSpinButton
3330 @shadow_type: the new border type.
3331
3332 <!-- ##### FUNCTION gtk_stock_list_items ##### -->
3333 <para>
3334
3335 </para>
3336
3337 @Returns:
3338
3339 <!-- ##### FUNCTION gtk_style_get_font_for_display ##### -->
3340 <para>
3341
3342 </para>
3343
3344 @display:
3345 @style:
3346 @Returns:
3347
3348 <!-- ##### FUNCTION gtk_text_buffer_paste_primary ##### -->
3349 <para>
3350
3351 </para>
3352
3353 @buffer:
3354 @override_location:
3355 @default_editable:
3356
3357 <!-- ##### FUNCTION gtk_text_iter_reorder ##### -->
3358 <para>
3359
3360 </para>
3361
3362 @first:
3363 @second:
3364
3365 <!-- ##### FUNCTION gtk_text_iter_spew ##### -->
3366 <para>
3367
3368 </para>
3369
3370 @iter:
3371 @desc:
3372
3373 <!-- ##### FUNCTION gtk_text_view_set_text_window_size ##### -->
3374 <para>
3375
3376 </para>
3377
3378 @text_view:
3379 @width:
3380 @height:
3381
3382 <!-- ##### FUNCTION gtk_tips_query_get_type ##### -->
3383 <para>
3384
3385 </para>
3386
3387 @Returns:
3388
3389 <!-- ##### FUNCTION gtk_tool_item_get_pack_end ##### -->
3390 <para>
3391
3392 </para>
3393
3394 @tool_item:
3395 @Returns:
3396
3397 <!-- ##### FUNCTION gtk_tool_item_set_pack_end ##### -->
3398 <para>
3399
3400 </para>
3401
3402 @tool_item:
3403 @pack_end:
3404
3405 <!-- ##### FUNCTION gtk_tool_item_toolbar_reconfigured ##### -->
3406 <para>
3407
3408 </para>
3409
3410 @tool_item:
3411
3412 <!-- ##### FUNCTION gtk_trace_referencing ##### -->
3413 <para>
3414 Private: print debugging information while doing a gtk_object_ref() or
3415 a gtk_object_unref().
3416 </para>
3417
3418 @object: object to reference or unreference.
3419 @func: name of caller's function to print (used within macros).
3420 @dummy: unused.
3421 @line: line number (used within macros).
3422 @do_ref: whether to reference or unreference.
3423
3424 <!-- ##### FUNCTION gtk_tree_model_ref_iter ##### -->
3425 <para>
3426
3427 </para>
3428
3429 @tree_model:
3430 @iter:
3431
3432 <!-- ##### FUNCTION gtk_tree_model_sort_convert_iter ##### -->
3433 <para>
3434
3435 </para>
3436
3437 @tree_model_sort:
3438 @sort_iter:
3439 @child_iter:
3440
3441 <!-- ##### FUNCTION gtk_tree_model_sort_convert_path ##### -->
3442 <para>
3443
3444 </para>
3445
3446 @tree_model_sort:
3447 @child_path:
3448 @Returns:
3449 @path:
3450
3451 <!-- ##### FUNCTION gtk_tree_model_sort_new ##### -->
3452 <para>
3453
3454 </para>
3455
3456 @Returns:
3457
3458 <!-- ##### FUNCTION gtk_tree_model_sort_set_compare ##### -->
3459 <para>
3460
3461 </para>
3462
3463 @tree_model_sort:
3464 @func:
3465
3466 <!-- ##### FUNCTION gtk_tree_model_sort_set_model ##### -->
3467 <para>
3468
3469 </para>
3470
3471 @tree_model_sort:
3472 @child_model:
3473 @model:
3474
3475 <!-- ##### FUNCTION gtk_tree_model_sort_set_sort_column ##### -->
3476 <para>
3477
3478 </para>
3479
3480 @tree_model_sort:
3481 @sort_col:
3482
3483 <!-- ##### FUNCTION gtk_tree_model_unref_iter ##### -->
3484 <para>
3485
3486 </para>
3487
3488 @tree_model:
3489 @iter:
3490
3491 <!-- ##### FUNCTION gtk_tree_store_move ##### -->
3492 <para>
3493
3494 </para>
3495
3496 @tree_store:
3497 @iter:
3498 @position:
3499
3500 <!-- ##### FUNCTION gtk_tree_store_new_with_types ##### -->
3501 <para>
3502
3503 </para>
3504
3505 @n_columns:
3506 @Varargs:
3507 @Returns:
3508
3509 <!-- ##### FUNCTION gtk_tree_store_set_cell ##### -->
3510 <para>
3511
3512 </para>
3513
3514 @tree_store:
3515 @iter:
3516 @column:
3517 @value:
3518
3519 <!-- ##### FUNCTION gtk_tree_store_set_column_type ##### -->
3520 <para>
3521
3522 </para>
3523
3524 @tree_store:
3525 @column:
3526 @type:
3527 @store:
3528
3529 <!-- ##### FUNCTION gtk_tree_store_set_n_columns ##### -->
3530 <para>
3531
3532 </para>
3533
3534 @tree_store:
3535 @n_columns:
3536
3537 <!-- ##### FUNCTION gtk_tree_view_column_cell_event ##### -->
3538 <para>
3539
3540 </para>
3541
3542 @tree_column:
3543 @event:
3544 @path_string:
3545 @background_area:
3546 @cell_area:
3547 @flags:
3548 @Returns:
3549
3550 <!-- ##### FUNCTION gtk_tree_view_column_set_cell_data ##### -->
3551 <para>
3552
3553 </para>
3554
3555 @tree_column:
3556 @tree_model:
3557 @iter:
3558
3559 <!-- ##### FUNCTION gtk_tree_view_column_set_cell_renderer ##### -->
3560 <para>
3561
3562 </para>
3563
3564 @tree_column:
3565 @cell:
3566
3567 <!-- ##### FUNCTION gtk_tree_view_column_set_width ##### -->
3568 <para>
3569
3570 </para>
3571
3572 @tree_column:
3573 @width:
3574 @size:
3575
3576 <!-- ##### FUNCTION gtk_tree_view_set_rows_drag_dest ##### -->
3577 <para>
3578
3579 </para>
3580
3581 @tree_view:
3582 @targets:
3583 @n_targets:
3584 @actions:
3585 @location_droppable_func:
3586 @user_data:
3587
3588 <!-- ##### FUNCTION gtk_tree_view_set_rows_drag_source ##### -->
3589 <para>
3590
3591 </para>
3592
3593 @tree_view:
3594 @start_button_mask:
3595 @targets:
3596 @n_targets:
3597 @actions:
3598 @row_draggable_func:
3599 @user_data:
3600
3601 <!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
3602 <para>
3603 Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make
3604 sure that it's okay to cast something of that @klass into a @cast_type.
3605 </para>
3606
3607 @klass: GtkTypeClass*
3608 @cast_type: GtkType
3609 @Returns: Always return @klass.
3610
3611 <!-- ##### FUNCTION gtk_type_check_object_cast ##### -->
3612 <para>
3613 Given a pointer to a GtkTypeObject @type_object, and a GtkType @cast_type,
3614 make sure that it's okay to cast @type_object into a @cast_type.
3615 </para>
3616
3617 @type_object: GtkTypeObject*
3618 @cast_type: GtkType
3619 @Returns: the same GtkTypeObject* as @type_object
3620
3621 <!-- ##### FUNCTION gtk_type_children_types ##### -->
3622 <para>
3623 Return the pointer to the type's children's types.
3624 </para>
3625
3626 @type: GtkType
3627 @Returns: pointer to a GList
3628
3629 <!-- ##### FUNCTION gtk_type_describe_heritage ##### -->
3630 <para>
3631 Print the types @type inherits from.
3632 </para>
3633
3634 @type: GtkType
3635
3636 <!-- ##### FUNCTION gtk_type_describe_tree ##### -->
3637 <para>
3638 Given a @type, describe all of its children, and their children.  Only
3639 show the size if @show_size is true.
3640 </para>
3641
3642 @type: GtkType
3643 @show_size: gboolean
3644
3645 <!-- ##### FUNCTION gtk_type_free ##### -->
3646 <para>
3647 Given the type of an object and a pointer to it, the object is freed.
3648 </para>
3649
3650 @type: GtkType
3651 @mem: gpointer to the object
3652
3653 <!-- ##### FUNCTION gtk_type_get_varargs_type ##### -->
3654 <para>
3655 Get the varargs type associated with @foreign_type
3656 </para>
3657
3658 @foreign_type: GtkType
3659 @Returns: GtkType
3660
3661 <!-- ##### FUNCTION gtk_type_parent_class ##### -->
3662 <para>
3663 Return the class of the parent.  Initialize the class if necessary.
3664 Return NULL if anything goes wrong.
3665 </para>
3666
3667 @type: GtkType
3668 @Returns: gpointer to the klass.
3669
3670 <!-- ##### FUNCTION gtk_type_query ##### -->
3671 <para>
3672 Given a type, return various interesting parameters of the type.
3673 </para>
3674
3675 @type: GtkType
3676 @Returns: GtkTypeQuery*
3677
3678 <!-- ##### FUNCTION gtk_type_register_enum ##### -->
3679 <para>
3680 Register a new set of enum @values and give them the name in
3681 @type_name.
3682 </para>
3683
3684 @type_name: must not be null.
3685 @values: GtkEnumValue*
3686 @Returns:
3687
3688 <!-- ##### FUNCTION gtk_type_register_flags ##### -->
3689 <para>
3690 Register a new set of flags @values and give them the name in
3691 @type_name.
3692 </para>
3693
3694 @type_name: must not be null.
3695 @values: GtkFlagValue*
3696 @Returns:
3697
3698 <!-- ##### FUNCTION gtk_type_set_chunk_alloc ##### -->
3699 <para>
3700 Set the mem_chunk size so it will hold @n_chunks of the objects of that @type.
3701 </para>
3702
3703 @type: There must be an unlocked TypeNode associated with this type otherwise nothing happens.
3704 @n_chunks:
3705
3706 <!-- ##### FUNCTION gtk_type_set_varargs_type ##### -->
3707 <para>
3708 Set the varargs type for a fundamental type @foreign_type.
3709 </para>
3710
3711 @foreign_type: Must be a GtkType with a sequence number of zero.  Must not be a
3712 fundamental type.
3713 @varargs_type: Must be a GtkType which is either structured or flag, or NONE.
3714
3715 <!-- ##### FUNCTION gtk_widget_accelerator_signal ##### -->
3716 <para>
3717
3718 </para>
3719
3720 @widget:
3721 @accel_group:
3722 @accel_key:
3723 @accel_mods:
3724 @Returns:
3725
3726 <!-- ##### FUNCTION gtk_widget_accelerators_locked ##### -->
3727 <para>
3728
3729 </para>
3730
3731 @widget:
3732 @Returns:
3733
3734 <!-- ##### FUNCTION gtk_widget_activate_mnemonic ##### -->
3735 <para>
3736
3737 </para>
3738
3739 @widget:
3740 @group_cycling:
3741 @Returns:
3742
3743 <!-- ##### FUNCTION gtk_widget_get_usize ##### -->
3744 <para>
3745
3746 </para>
3747
3748 @widget:
3749 @width:
3750 @height:
3751
3752 <!-- ##### FUNCTION gtk_widget_lock_accelerators ##### -->
3753 <para>
3754
3755 </para>
3756
3757 @widget:
3758
3759 <!-- ##### FUNCTION gtk_widget_pop_style ##### -->
3760 <para>
3761
3762 </para>
3763
3764
3765 <!-- ##### FUNCTION gtk_widget_popup ##### -->
3766 <para>
3767
3768 </para>
3769
3770 @widget:
3771 @x:
3772 @y:
3773
3774 <!-- ##### FUNCTION gtk_widget_push_style ##### -->
3775 <para>
3776
3777 </para>
3778
3779 @style:
3780
3781 <!-- ##### FUNCTION gtk_widget_remove_accelerators ##### -->
3782 <para>
3783
3784 </para>
3785
3786 @widget:
3787 @accel_signal:
3788 @visible_only:
3789
3790 <!-- ##### FUNCTION gtk_widget_set_default_style ##### -->
3791 <para>
3792
3793 </para>
3794
3795 @style:
3796
3797 <!-- ##### FUNCTION gtk_widget_unlock_accelerators ##### -->
3798 <para>
3799
3800 </para>
3801
3802 @widget:
3803
3804 <!-- ##### FUNCTION gtk_window_activate_mnemonic ##### -->
3805 <para>
3806
3807 </para>
3808
3809 @window:
3810 @keyval:
3811 @modifier:
3812 @Returns:
3813
3814 <!-- ##### FUNCTION gtk_window_get_default_accel_group ##### -->
3815 <para>
3816
3817 </para>
3818
3819 @window:
3820 @Returns:
3821
3822 <!-- ##### FUNCTION gtk_window_get_resizeable ##### -->
3823 <para>
3824
3825 </para>
3826
3827 @window:
3828 @Returns:
3829
3830 <!-- ##### FUNCTION gtk_window_set_decorations_hint ##### -->
3831 <para>
3832
3833 </para>
3834
3835 @window:
3836 @decorations:
3837
3838 <!-- ##### FUNCTION gtk_window_set_functions_hint ##### -->
3839 <para>
3840
3841 </para>
3842
3843 @window:
3844 @functions:
3845
3846 <!-- ##### FUNCTION gtk_window_set_resizeable ##### -->
3847 <para>
3848
3849 </para>
3850
3851 @window:
3852 @setting:
3853 @resizeable:
3854