Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtk-unused.sgml

   1 <!-- ##### SECTION ./tmpl/gtkdebug.sgml:Title ##### -->
   2 Debugging
   3
   4
   5 <!-- ##### SIGNAL GtkEditable::cut-clipboard ##### -->
   6 <para>
   7 An action signal. Causes the characters in the current
   8 selection to be copied to the clipboard and then deleted from
   9 the widget.
  10 </para>
  11
  12 @editable: the object which received the signal.
  13
  14 <!-- ##### SECTION ./tmpl/gtkdebug.sgml:Short_Description ##### -->
  15
  16
  17
  18 <!-- ##### MACRO gtk_marshal_NONE__BOXED ##### -->
  19 <para>
  20
  21 </para>
  22
  23
  24 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Long_Description ##### -->
  25 <refsect2>
  26 <title>What are Signal Marshallers?</title>
  27 <para>
  28 Marshals are functions which all have the same prototype:
  29 they take a #GtkObject, a #GtkSignalFunc, a #gpointer,
  30 and an array of argument values.
  31 The functions are names gtk_marshall_RETURNTYPE__PARAMTYPE1_PARAMTYPE2....
  32 </para>
  33 <para>
  34 They then call a native function:  the GtkObject is the first
  35 parameter passed in.  The arguments are passed in the native
  36 calling convention:  chars, shorts, ints, longs may be packed
  37 on the stack, or tucked in registers:  it doesn't matter
  38 because the same calling convention will be generated
  39 inside the gtkmarshal code as is expected where you define
  40 your handlers.
  41 </para>
  42 <para>
  43 So the function named:
  44 <programlisting>
  45 gtk_marshal_BOOL__POINTER_INT_INT_UINT(GtkObject*, GtkSignalFunc, gpointer, GtkArg*);
  46 </programlisting>
  47 will call the #GtkSignalFunc assuming it was a function with signature:
  48 <programlisting>
  49 gboolean sigfunc(gpointer,gint,gint,guint);
  50 </programlisting>
  51 </para>
  52 </refsect2>
  53 <refsect2>
  54 <title>Writing Custom Marshals</title>
  55 <para>
  56 Marshals are primarily used as arguments to gtk_signal_new().
  57 Sometimes, you may find that a marshaller you need isn't available
  58 in the standard list.  Then you have to write your own.
  59 </para>
  60 <para>
  61 If you wish to define a signal with a new type of argument list.
  62 Suppose you want 2 pointers and 2 integers.
  63 You would write:
  64 <programlisting>
  65 typedef int (*GtkSignal_INT__POINTER_POINTER_INT_INT)(
  66                         gpointer, gpointer, gint, gint
  67 );
  68
  69 void marshal_INT__POINTER_POINTER_INT_INT(GtkObject*    object,
  70                                            GtkSignalFunc func,
  71                                            gpointer      func_data,
  72                                            GtkArg*       args)
  73 {
  74         GtkSignal_NONE__POINTER_POINTER_INT_INT rfunc;
  75         gint* return_val;
  76         return_val = GTK_RETLOC_INT(args[4]);
  77         rfunc = (GtkSignal_INT__POINTER_POINTER_INT_INT)func;
  78         *return_val = (*rfunc)(object,
  79                                GTK_VALUE_POINTER(args[0]),
  80                                GTK_VALUE_POINTER(args[1]),
  81                                GTK_VALUE_INT(args[2]),
  82                                GTK_VALUE_INT(args[3]),
  83                                func_data);
  84 }
  85 </programlisting>
  86 </para>
  87 </refsect2>
  88
  89
  90 <!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Short_Description ##### -->
  91
  92
  93
  94 <!-- ##### MACRO gtk_marshal_NONE__UINT_STRING ##### -->
  95 <para>
  96
  97 </para>
  98
  99
 100 <!-- ##### MACRO GTK_PRIVATE_UNSET_FLAG ##### -->
 101 <para>
 102
 103 </para>
 104
 105 @wid:
 106 @flag:
 107
 108 <!-- ##### MACRO GTK_WIDGET_REDRAW_PENDING ##### -->
 109 <para>
 110
 111 </para>
 112
 113 @obj:
 114
 115 <!-- ##### FUNCTION gtk_icon_factory_get_type ##### -->
 116 <para>
 117
 118 </para>
 119
 120 @Returns:
 121
 122 <!-- ##### FUNCTION gtk_theme_engine_create_rc_style ##### -->
 123 <para>
 124
 125 </para>
 126
 127 @engine:
 128 @Returns:
 129
 130 <!-- ##### MACRO gtk_marshal_NONE__ENUM_FLOAT ##### -->
 131 <para>
 132
 133 </para>
 134
 135
 136 <!-- ##### FUNCTION gtk_tree_store_new_with_values ##### -->
 137 <para>
 138
 139 </para>
 140
 141 @n_columns:
 142 @Varargs:
 143 @Returns:
 144
 145 <!-- ##### SIGNAL GtkTextView::insert ##### -->
 146 <para>
 147
 148 </para>
 149
 150 @textview: the object which received the signal.
 151 @arg1:
 152
 153 <!-- ##### MACRO gtk_widget_set_default_visual ##### -->
 154 <para>
 155
 156 </para>
 157
 158 @v:
 159 @visual:
 160
 161 <!-- ##### FUNCTION gtk_window_set_focus ##### -->
 162 <para>
 163
 164 </para>
 165
 166 @window:
 167 @focus:
 168
 169 <!-- ##### SECTION ./tmpl/gtkprivate.sgml:See_Also ##### -->
 170 <para>
 171
 172 </para>
 173
 174
 175 <!-- ##### ARG GtkTextTag:font_set ##### -->
 176 <para>
 177
 178 </para>
 179
 180
 181 <!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT_ENUM ##### -->
 182 <para>
 183
 184 </para>
 185
 186
 187 <!-- ##### ARG GtkEditable:editable ##### -->
 188 <para>
 189 A boolean indicating whether the widget is editable by
 190 the user.
 191 </para>
 192
 193
 194 <!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:See_Also ##### -->
 195 <para>
 196
 197 </para>
 198
 199
 200 <!-- ##### FUNCTION gtk_font_selection_set_filter ##### -->
 201 <para>
 202 Sets one of the two font filters, to limit the fonts shown.
 203 </para>
 204
 205 @fontsel: a #GtkFontSelection.
 206 @filter_type: which of the two font filters to set, either
 207 #GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
 208 can be changed by the user, but the base filter is permanent.
 209 @font_type: the types of font to be shown. This is a bitwise combination of
 210 #GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
 211 or #GTK_FONT_ALL to show all three font types.
 212 @foundries: a NULL-terminated array of strings containing foundry names which
 213 will be shown, or NULL to show all foundries.
 214 @weights: a NULL-terminated array of strings containing weight names which
 215 will be shown, or NULL to show all weights.
 216 @slants: a NULL-terminated array of strings containing slant names which
 217 will be shown, or NULL to show all slants.
 218 @setwidths: a NULL-terminated array of strings containing setwidth names which
 219 will be shown, or NULL to show all setwidths.
 220 @spacings: a NULL-terminated array of strings containing spacings which
 221 will be shown, or NULL to show all spacings.
 222 @charsets: a NULL-terminated array of strings containing charset names which
 223 will be shown, or NULL to show all charsets.
 224
 225 <!-- ##### FUNCTION gtk_container_unregister_toplevel ##### -->
 226 <para>
 227
 228 </para>
 229
 230 @container:
 231
 232 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Title ##### -->
 233 Signal Marshallers
 234
 235
 236 <!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Long_Description ##### -->
 237 <para>
 238
 239 </para>
 240
 241
 242 <!-- ##### STRUCT GtkTypeQuery ##### -->
 243 <para>
 244 A structure used to return values from @gtk_type_query.
 245 </para>
 246
 247 @type:
 248 @type_name:
 249 @object_size:
 250 @class_size:
 251
 252 <!-- ##### FUNCTION gtk_text_buffer_get_clipboard_contents ##### -->
 253 <para>
 254
 255 </para>
 256
 257 @buffer:
 258 @Returns:
 259
 260 <!-- ##### MACRO gtk_widget_pop_visual ##### -->
 261 <para>
 262
 263 </para>
 264
 265 @v:
 266
 267 <!-- ##### FUNCTION gtk_marshal_NONE__C_CALLBACK ##### -->
 268 <para>
 269
 270 </para>
 271
 272 @object:
 273 @func:
 274 @func_data:
 275 @args:
 276
 277 <!-- ##### USER_FUNCTION GtkSignalMarshal ##### -->
 278 <para>
 279 This is currently a hack left in for a scheme wrapper library.
 280 It may be removed.
 281 </para>
 282 <para>
 283 Don't use it.
 284 </para>
 285
 286 @object: The object which emits the signal.
 287 @data: The user data associated with the hook.
 288 @nparams: The number of parameters to the function.
 289 @args: The actual values of the arguments.
 290 @arg_types: The types of the arguments.
 291 @return_type: The type of the return value from the function
 292 or #GTK_TYPE_NONE for no return value.
 293
 294 <!-- ##### FUNCTION gtk_signal_add_emission_hook_full ##### -->
 295 <para>
 296 Add an emission hook for a type of signal, for any object.
 297 (with control of what happens when the hook is
 298 destroyed).
 299 </para>
 300
 301 @signal_id: the type of signal add the hook for.
 302 @hook_func: the function to invoke to handle the hook.
 303 @data: the user data passed in to hook_func.
 304 @destroy: a function to invoke when the hook is destroyed,
 305 to clean up any allocation done just for this
 306 signal handler.
 307 @Returns: the id (that you may pass as a parameter
 308 to gtk_signal_remove_emission_hook()).
 309
 310 <!-- ##### FUNCTION gtk_text_buffer_paste_primary_selection ##### -->
 311 <para>
 312
 313 </para>
 314
 315 @buffer:
 316 @override_location:
 317 @time:
 318 @interactive:
 319 @default_editable:
 320
 321 <!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_INT_INT ##### -->
 322 <para>
 323
 324 </para>
 325
 326 @object:
 327 @func:
 328 @func_data:
 329 @args:
 330
 331 <!-- ##### SIGNAL GtkTextView::copy-text ##### -->
 332 <para>
 333
 334 </para>
 335
 336 @textview: the object which received the signal.
 337
 338 <!-- ##### FUNCTION gtk_text_view_get_iter_at_pixel ##### -->
 339 <para>
 340
 341 </para>
 342
 343 @text_view:
 344 @iter:
 345 @x:
 346 @y:
 347
 348 <!-- ##### STRUCT GtkThemeEngine ##### -->
 349 <para>
 350
 351 </para>
 352
 353
 354 <!-- ##### FUNCTION gtk_text_buffer_get_tags ##### -->
 355 <para>
 356
 357 </para>
 358
 359 @buffer:
 360 @iter:
 361 @Returns:
 362
 363 <!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Short_Description ##### -->
 364
 365
 366
 367 <!-- ##### FUNCTION gtk_identifier_get_type ##### -->
 368 <para>
 369 Get the type of GtkIdentifier.
 370 </para>
 371
 372 @Returns: GtkType -- the enumerated type of something.
 373
 374 <!-- ##### FUNCTION gtk_theme_engine_get ##### -->
 375 <para>
 376
 377 </para>
 378
 379 @name:
 380 @Returns:
 381
 382 <!-- ##### MACRO gtk_marshal_BOOL__POINTER_INT_INT_UINT ##### -->
 383 <para>
 384
 385 </para>
 386
 387
 388 <!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER ##### -->
 389 <para>
 390
 391 </para>
 392
 393 @object:
 394 @func:
 395 @func_data:
 396 @args:
 397
 398 <!-- ##### FUNCTION gtk_theme_engine_ref ##### -->
 399 <para>
 400
 401 </para>
 402
 403 @engine:
 404
 405 <!-- ##### FUNCTION gtk_marshal_NONE__INT_INT ##### -->
 406 <para>
 407
 408 </para>
 409
 410 @object:
 411 @func:
 412 @func_data:
 413 @args:
 414
 415 <!-- ##### FUNCTION gtk_marshal_NONE__NONE ##### -->
 416 <para>
 417
 418 </para>
 419
 420 @object:
 421 @func:
 422 @func_data:
 423 @args:
 424
 425 <!-- ##### FUNCTION gtk_text_mark_deleted ##### -->
 426 <para>
 427
 428 </para>
 429
 430 @mark:
 431 @Returns:
 432
 433 <!-- ##### MACRO gtk_marshal_BOOL__POINTER_STRING_STRING_POINTER ##### -->
 434 <para>
 435
 436 </para>
 437
 438
 439 <!-- ##### SIGNAL GtkEditable::set-editable ##### -->
 440 <para>
 441 Determines if the user can edit the text in the editable
 442 widget or not. This is meant to be overriden by
 443 child classes and should not generally useful to
 444 applications.
 445 </para>
 446
 447 @editable: the object which received the signal.
 448 @is_editable: %TRUE if the user is allowed to edit the text
 449   in the widget.
 450
 451 <!-- ##### SIGNAL GtkEditable::delete-text ##### -->
 452 <para>
 453 This signal is emitted when text is deleted from
 454 the widget by the user. The default handler for
 455 this signal will normally be responsible for inserting
 456 the text, so by connecting to this signal and then
 457 stopping the signal with gtk_signal_emit_stop(), it
 458 is possible to modify the inserted text, or prevent
 459 it from being inserted entirely. The @start_pos
 460 and @end_pos parameters are interpreted as for
 461 gtk_editable_delete_text()
 462 </para>
 463
 464 @editable: the object which received the signal.
 465 @start_pos: the starting position.
 466 @end_pos: the end position.
 467
 468 <!-- ##### FUNCTION gtk_ruler_draw_ticks ##### -->
 469 <para>
 470
 471 </para>
 472
 473 @ruler: the gtkruler
 474
 475 <!-- ##### SIGNAL GtkEditable::kill-line ##### -->
 476 <para>
 477 An action signal. Delete a single line.
 478 </para>
 479
 480 @editable: the object which received the signal.
 481 @direction: the direction in which to delete. Positive
 482    indicates forward deletion, negative, backwards deletion.
 483
 484 <!-- ##### FUNCTION gtk_themes_init ##### -->
 485 <para>
 486
 487 </para>
 488
 489 @argc:
 490 @argv:
 491
 492 <!-- ##### FUNCTION gtk_type_register_enum ##### -->
 493 <para>
 494 Register a new set of enum @values and give them the name in
 495 @type_name.
 496 </para>
 497
 498 @type_name: must not be null.
 499 @values: GtkEnumValue*
 500 @Returns:
 501
 502 <!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Title ##### -->
 503 Menu Factory
 504
 505
 506 <!-- ##### VARIABLE gtk_debug_flags ##### -->
 507 <para>
 508
 509 </para>
 510
 511
 512 <!-- ##### MACRO gtk_widget_set_visual ##### -->
 513 <para>
 514
 515 </para>
 516
 517 @w:
 518 @v:
 519 @widget:
 520 @visual:
 521
 522 <!-- ##### MACRO gtk_marshal_NONE__UINT_POINTER_UINT_ENUM_ENUM_POINTER ##### -->
 523 <para>
 524
 525 </para>
 526
 527
 528 <!-- ##### MACRO GTK_TYPE_SEQNO ##### -->
 529 <para>
 530 Convert a gtk type into its sequence number
 531 </para>
 532
 533 @type:
 534
 535 <!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:See_Also ##### -->
 536 <para>
 537
 538 </para>
 539
 540
 541 <!-- ##### ENUM GtkMenuFactoryType ##### -->
 542 <para>
 543
 544 </para>
 545
 546 @GTK_MENU_FACTORY_MENU:
 547 @GTK_MENU_FACTORY_MENU_BAR:
 548 @GTK_MENU_FACTORY_OPTION_MENU:
 549
 550 <!-- ##### MACRO gtk_marshal_NONE__STRING ##### -->
 551 <para>
 552
 553 </para>
 554
 555
 556 <!-- ##### MACRO gtk_marshal_NONE__POINTER_POINTER_UINT_UINT ##### -->
 557 <para>
 558
 559 </para>
 560
 561
 562 <!-- ##### MACRO GTK_WIDGET_IS_OFFSCREEN ##### -->
 563 <para>
 564
 565 </para>
 566
 567 @obj:
 568
 569 <!-- ##### MACRO GTK_MAX_COMPOSE_LEN ##### -->
 570 <para>
 571
 572 </para>
 573
 574
 575 <!-- ##### SECTION ./tmpl/gtkprivate.sgml:Short_Description ##### -->
 576
 577
 578
 579 <!-- ##### SIGNAL GtkTextView::cut-text ##### -->
 580 <para>
 581
 582 </para>
 583
 584 @textview: the object which received the signal.
 585
 586 <!-- ##### FUNCTION gtk_theme_engine_unref ##### -->
 587 <para>
 588
 589 </para>
 590
 591 @engine:
 592
 593 <!-- ##### STRUCT GtkDialogButton ##### -->
 594 <para>
 595 Deprecated.
 596 </para>
 597
 598
 599 <!-- ##### FUNCTION gtk_marshal_BOOL__POINTER ##### -->
 600 <para>
 601
 602 </para>
 603
 604 @object:
 605 @func:
 606 @func_data:
 607 @args:
 608
 609 <!-- ##### ARG GtkTextTag:overstrike_set ##### -->
 610 <para>
 611
 612 </para>
 613
 614
 615 <!-- ##### FUNCTION gtk_text_buffer_cut ##### -->
 616 <para>
 617
 618 </para>
 619
 620 @buffer:
 621 @time:
 622 @interactive:
 623 @default_editable:
 624
 625 <!-- ##### SIGNAL GtkEditable::activate ##### -->
 626 <para>
 627 Indicates that the user has activated the widget
 628 in some fashion. Generally, this will be done
 629 with a keystroke. (The default binding for this
 630 action is Return for #GtkEntry and
 631 Control-Return for #GtkText.)
 632 </para>
 633
 634 @editable: the object which received the signal.
 635
 636 <!-- ##### ENUM GtkTextViewMovementStep ##### -->
 637 <para>
 638
 639 </para>
 640
 641 @GTK_TEXT_MOVEMENT_CHAR:
 642 @GTK_TEXT_MOVEMENT_POSITIONS:
 643 @GTK_TEXT_MOVEMENT_WORD:
 644 @GTK_TEXT_MOVEMENT_WRAPPED_LINE:
 645 @GTK_TEXT_MOVEMENT_LINE:
 646 @GTK_TEXT_MOVEMENT_LINE_ENDS:
 647 @GTK_TEXT_MOVEMENT_BUFFER_ENDS:
 648
 649 <!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER_INT_INT ##### -->
 650 <para>
 651
 652 </para>
 653
 654 @object:
 655 @func:
 656 @func_data:
 657 @args:
 658
 659 <!-- ##### SECTION ./tmpl/gtkdebug.sgml:See_Also ##### -->
 660 <para>
 661
 662 </para>
 663
 664
 665 <!-- ##### MACRO GTK_CONTAINER_RESIZE_PENDING ##### -->
 666 <para>
 667
 668 </para>
 669
 670 @obj:
 671
 672 <!-- ##### SIGNAL GtkEditable::copy-clipboard ##### -->
 673 <para>
 674 An action signal. Causes the characters in the current selection to
 675 be copied to the clipboard.
 676 </para>
 677
 678 @editable: the object which received the signal.
 679
 680 <!-- ##### FUNCTION gtk_menu_factory_remove_entries ##### -->
 681 <para>
 682
 683 </para>
 684
 685 @factory:
 686 @entries:
 687 @nentries:
 688
 689 <!-- ##### FUNCTION gtk_text_buffer_find_string ##### -->
 690 <para>
 691
 692 </para>
 693
 694 @buffer:
 695 @iter:
 696 @str:
 697 @start:
 698 @end:
 699 @Returns:
 700
 701 <!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER_INT_INT_INT_POINTER ##### -->
 702 <para>
 703
 704 </para>
 705
 706 @object:
 707 @func:
 708 @func_data:
 709 @args:
 710
 711 <!-- ##### FUNCTION gtk_marshal_INT__INT ##### -->
 712 <para>
 713
 714 </para>
 715
 716 @object:
 717 @func:
 718 @func_data:
 719 @args:
 720
 721 <!-- ##### FUNCTION gtk_marshal_NONE__INT_FLOAT_BOOL ##### -->
 722 <para>
 723
 724 </para>
 725
 726 @object:
 727 @func:
 728 @func_data:
 729 @args:
 730
 731 <!-- ##### FUNCTION gtk_paned_compute_position ##### -->
 732 <para>
 733 Internal function used by #GtkHPaned and #GtkVPaned
 734 </para>
 735
 736 @paned:
 737 @allocation:
 738 @child1_req:
 739 @child2_req:
 740
 741 <!-- ##### MACRO gtk_marshal_NONE__POINTER_STRING_STRING ##### -->
 742 <para>
 743
 744 </para>
 745
 746
 747 <!-- ##### FUNCTION gtk_trace_referencing ##### -->
 748 <para>
 749 Private: print debugging information while doing a gtk_object_ref() or
 750 a gtk_object_unref().
 751 </para>
 752
 753 @object: object to reference or unreference.
 754 @func: name of caller's function to print (used within macros).
 755 @dummy: unused.
 756 @line: line number (used within macros).
 757 @do_ref: whether to reference or unreference.
 758
 759 <!-- ##### MACRO GTK_VALUE_CALLBACK ##### -->
 760 <para>
 761 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK
 762 </para>
 763
 764 @a:
 765
 766 <!-- ##### MACRO gtk_marshal_NONE__ENUM_FLOAT_BOOL ##### -->
 767 <para>
 768
 769 </para>
 770
 771
 772 <!-- ##### ENUM GtkFontType ##### -->
 773 <para>
 774 A set of bit flags used to specify the type of fonts shown
 775 when calling gtk_font_selection_dialog_set_filter() or
 776 gtk_font_selection_set_filter().
 777 </para>
 778
 779 @GTK_FONT_BITMAP: bitmap fonts.
 780 @GTK_FONT_SCALABLE: scalable fonts.
 781 @GTK_FONT_SCALABLE_BITMAP: scaled bitmap fonts.
 782 @GTK_FONT_ALL: a bitwise combination of all of the above.
 783
 784 <!-- ##### MACRO GTK_TYPE_STRUCTURED_LAST ##### -->
 785 <para>
 786 The last structured enumerated type value.
 787 </para>
 788
 789
 790 <!-- ##### MACRO GTK_OBJECT_NSIGNALS ##### -->
 791 <para>
 792 Get the number of signals defined by this object.
 793 </para>
 794
 795 @obj: the object to query.
 796
 797 <!-- ##### FUNCTION gtk_menu_factory_remove_subfactory ##### -->
 798 <para>
 799
 800 </para>
 801
 802 @factory:
 803 @subfactory:
 804 @path:
 805
 806 <!-- ##### FUNCTION gtk_type_children_types ##### -->
 807 <para>
 808 Return the pointer to the type's children's types.
 809 </para>
 810
 811 @type: GtkType
 812 @Returns: pointer to a GList
 813
 814 <!-- ##### SIGNAL GtkEditable::move-page ##### -->
 815 <para>
 816 An action signal. Move the cursor by pages.
 817 </para>
 818
 819 @editable: the object which received the signal.
 820 @x: Number of pages to move the cursor horizontally.
 821 @y: Number of pages to move the cursor vertically.
 822
 823 <!-- ##### FUNCTION gtk_type_register_flags ##### -->
 824 <para>
 825 Register a new set of flags @values and give them the name in
 826 @type_name.
 827 </para>
 828
 829 @type_name: must not be null.
 830 @values: GtkFlagValue*
 831 @Returns:
 832
 833 <!-- ##### SIGNAL GtkTextView::scroll-text ##### -->
 834 <para>
 835
 836 </para>
 837
 838 @textview: the object which received the signal.
 839 @arg1:
 840
 841 <!-- ##### ENUM GtkPrivateFlags ##### -->
 842 <para>
 843
 844 </para>
 845
 846 @PRIVATE_GTK_USER_STYLE:
 847 @PRIVATE_GTK_RESIZE_PENDING:
 848 @PRIVATE_GTK_RESIZE_NEEDED:
 849 @PRIVATE_GTK_LEAVE_PENDING:
 850 @PRIVATE_GTK_HAS_SHAPE_MASK:
 851 @PRIVATE_GTK_IN_REPARENT:
 852 @PRIVATE_GTK_DIRECTION_SET:
 853 @PRIVATE_GTK_DIRECTION_LTR:
 854
 855 <!-- ##### FUNCTION gtk_type_set_chunk_alloc ##### -->
 856 <para>
 857 Set the mem_chunk size so it will hold @n_chunks of the objects of that @type.
 858 </para>
 859
 860 @type: There must be an unlocked TypeNode associated with this type otherwise nothing happens.
 861 @n_chunks:
 862
 863 <!-- ##### MACRO GTK_TYPE_STRUCTURED_FIRST ##### -->
 864 <para>
 865 The first structured enumerated type value.
 866 </para>
 867
 868
 869 <!-- ##### STRUCT GtkSignalQuery ##### -->
 870 <para>
 871 This structure contains all the information about a particular
 872 signal:  its name, the type it affects, the signature of the handlers,
 873 and its unique identifying integer.
 874 </para>
 875
 876 @object_type:
 877 @signal_id:
 878 @signal_name:
 879 @is_user_signal:
 880 @signal_flags:
 881 @return_val:
 882 @nparams:
 883 @params:
 884
 885 <!-- ##### FUNCTION gtk_type_describe_tree ##### -->
 886 <para>
 887 Given a @type, describe all of its children, and their children.  Only
 888 show the size if @show_size is true.
 889 </para>
 890
 891 @type: GtkType
 892 @show_size: gboolean
 893
 894 <!-- ##### FUNCTION gtk_text_mark_is_visible ##### -->
 895 <para>
 896
 897 </para>
 898
 899 @mark:
 900 @Returns:
 901
 902 <!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_INT_INT_INT ##### -->
 903 <para>
 904
 905 </para>
 906
 907 @object:
 908 @func:
 909 @func_data:
 910 @args:
 911
 912 <!-- ##### SIGNAL GtkEditable::kill-char ##### -->
 913 <para>
 914 An action signal. Delete a single character.
 915 </para>
 916
 917 @editable: the object which received the signal.
 918 @direction: the direction in which to delete. Positive
 919    indicates forward deletion, negative, backwards deletion.
 920
 921 <!-- ##### SECTION ./tmpl/gtkdebug.sgml:Long_Description ##### -->
 922 <para>
 923
 924 </para>
 925
 926
 927 <!-- ##### FUNCTION gtk_window_remove_embedded_xid ##### -->
 928 <para>
 929
 930 </para>
 931
 932 @window:
 933 @xid:
 934
 935 <!-- ##### FUNCTION gtk_marshal_NONE__INT_FLOAT ##### -->
 936 <para>
 937
 938 </para>
 939
 940 @object:
 941 @func:
 942 @func_data:
 943 @args:
 944
 945 <!-- ##### FUNCTION gtk_text_iter_get_pixmap ##### -->
 946 <para>
 947
 948 </para>
 949
 950 @iter:
 951 @pixmap:
 952 @mask:
 953 @Returns:
 954
 955 <!-- ##### SIGNAL GtkEditable::kill-word ##### -->
 956 <para>
 957 An action signal. Delete a single word.
 958 </para>
 959
 960 @editable: the object which received the signal.
 961 @direction: the direction in which to delete. Positive
 962    indicates forward deletion, negative, backwards deletion.
 963
 964 <!-- ##### FUNCTION gtk_im_context_simple_add_table ##### -->
 965 <para>
 966
 967 </para>
 968
 969 @context_simple:
 970 @data:
 971 @max_seq_len:
 972 @n_seqs:
 973
 974 <!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT_UINT ##### -->
 975 <para>
 976
 977 </para>
 978
 979
 980 <!-- ##### FUNCTION gtk_font_selection_dialog_set_filter ##### -->
 981 <para>
 982 Sets one of the two font filters, to limit the fonts shown.
 983 </para>
 984
 985 @fsd: a #GtkFontSelectionDialog.
 986 @filter_type: which of the two font filters to set, either
 987 #GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
 988 can be changed by the user, but the base filter is permanent.
 989 @font_type: the types of font to be shown. This is a bitwise combination of
 990 #GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
 991 or #GTK_FONT_ALL to show all three font types.
 992 @foundries: a NULL-terminated array of strings containing foundry names which
 993 will be shown, or NULL to show all foundries.
 994 @weights: a NULL-terminated array of strings containing weight names which
 995 will be shown, or NULL to show all weights.
 996 @slants: a NULL-terminated array of strings containing slant names which
 997 will be shown, or NULL to show all slants.
 998 @setwidths: a NULL-terminated array of strings containing setwidth names which
 999 will be shown, or NULL to show all setwidths.
1000 @spacings: a NULL-terminated array of strings containing spacings which
1001 will be shown, or NULL to show all spacings.
1002 @charsets: a NULL-terminated array of strings containing charset names which
1003 will be shown, or NULL to show all charsets.
1004
1005 <!-- ##### SIGNAL GtkTextView::delete-text ##### -->
1006 <para>
1007
1008 </para>
1009
1010 @textview: the object which received the signal.
1011 @arg1:
1012 @arg2:
1013
1014 <!-- ##### FUNCTION gtk_container_get_toplevels ##### -->
1015 <para>
1016
1017 </para>
1018
1019 @Returns:
1020
1021 <!-- ##### ARG GtkTextTag:offset_set ##### -->
1022 <para>
1023
1024 </para>
1025
1026
1027 <!-- ##### MACRO GTK_TYPE_NUM_BUILTINS ##### -->
1028 <para>
1029 No idea.
1030 </para>
1031
1032
1033 <!-- ##### MACRO GTK_TYPE_MAKE ##### -->
1034 <para>
1035 Combine a fundemantal type and a sequence number to create a gtk type.
1036 </para>
1037
1038 @parent_t:
1039 @seqno:
1040
1041 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Short_Description ##### -->
1042 Functions to adapt C structures to native calling convention.
1043
1044
1045 <!-- ##### MACRO GTK_TYPE_FLAT_LAST ##### -->
1046 <para>
1047 The last "flat" (no struct) enumerated type value.
1048 </para>
1049
1050
1051 <!-- ##### FUNCTION gtk_text_mark_unref ##### -->
1052 <para>
1053
1054 </para>
1055
1056 @mark:
1057
1058 <!-- ##### FUNCTION gtk_marshal_NONE__POINTER ##### -->
1059 <para>
1060
1061 </para>
1062
1063 @object:
1064 @func:
1065 @func_data:
1066 @args:
1067
1068 <!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_POINTER ##### -->
1069 <para>
1070
1071 </para>
1072
1073 @object:
1074 @func:
1075 @func_data:
1076 @args:
1077
1078 <!-- ##### FUNCTION gtk_signal_handlers_destroy ##### -->
1079 <para>
1080 Destroy all the signal handlers connected to an object.
1081 This is done automatically when the object is destroyed.
1082 </para>
1083 <para>
1084 This function is labeled private.
1085 </para>
1086
1087 @object: the object whose signal handlers should be destroyed.
1088
1089 <!-- ##### ARG GtkTextTag:left_wrapped_line_margin ##### -->
1090 <para>
1091 Pixel width of the left margin of the text for lines after the first
1092 line in a wrapped paragraph.
1093 </para>
1094
1095
1096 <!-- ##### FUNCTION gtk_text_iter_in_region ##### -->
1097 <para>
1098
1099 </para>
1100
1101 @iter:
1102 @start:
1103 @end:
1104 @Returns:
1105
1106 <!-- ##### FUNCTION gtk_type_get_varargs_type ##### -->
1107 <para>
1108 Get the varargs type associated with @foreign_type
1109 </para>
1110
1111 @foreign_type: GtkType
1112 @Returns: GtkType
1113
1114 <!-- ##### SIGNAL GtkEditable::changed ##### -->
1115 <para>
1116 Indicates that the user has changed the contents
1117 of the widget.
1118 </para>
1119
1120 @editable: the object which received the signal.
1121
1122 <!-- ##### STRUCT GtkMenuFactory ##### -->
1123 <para>
1124
1125 </para>
1126
1127 @path:
1128 @type:
1129 @accel_group:
1130 @widget:
1131 @subfactories:
1132
1133 <!-- ##### SIGNAL GtkTextView::delete-at-cursor ##### -->
1134 <para>
1135
1136 </para>
1137
1138 @textview: the object which received the signal.
1139 @arg1:
1140 @arg2:
1141
1142 <!-- ##### MACRO GTK_VALUE_FOREIGN ##### -->
1143 <para>
1144 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
1145 </para>
1146
1147 @a:
1148
1149 <!-- ##### SIGNAL GtkTextView::paste-text ##### -->
1150 <para>
1151
1152 </para>
1153
1154 @textview: the object which received the signal.
1155
1156 <!-- ##### MACRO GTK_PRIVATE_SET_FLAG ##### -->
1157 <para>
1158
1159 </para>
1160
1161 @wid:
1162 @flag:
1163
1164 <!-- ##### FUNCTION gtk_ruler_draw_pos ##### -->
1165 <para>
1166
1167 </para>
1168
1169 @ruler: the gtkruler
1170
1171 <!-- ##### MACRO GTK_WIDGET_USER_STYLE ##### -->
1172 <para>
1173
1174 </para>
1175
1176 @obj:
1177
1178 <!-- ##### ENUM GtkDebugFlag ##### -->
1179 <para>
1180
1181 </para>
1182
1183 @GTK_DEBUG_OBJECTS:
1184 @GTK_DEBUG_MISC:
1185 @GTK_DEBUG_SIGNALS:
1186 @GTK_DEBUG_DND:
1187 @GTK_DEBUG_PLUGSOCKET:
1188
1189 <!-- ##### FUNCTION gtk_menu_factory_remove_paths ##### -->
1190 <para>
1191
1192 </para>
1193
1194 @factory:
1195 @paths:
1196 @npaths:
1197
1198 <!-- ##### FUNCTION gtk_type_query ##### -->
1199 <para>
1200 Given a type, return various interesting parameters of the type.
1201 </para>
1202
1203 @type: GtkType
1204 @Returns: GtkTypeQuery*
1205
1206 <!-- ##### SECTION ./tmpl/gtkprivate.sgml:Long_Description ##### -->
1207 <para>
1208
1209 </para>
1210
1211
1212 <!-- ##### MACRO GTK_TYPE_IDENTIFIER ##### -->
1213 <para>
1214 Hide the name of gtk_identifier_get_type
1215 </para>
1216
1217
1218 <!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER_INT_INT_INT ##### -->
1219 <para>
1220
1221 </para>
1222
1223 @object:
1224 @func:
1225 @func_data:
1226 @args:
1227
1228 <!-- ##### MACRO gtk_marshal_NONE__ENUM ##### -->
1229 <para>
1230
1231 </para>
1232
1233
1234 <!-- ##### FUNCTION gtk_signal_handler_pending_by_id ##### -->
1235 <para>
1236 Returns whether a connection id is valid (and optionally not blocked).
1237 </para>
1238
1239 @object: the object to search for the desired handler.
1240 @handler_id: the connection id.
1241 @may_be_blocked: whether it is acceptable to return a blocked
1242 handler.
1243 @Returns: TRUE if the signal exists and wasn't blocked,
1244 unless #may_be_blocked was specified.  FALSE otherwise.
1245
1246 <!-- ##### MACRO GTK_PRIVATE_FLAGS ##### -->
1247 <para>
1248
1249 </para>
1250
1251 @wid:
1252
1253 <!-- ##### FUNCTION gtk_marshal_BOOL__NONE ##### -->
1254 <para>
1255
1256 </para>
1257
1258 @object:
1259 @func:
1260 @func_data:
1261 @args:
1262
1263 <!-- ##### FUNCTION gtk_type_free ##### -->
1264 <para>
1265 Given the type of an object and a pointer to it, the object is freed.
1266 </para>
1267
1268 @type: GtkType
1269 @mem: gpointer to the object
1270
1271 <!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Short_Description ##### -->
1272
1273
1274
1275 <!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER_POINTER ##### -->
1276 <para>
1277
1278 </para>
1279
1280 @object:
1281 @func:
1282 @func_data:
1283 @args:
1284
1285 <!-- ##### STRUCT GtkMenuPath ##### -->
1286 <para>
1287
1288 </para>
1289
1290 @path:
1291 @widget:
1292
1293 <!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT ##### -->
1294 <para>
1295
1296 </para>
1297
1298
1299 <!-- ##### SECTION ./tmpl/gtkprivate.sgml:Title ##### -->
1300 Private Information
1301
1302
1303 <!-- ##### FUNCTION gtk_theme_engine_register_type ##### -->
1304 <para>
1305
1306 </para>
1307
1308 @engine:
1309 @parent_type:
1310 @type_name:
1311 @type_info:
1312 @Returns:
1313
1314 <!-- ##### FUNCTION gtk_menu_factory_find ##### -->
1315 <para>
1316
1317 </para>
1318
1319 @factory:
1320 @path:
1321 @Returns:
1322
1323 <!-- ##### STRUCT GtkMenuEntry ##### -->
1324 <para>
1325
1326 </para>
1327
1328 @path:
1329 @accelerator:
1330 @callback:
1331 @callback_data:
1332 @widget:
1333
1334 <!-- ##### SIGNAL GtkEditable::paste-clipboard ##### -->
1335 <para>
1336 An action signal. Causes the contents of the clipboard to
1337 be pasted into the editable widget at the current cursor
1338 position.
1339 </para>
1340
1341 @editable: the object which received the signal.
1342
1343 <!-- ##### FUNCTION gtk_window_add_embedded_xid ##### -->
1344 <para>
1345
1346 </para>
1347
1348 @window:
1349 @xid:
1350
1351 <!-- ##### FUNCTION gtk_marshal_NONE__BOOL ##### -->
1352 <para>
1353
1354 </para>
1355
1356 @object:
1357 @func:
1358 @func_data:
1359 @args:
1360
1361 <!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
1362 <para>
1363 Controls whether opacity can be set with the #GtkColorSelection.
1364 If this functionality is enabled, the necessary additional widgets
1365 are added to the #GtkColorSelection and the opacity value can be
1366 retrieved via the fourth value in the color array returned by
1367 the gtk_color_selection_get_color() function.
1368 </para>
1369
1370 @colorsel: a #GtkColorSelection.
1371 @use_opacity: a boolean indicating whether the opacity selection
1372 is enabled.
1373
1374 <!-- ##### FUNCTION gtk_marshal_INT__POINTER ##### -->
1375 <para>
1376
1377 </para>
1378
1379 @object:
1380 @func:
1381 @func_data:
1382 @args:
1383
1384 <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:See_Also ##### -->
1385 <para>
1386 <variablelist>
1387
1388 <varlistentry>
1389 <term>#GtkSignal</term>
1390 <listitem><para>The signal handling functions (of which marshallers are
1391 really an implementation detail).</para></listitem>
1392 </varlistentry>
1393
1394 </variablelist>
1395 </para>
1396
1397
1398 <!-- ##### SIGNAL GtkEditable::move-word ##### -->
1399 <para>
1400 An action signal. Move the cursor by words.
1401 </para>
1402
1403 @editable: the object which received the signal.
1404 @num_words: The number of words to move the
1405 cursor. (Can be negative).
1406
1407 <!-- ##### STRUCT GtkTreeViewPrivate ##### -->
1408 <para>
1409
1410 </para>
1411
1412 @model:
1413 @flags:
1414 @tree:
1415 @tab_offset:
1416 @button_pressed_node:
1417 @button_pressed_tree:
1418 @children:
1419 @width:
1420 @height:
1421 @hadjustment:
1422 @vadjustment:
1423 @bin_window:
1424 @header_window:
1425 @anchor:
1426 @cursor:
1427 @cursor_drag:
1428 @xor_gc:
1429 @drag_pos:
1430 @x_drag:
1431 @prelight_node:
1432 @prelight_tree:
1433 @prelight_offset:
1434 @selection:
1435 @columns:
1436 @column:
1437 @header_height:
1438
1439 <!-- ##### MACRO GTK_WIDGET_RESIZE_NEEDED ##### -->
1440 <para>
1441
1442 </para>
1443
1444 @obj:
1445
1446 <!-- ##### MACRO GTK_NOTE ##### -->
1447 <para>
1448
1449 </para>
1450
1451 @type:
1452 @action:
1453
1454 <!-- ##### ENUM GtkTextViewDeleteType ##### -->
1455 <para>
1456
1457 </para>
1458
1459 @GTK_TEXT_DELETE_CHAR:
1460 @GTK_TEXT_DELETE_HALF_WORD:
1461 @GTK_TEXT_DELETE_WHOLE_WORD:
1462 @GTK_TEXT_DELETE_HALF_WRAPPED_LINE:
1463 @GTK_TEXT_DELETE_WHOLE_WRAPPED_LINE:
1464 @GTK_TEXT_DELETE_HALF_LINE:
1465 @GTK_TEXT_DELETE_WHOLE_LINE:
1466 @GTK_TEXT_DELETE_WHITESPACE:
1467 @GTK_TEXT_DELETE_WHITESPACE_LEAVE_ONE:
1468
1469 <!-- ##### STRUCT GtkIMContextSimple ##### -->
1470 <para>
1471
1472 </para>
1473
1474 @object:
1475 @tables:
1476 @compose_buffer:
1477 @tentative_match:
1478 @tentative_match_len:
1479
1480 <!-- ##### MACRO GTK_TYPE_FLAT_FIRST ##### -->
1481 <para>
1482 The first "flat" (no struct) enumerated type value.
1483 </para>
1484
1485
1486 <!-- ##### FUNCTION gtk_menu_factory_new ##### -->
1487 <para>
1488
1489 </para>
1490
1491 @type:
1492 @Returns:
1493
1494 <!-- ##### MACRO gtk_marshal_NONE__UINT_POINTER_UINT_UINT_ENUM ##### -->
1495 <para>
1496
1497 </para>
1498
1499
1500 <!-- ##### FUNCTION gtk_text_buffer_spew ##### -->
1501 <para>
1502
1503 </para>
1504
1505 @buffer:
1506
1507 <!-- ##### STRUCT GtkTextTabArray ##### -->
1508 <para>
1509
1510 </para>
1511
1512
1513 <!-- ##### ARG GtkTextTag:overstrike ##### -->
1514 <para>
1515
1516 </para>
1517
1518
1519 <!-- ##### MACRO GTK_TREE_SELECTION ##### -->
1520 <para>
1521 A macro that returns a GList that contains the selection of the root tree of @obj.
1522 </para>
1523
1524 @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.
1525
1526 <!-- ##### FUNCTION gtk_editable_changed ##### -->
1527 <para>
1528 Causes the "changed" signal to be emitted.
1529 </para>
1530
1531 @editable: a #GtkEditable widget.
1532
1533 <!-- ##### SIGNAL GtkTextView::move ##### -->
1534 <para>
1535
1536 </para>
1537
1538 @textview: the object which received the signal.
1539 @arg1:
1540 @arg2:
1541 @arg3:
1542
1543 <!-- ##### MACRO GTK_WIDGET_HAS_SHAPE_MASK ##### -->
1544 <para>
1545
1546 </para>
1547
1548 @obj:
1549
1550 <!-- ##### FUNCTION gtk_text_buffer_copy ##### -->
1551 <para>
1552
1553 </para>
1554
1555 @buffer:
1556 @time:
1557
1558 <!-- ##### FUNCTION gtk_text_mark_ref ##### -->
1559 <para>
1560
1561 </para>
1562
1563 @mark:
1564 @Returns:
1565
1566 <!-- ##### ARG GtkTextTag:offset ##### -->
1567 <para>
1568 Pixels to offset the text horizontally or vertically, useful to
1569 produce superscript and subscript.
1570 </para>
1571
1572
1573 <!-- ##### SIGNAL GtkEditable::insert-text ##### -->
1574 <para>
1575 This signal is emitted when text is inserted into
1576 the widget by the user. The default handler for
1577 this signal will normally be responsible for inserting
1578 the text, so by connecting to this signal and then
1579 stopping the signal with gtk_signal_emit_stop(), it
1580 is possible to modify the inserted text, or prevent
1581 it from being inserted entirely.
1582 </para>
1583
1584 @editable: the object which received the signal.
1585 @new_text: the new text to insert.
1586 @new_text_length: the length of the new text.
1587 @position: the position at which to insert the new text.
1588            this is an in-out paramter. After the signal
1589            emission is finished, it should point after
1590            the newly inserted text.
1591
1592 <!-- ##### FUNCTION gtk_editable_claim_selection ##### -->
1593 <para>
1594 Claim or disclaim ownership of the PRIMARY X selection.
1595 </para>
1596
1597 @editable: a #GtkEditable widget.
1598 @claim: if %TRUE, claim the selection, otherwise, disclaim it.
1599 @time: the timestamp for claiming the selection.
1600
1601 <!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT ##### -->
1602 <para>
1603
1604 </para>
1605
1606 @object:
1607 @func:
1608 @func_data:
1609 @args:
1610
1611 <!-- ##### MACRO GTK_OBJECT_SIGNALS ##### -->
1612 <para>
1613 Get the array of signals defined for this object.
1614 </para>
1615
1616 @obj: the object to fetch the signals from.
1617
1618 <!-- ##### SIGNAL GtkEditable::move-to-column ##### -->
1619 <para>
1620 An action signal. Move the cursor to the given column.
1621 </para>
1622
1623 @editable: the object which received the signal.
1624 @column: the column to move to. (A negative value indicates
1625          the last column)
1626
1627 <!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Title ##### -->
1628 gtkenums.sgml
1629
1630
1631 <!-- ##### FUNCTION gtk_marshal_NONE__INT_INT_POINTER ##### -->
1632 <para>
1633
1634 </para>
1635
1636 @object:
1637 @func:
1638 @func_data:
1639 @args:
1640
1641 <!-- ##### USER_FUNCTION GtkMenuCallback ##### -->
1642 <para>
1643
1644 </para>
1645
1646 @widget:
1647 @user_data:
1648
1649 <!-- ##### FUNCTION gtk_type_check_object_cast ##### -->
1650 <para>
1651 Given a pointer to a GtkTypeObject @type_object, and a GtkType @cast_type,
1652 make sure that it's okay to cast @type_object into a @cast_type.
1653 </para>
1654
1655 @type_object: GtkTypeObject*
1656 @cast_type: GtkType
1657 @Returns: the same GtkTypeObject* as @type_object
1658
1659 <!-- ##### FUNCTION gtk_themes_exit ##### -->
1660 <para>
1661
1662 </para>
1663
1664 @error_code:
1665
1666 <!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_POINTER_POINTER_POINTER ##### -->
1667 <para>
1668
1669 </para>
1670
1671 @object:
1672 @func:
1673 @func_data:
1674 @args:
1675
1676 <!-- ##### ARG GtkEditable:text_position ##### -->
1677 <para>
1678 The position of the cursor.
1679 </para>
1680
1681
1682 <!-- ##### MACRO gtk_marshal_NONE__OBJECT ##### -->
1683 <para>
1684
1685 </para>
1686
1687
1688 <!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Long_Description ##### -->
1689 <para>
1690
1691 </para>
1692
1693
1694 <!-- ##### FUNCTION gtk_type_set_varargs_type ##### -->
1695 <para>
1696 Set the varargs type for a fundamental type @foreign_type.
1697 </para>
1698
1699 @foreign_type: Must be a GtkType with a sequence number of zero.  Must not be a
1700 fundamental type.
1701 @varargs_type: Must be a GtkType which is either structured or flag, or NONE.
1702
1703 <!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
1704 <para>
1705 Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make
1706 sure that it's okay to cast something of that @klass into a @cast_type.
1707 </para>
1708
1709 @klass: GtkTypeClass*
1710 @cast_type: GtkType
1711 @Returns: Always return @klass.
1712
1713 <!-- ##### FUNCTION gtk_menu_factory_destroy ##### -->
1714 <para>
1715
1716 </para>
1717
1718 @factory:
1719
1720 <!-- ##### FUNCTION gtk_signal_n_emissions ##### -->
1721 <para>
1722 Find out the recursion depth of emissions for a particular type
1723 of signal and object.  (So it will
1724 always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified)
1725 This is a way to avoid recursion:  you can see if
1726 you are currently running in that signal handler and emit it only
1727 if you are.
1728 </para>
1729 <para>Another way to look at it is that this number increases
1730 by one when #gtk_signal_emit(), et al, are called,
1731 and decreases by one when #gtk_signal_emit() returns.
1732 </para>
1733
1734 @object: the object with the signal handler.
1735 @signal_id: the signal id.
1736 @Returns: the recursion depth of emissions of this signal for this
1737 object.
1738
1739 <!-- ##### FUNCTION gtk_text_buffer_insert_pixmap ##### -->
1740 <para>
1741
1742 </para>
1743
1744 @buffer:
1745 @iter:
1746 @pixmap:
1747 @mask:
1748
1749 <!-- ##### FUNCTION gtk_marshal_NONE__C_CALLBACK_C_CALLBACK ##### -->
1750 <para>
1751
1752 </para>
1753
1754 @object:
1755 @func:
1756 @func_data:
1757 @args:
1758
1759 <!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_INT_POINTER_INT_INT ##### -->
1760 <para>
1761
1762 </para>
1763
1764 @object:
1765 @func:
1766 @func_data:
1767 @args:
1768
1769 <!-- ##### MACRO GTK_VALUE_ARGS ##### -->
1770 <para>
1771 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS
1772 </para>
1773
1774 @a:
1775
1776 <!-- ##### FUNCTION gtk_menu_factory_add_entries ##### -->
1777 <para>
1778
1779 </para>
1780
1781 @factory:
1782 @entries:
1783 @nentries:
1784
1785 <!-- ##### SIGNAL GtkEditable::move-to-row ##### -->
1786 <para>
1787 An action signal. Move the cursor to the given row.
1788 </para>
1789
1790 @editable: the object which received the signal.
1791 @row: the row to move to. (A negative value indicates
1792       the last row)
1793
1794 <!-- ##### FUNCTION gtk_signal_set_funcs ##### -->
1795 <para>
1796 These set default functions to call when the user didn't
1797 supply a function when connecting.  (These are rarely
1798 used, and probably only for language bindings)
1799 </para>
1800 <para>
1801 By default, there are no such functions.
1802 </para>
1803
1804 @marshal_func: the function to invoke on every handlers for which there
1805 isn't a function pointer.  May be NULL.
1806 @destroy_func: the function to invoke when each hook is destroyed.
1807 May be NULL.
1808
1809 <!-- ##### FUNCTION gtk_im_context_simple_new ##### -->
1810 <para>
1811
1812 </para>
1813
1814 @Returns:
1815
1816 <!-- ##### FUNCTION gtk_type_describe_heritage ##### -->
1817 <para>
1818 Print the types @type inherits from.
1819 </para>
1820
1821 @type: GtkType
1822
1823 <!-- ##### FUNCTION gtk_text_buffer_set_clipboard_contents ##### -->
1824 <para>
1825
1826 </para>
1827
1828 @buffer:
1829 @text:
1830
1831 <!-- ##### ENUM GtkFontFilterType ##### -->
1832 <para>
1833 A set of bit flags used to specify the filter being set
1834 when calling gtk_font_selection_dialog_set_filter() or
1835 gtk_font_selection_set_filter().
1836 </para>
1837
1838 @GTK_FONT_FILTER_BASE: the base filter, which can't be changed by the user.
1839 @GTK_FONT_FILTER_USER: the user filter, which can be changed from within the
1840 'Filter' page of the #GtkFontSelection widget.
1841
1842 <!-- ##### SIGNAL GtkEditable::move-cursor ##### -->
1843 <para>
1844 An action signal. Move the cursor position.
1845 </para>
1846
1847 @editable: the object which received the signal.
1848 @x: horizontal distance to move the cursor.
1849 @y: vertical distance to move the cursor.
1850
1851 <!-- ##### FUNCTION gtk_type_parent_class ##### -->
1852 <para>
1853 Return the class of the parent.  Initialize the class if necessary.
1854 Return NULL if anything goes wrong.
1855 </para>
1856
1857 @type: GtkType
1858 @Returns: gpointer to the klass.
1859
1860 <!-- ##### USER_FUNCTION GtkSignalDestroy ##### -->
1861 <para>
1862 A function which you can use to clean up when the
1863 signal handler is destroyed.
1864 </para>
1865 <para>
1866 For example, if your handler requires a few variables
1867 that you made into a struct and allocated (using g_new()
1868 or something), then you will probably want to free
1869 it as soon as the hook is destroyed.  This will
1870 allow you to do that. (For this in particular
1871 it is convenient to pass g_free() as a #GtkSignalDestroy
1872 function).
1873 </para>
1874
1875 @data: The user data associated with the hook that is being
1876 destroyed.
1877
1878 <!-- ##### FUNCTION gtk_window_set_default ##### -->
1879 <para>
1880
1881 </para>
1882
1883 @window:
1884 @defaultw:
1885
1886 <!-- ##### FUNCTION gtk_marshal_NONE__INT ##### -->
1887 <para>
1888
1889 </para>
1890
1891 @object:
1892 @func:
1893 @func_data:
1894 @args:
1895
1896 <!-- ##### MACRO GTK_WIDGET_LEAVE_PENDING ##### -->
1897 <para>
1898
1899 </para>
1900
1901 @obj:
1902
1903 <!-- ##### MACRO gtk_marshal_NONE__UINT ##### -->
1904 <para>
1905
1906 </para>
1907
1908
1909 <!-- ##### MACRO GTK_WIDGET_IN_REPARENT ##### -->
1910 <para>
1911
1912 </para>
1913
1914 @obj:
1915
1916 <!-- ##### FUNCTION gtk_accel_group_marshal_add ##### -->
1917 <para>
1918
1919 </para>
1920
1921 @object:
1922 @func:
1923 @func_data:
1924 @args:
1925
1926 <!-- ##### FUNCTION gtk_marshal_INT__POINTER_CHAR_CHAR ##### -->
1927 <para>
1928
1929 </para>
1930
1931 @object:
1932 @func:
1933 @func_data:
1934 @args:
1935
1936 <!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_INT ##### -->
1937 <para>
1938
1939 </para>
1940
1941 @object:
1942 @func:
1943 @func_data:
1944 @args:
1945
1946 <!-- ##### FUNCTION gtk_accel_group_marshal_remove ##### -->
1947 <para>
1948
1949 </para>
1950
1951 @object:
1952 @func:
1953 @func_data:
1954 @args:
1955
1956 <!-- ##### MACRO gtk_marshal_NONE__STRING_INT_POINTER ##### -->
1957 <para>
1958
1959 </para>
1960
1961
1962 <!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER ##### -->
1963 <para>
1964
1965 </para>
1966
1967 @object:
1968 @func:
1969 @func_data:
1970 @args:
1971
1972 <!-- ##### FUNCTION gtk_rc_init ##### -->
1973 <para>
1974 Internal function.
1975 </para>
1976
1977
1978 <!-- ##### FUNCTION gtk_signal_query ##### -->
1979 <para>
1980 Obtain information about a signal.
1981 </para>
1982
1983 @signal_id: the signal type identifier.
1984 @Returns: a pointer to a GtkSignalQuery structure
1985 which contains all the information, or NULL.
1986 The pointer is allocated just for you:  you must g_free() it.
1987
1988 <!-- ##### FUNCTION gtk_signal_n_emissions_by_name ##### -->
1989 <para>
1990 Find out the recursion depth of emissions for a particular type
1991 of signal and object.  Just like gtk_signal_n_emissions()
1992 except it will lookup the signal id for you.
1993 </para>
1994
1995 @object: the object with the signal handler.
1996 @name: the signal name.
1997 @Returns: the recursion depth of emissions of this signal for this
1998 object.
1999
2000 <!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:See_Also ##### -->
2001 <para>
2002
2003 </para>
2004
2005
2006 <!-- ##### SIGNAL GtkTextView::delete ##### -->
2007 <para>
2008
2009 </para>
2010
2011 @textview: the object which received the signal.
2012 @arg1:
2013 @arg2:
2014
2015 <!-- ##### FUNCTION gtk_container_register_toplevel ##### -->
2016 <para>
2017
2018 </para>
2019
2020 @container:
2021
2022 <!-- ##### MACRO gtk_widget_push_visual ##### -->
2023 <para>
2024
2025 </para>
2026
2027 @v:
2028 @visual:
2029
2030 <!-- ##### MACRO gtk_marshal_ENUM__ENUM ##### -->
2031 <para>
2032
2033 </para>
2034
2035
2036 <!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Title ##### -->
2037 GtkIMContextSimple
2038
2039
2040 <!-- ##### MACRO gtk_marshal_NONE__POINTER_INT_INT_POINTER_UINT_UINT ##### -->
2041 <para>
2042
2043 </para>
2044
2045
2046 <!-- ##### ARG GtkTextTag:left_wrapped_line_margin_set ##### -->
2047 <para>
2048
2049 </para>
2050
2051
2052 <!-- ##### MACRO GTK_VALUE_C_CALLBACK ##### -->
2053 <para>
2054 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK
2055 </para>
2056
2057 @a:
2058
2059 <!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_POINTER_INT_INT ##### -->
2060 <para>
2061
2062 </para>
2063
2064 @object:
2065 @func:
2066 @func_data:
2067 @args:
2068
2069 <!-- ##### SIGNAL GtkTextView::move-insert ##### -->
2070 <para>
2071
2072 </para>
2073
2074 @textview: the object which received the signal.
2075 @arg1:
2076 @arg2:
2077 @arg3:
2078
2079 <!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Long_Description ##### -->
2080 <para>
2081
2082 </para>
2083
2084
2085 <!-- ##### FUNCTION gtk_text_buffer_find_regexp ##### -->
2086 <para>
2087
2088 </para>
2089
2090 @buffer:
2091 @regexp:
2092 @start:
2093 @end:
2094 @Returns:
2095
2096 <!-- ##### FUNCTION gtk_menu_factory_add_subfactory ##### -->
2097 <para>
2098
2099 </para>
2100
2101 @factory:
2102 @subfactory:
2103 @path:
2104
2105 <!-- ##### ENUM GtkTextViewScrollType ##### -->
2106 <para>
2107
2108 </para>
2109
2110 @GTK_TEXT_SCROLL_TO_TOP:
2111 @GTK_TEXT_SCROLL_TO_BOTTOM:
2112 @GTK_TEXT_SCROLL_PAGE_DOWN:
2113 @GTK_TEXT_SCROLL_PAGE_UP:
2114
2115 <!-- ##### STRUCT GtkTextBTree ##### -->
2116 <para>
2117
2118 </para>
2119
2120