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