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