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