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

   1 <!-- ##### SECTION Title ##### -->
   2 Types
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 Handle run-time type creation.
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 Gtk's type system is extensible.  Because of that, types have to be
  10 managed at runtime.
  11 </para>
  12
  13 <!-- ##### SECTION See_Also ##### -->
  14 <para>
  15
  16 </para>
  17
  18 <!-- ##### TYPEDEF GtkType ##### -->
  19 <para>
  20 @GtkType is unique integer identifying the type.  The guts of the
  21 information about the type is held in a private struct named
  22 GtkTypeNode.
  23 </para>
  24
  25
  26 <!-- ##### ENUM GtkFundamentalType ##### -->
  27 <para>
  28 @GtkFundamentalType is an enumerated type which lists all the possible
  29 fundamental types (e.g. char, uchar, int, long, float, etc).
  30 </para>
  31
  32 @GTK_TYPE_INVALID:
  33 @GTK_TYPE_NONE:
  34 @GTK_TYPE_CHAR:
  35 @GTK_TYPE_UCHAR:
  36 @GTK_TYPE_BOOL:
  37 @GTK_TYPE_INT:
  38 @GTK_TYPE_UINT:
  39 @GTK_TYPE_LONG:
  40 @GTK_TYPE_ULONG:
  41 @GTK_TYPE_FLOAT:
  42 @GTK_TYPE_DOUBLE:
  43 @GTK_TYPE_STRING:
  44 @GTK_TYPE_ENUM:
  45 @GTK_TYPE_FLAGS:
  46 @GTK_TYPE_BOXED:
  47 @GTK_TYPE_POINTER:
  48 @GTK_TYPE_SIGNAL:
  49 @GTK_TYPE_ARGS:
  50 @GTK_TYPE_CALLBACK:
  51 @GTK_TYPE_C_CALLBACK:
  52 @GTK_TYPE_FOREIGN:
  53 @GTK_TYPE_OBJECT:
  54
  55 <!-- ##### MACRO GTK_TYPE_NUM_BUILTINS ##### -->
  56 <para>
  57 No idea.
  58 </para>
  59
  60
  61
  62 <!-- ##### MACRO GTK_TYPE_FLAT_FIRST ##### -->
  63 <para>
  64 The first "flat" (no struct) enumerated type value.
  65 </para>
  66
  67
  68
  69 <!-- ##### MACRO GTK_TYPE_FLAT_LAST ##### -->
  70 <para>
  71 The last "flat" (no struct) enumerated type value.
  72 </para>
  73
  74
  75
  76 <!-- ##### MACRO GTK_TYPE_STRUCTURED_FIRST ##### -->
  77 <para>
  78 The first structured enumerated type value.
  79 </para>
  80
  81
  82
  83 <!-- ##### MACRO GTK_TYPE_STRUCTURED_LAST ##### -->
  84 <para>
  85 The last structured enumerated type value.
  86 </para>
  87
  88
  89
  90 <!-- ##### MACRO GTK_TYPE_FUNDAMENTAL_LAST ##### -->
  91 <para>
  92 The highest-numbered structured or flat enumerated type value.
  93 </para>
  94
  95
  96
  97 <!-- ##### MACRO GTK_TYPE_FUNDAMENTAL_MAX ##### -->
  98 <para>
  99 The highest maximum fundamental enumerated type value.
 100 </para>
 101
 102
 103
 104 <!-- ##### MACRO GTK_STRUCT_OFFSET ##### -->
 105 <para>
 106 Use in place of offsetof(), which is used if it exists.
 107 </para>
 108
 109 @struct: The type of the structure.
 110 @field: The field within the structure.
 111
 112
 113 <!-- ##### MACRO GTK_CHECK_CAST ##### -->
 114 <para>
 115 Cast the object in @tobj into @cast.  If GTK_NO_CHECK_CASTS is
 116 defined, just cast it.  Otherwise, check to see if we can cast @tobj
 117 into a @cast.
 118 </para>
 119
 120 @tobj: a pointer to a GtkObject.
 121 @cast_type: a Gtk type.
 122 @cast: a C type
 123
 124
 125 <!-- ##### MACRO GTK_CHECK_CLASS_CAST ##### -->
 126 <para>
 127 Cast the object in @tobj into @cast.  If GTK_NO_CHECK_CASTS is
 128 defined, just cast it.  Otherwise, check to see if we can cast @tobj
 129 into a @cast.
 130 </para>
 131
 132 @tclass: a pointer to a GtkClassInitFunc
 133 @cast_type: a Gtk type.
 134 @cast: a C type
 135
 136
 137 <!-- ##### MACRO GTK_CHECK_TYPE ##### -->
 138 <para>
 139 Determines whether @type_object is a type of @otype.
 140 </para>
 141
 142 @type_object: A GtkTypeObject object.
 143 @otype:
 144
 145
 146 <!-- ##### MACRO GTK_CHECK_CLASS_TYPE ##### -->
 147 <para>
 148 Determines whether @type_class is a type of @otype.
 149 </para>
 150
 151 @type_class: A GtkTypeClass class.
 152 @otype:
 153
 154
 155 <!-- ##### MACRO GTK_TYPE_IDENTIFIER ##### -->
 156 <para>
 157 Hide the name of gtk_identifier_get_type
 158 </para>
 159
 160
 161
 162 <!-- ##### FUNCTION gtk_identifier_get_type ##### -->
 163 <para>
 164 Get the type of GtkIdentifier.
 165 </para>
 166
 167 @Returns: GtkType -- the enumerated type of something.
 168
 169
 170 <!-- ##### MACRO GTK_TYPE_MAKE ##### -->
 171 <para>
 172 Combine a fundemantal type and a sequence number to create a gtk type.
 173 </para>
 174
 175 @parent_t:
 176 @seqno:
 177
 178
 179 <!-- ##### MACRO GTK_FUNDAMENTAL_TYPE ##### -->
 180 <para>
 181 Convert a gtk type into a fundamental type
 182 </para>
 183
 184 @type:
 185
 186
 187 <!-- ##### MACRO GTK_TYPE_SEQNO ##### -->
 188 <para>
 189 Convert a gtk type into its sequence number
 190 </para>
 191
 192 @type:
 193
 194
 195 <!-- ##### MACRO GTK_SIGNAL_FUNC ##### -->
 196 <para>
 197 Just a macroized cast into a GtkSignalFunc
 198 </para>
 199
 200 @f:
 201
 202
 203 <!-- ##### USER_FUNCTION GtkClassInitFunc ##### -->
 204 <para>
 205 Define a function pointer.
 206 </para>
 207
 208 @klass: a gpointer
 209
 210
 211 <!-- ##### USER_FUNCTION GtkObjectInitFunc ##### -->
 212 <para>
 213 Define a function pointer.
 214 </para>
 215
 216 @object: a gpointer
 217 @klass: a gpointer
 218
 219
 220 <!-- ##### USER_FUNCTION GtkSignalFunc ##### -->
 221 <para>
 222 Define a function pointer.
 223 </para>
 224
 225
 226
 227 <!-- ##### USER_FUNCTION GtkFunction ##### -->
 228 <para>
 229 Define a function pointer.
 230 </para>
 231
 232 @data: gpointer
 233 @Returns: gint
 234
 235
 236 <!-- ##### USER_FUNCTION GtkDestroyNotify ##### -->
 237 <para>
 238 Define a function pointer.
 239 </para>
 240
 241 @data: gpointer
 242
 243
 244 <!-- ##### USER_FUNCTION GtkCallbackMarshal ##### -->
 245 <para>
 246 Define a function pointer.
 247 </para>
 248
 249 @object: GtkObject*
 250 @data: gpointer
 251 @n_args: guint
 252 @args: GtkArg*
 253
 254
 255 <!-- ##### USER_FUNCTION GtkSignalMarshaller ##### -->
 256 <para>
 257 Define a function pointer.
 258 </para>
 259
 260 @object: GtkObject*
 261 @func: GtkSignalFunc
 262 @func_data: gpointer
 263 @args: GtkArg*
 264
 265
 266 <!-- ##### USER_FUNCTION GtkArgGetFunc ##### -->
 267 <para>
 268 Define a function pointer.  Deprecated.
 269 </para>
 270
 271 @object:
 272 @arg:
 273 @arg_id:
 274
 275
 276 <!-- ##### USER_FUNCTION GtkArgSetFunc ##### -->
 277 <para>
 278 Define a function pointer.  Deprecated.
 279 </para>
 280
 281 @object:
 282 @arg:
 283 @arg_id:
 284
 285
 286 <!-- ##### STRUCT GtkTypeObject ##### -->
 287 <para>
 288 A GtkTypeObject defines the minimum structure requirements
 289 for type instances. Type instances returned from gtk_type_new ()
 290 and initialized through a GtkObjectInitFunc need to directly inherit
 291 from this structure or at least copy its fields one by one.
 292 </para>
 293
 294 @klass:
 295
 296 <!-- ##### STRUCT GtkArg ##### -->
 297 <para>
 298 This is a structure that we use to pass in typed values (and names).
 299 </para>
 300
 301 @type:
 302 @name:
 303
 304 <!-- ##### MACRO GTK_VALUE_CHAR ##### -->
 305 <para>
 306 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CHAR
 307 </para>
 308
 309 @a:
 310
 311
 312 <!-- ##### MACRO GTK_VALUE_UCHAR ##### -->
 313 <para>
 314 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_UCHAR
 315 </para>
 316
 317 @a:
 318
 319
 320 <!-- ##### MACRO GTK_VALUE_BOOL ##### -->
 321 <para>
 322 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_BOOL
 323 </para>
 324
 325 @a:
 326
 327
 328 <!-- ##### MACRO GTK_VALUE_INT ##### -->
 329 <para>
 330 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_INT
 331 </para>
 332
 333 @a:
 334
 335
 336 <!-- ##### MACRO GTK_VALUE_UINT ##### -->
 337 <para>
 338 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_UINT
 339 </para>
 340
 341 @a:
 342
 343
 344 <!-- ##### MACRO GTK_VALUE_LONG ##### -->
 345 <para>
 346 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_LONG
 347 </para>
 348
 349 @a:
 350
 351
 352 <!-- ##### MACRO GTK_VALUE_ULONG ##### -->
 353 <para>
 354 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ULONG
 355 </para>
 356
 357 @a:
 358
 359
 360 <!-- ##### MACRO GTK_VALUE_FLOAT ##### -->
 361 <para>
 362 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_FLOAT
 363 </para>
 364
 365 @a:
 366
 367
 368 <!-- ##### MACRO GTK_VALUE_DOUBLE ##### -->
 369 <para>
 370 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_DOUBLE
 371 </para>
 372
 373 @a:
 374
 375
 376 <!-- ##### MACRO GTK_VALUE_STRING ##### -->
 377 <para>
 378 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_STRING
 379 </para>
 380
 381 @a:
 382
 383
 384 <!-- ##### MACRO GTK_VALUE_ENUM ##### -->
 385 <para>
 386 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ENUM
 387 </para>
 388
 389 @a:
 390
 391
 392 <!-- ##### MACRO GTK_VALUE_FLAGS ##### -->
 393 <para>
 394 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_FLAGS
 395 </para>
 396
 397 @a:
 398
 399
 400 <!-- ##### MACRO GTK_VALUE_BOXED ##### -->
 401 <para>
 402 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_BOXED
 403 </para>
 404
 405 @a:
 406
 407
 408 <!-- ##### MACRO GTK_VALUE_POINTER ##### -->
 409 <para>
 410 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_POINTER
 411 </para>
 412
 413 @a:
 414
 415
 416 <!-- ##### MACRO GTK_VALUE_OBJECT ##### -->
 417 <para>
 418 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_OBJECT
 419 </para>
 420
 421 @a:
 422
 423
 424 <!-- ##### MACRO GTK_VALUE_SIGNAL ##### -->
 425 <para>
 426 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_SIGNAL
 427 </para>
 428
 429 @a:
 430
 431
 432 <!-- ##### MACRO GTK_VALUE_ARGS ##### -->
 433 <para>
 434 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_ARGS
 435 </para>
 436
 437 @a:
 438
 439
 440 <!-- ##### MACRO GTK_VALUE_CALLBACK ##### -->
 441 <para>
 442 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_CALLBACK
 443 </para>
 444
 445 @a:
 446
 447
 448 <!-- ##### MACRO GTK_VALUE_C_CALLBACK ##### -->
 449 <para>
 450 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_CALLBACK
 451 </para>
 452
 453 @a:
 454
 455
 456 <!-- ##### MACRO GTK_VALUE_FOREIGN ##### -->
 457 <para>
 458 Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
 459 </para>
 460
 461 @a:
 462
 463
 464 <!-- ##### MACRO GTK_RETLOC_CHAR ##### -->
 465 <para>
 466 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_CHAR
 467 </para>
 468
 469 @a:
 470
 471
 472 <!-- ##### MACRO GTK_RETLOC_UCHAR ##### -->
 473 <para>
 474 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_UCHAR
 475 </para>
 476
 477 @a:
 478
 479
 480 <!-- ##### MACRO GTK_RETLOC_BOOL ##### -->
 481 <para>
 482 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_BOOL
 483 </para>
 484
 485 @a:
 486
 487
 488 <!-- ##### MACRO GTK_RETLOC_INT ##### -->
 489 <para>
 490 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_INT
 491 </para>
 492
 493 @a:
 494
 495
 496 <!-- ##### MACRO GTK_RETLOC_UINT ##### -->
 497 <para>
 498 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_UINT
 499 </para>
 500
 501 @a:
 502
 503
 504 <!-- ##### MACRO GTK_RETLOC_LONG ##### -->
 505 <para>
 506 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_LONG
 507 </para>
 508
 509 @a:
 510
 511
 512 <!-- ##### MACRO GTK_RETLOC_ULONG ##### -->
 513 <para>
 514 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_ULONG
 515 </para>
 516
 517 @a:
 518
 519
 520 <!-- ##### MACRO GTK_RETLOC_FLOAT ##### -->
 521 <para>
 522 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_FLOAT
 523 </para>
 524
 525 @a:
 526
 527
 528 <!-- ##### MACRO GTK_RETLOC_DOUBLE ##### -->
 529 <para>
 530 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_DOUBLE
 531 </para>
 532
 533 @a:
 534
 535
 536 <!-- ##### MACRO GTK_RETLOC_STRING ##### -->
 537 <para>
 538 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_STRING
 539 </para>
 540
 541 @a:
 542
 543
 544 <!-- ##### MACRO GTK_RETLOC_ENUM ##### -->
 545 <para>
 546 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_ENUM
 547 </para>
 548
 549 @a:
 550
 551
 552 <!-- ##### MACRO GTK_RETLOC_FLAGS ##### -->
 553 <para>
 554 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_FLAGS
 555 </para>
 556
 557 @a:
 558
 559
 560 <!-- ##### MACRO GTK_RETLOC_BOXED ##### -->
 561 <para>
 562 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_BOXED
 563 </para>
 564
 565 @a:
 566
 567
 568 <!-- ##### MACRO GTK_RETLOC_POINTER ##### -->
 569 <para>
 570 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_POINTER
 571 </para>
 572
 573 @a:
 574
 575
 576 <!-- ##### MACRO GTK_RETLOC_OBJECT ##### -->
 577 <para>
 578 If the GtkArg contains a pointer to the value, this macro will be a pointer to a GTK_TYPE_OBJECT
 579 </para>
 580
 581 @a:
 582
 583
 584 <!-- ##### STRUCT GtkTypeInfo ##### -->
 585 <para>
 586 Holds information about the type.  @gtk_type_name returns the name.
 587 @object_size is somehow set to the number of bytes that an instance of
 588 the object will occupy.  @class_init_func holds the type's
 589 initialization function.  @object_init_func holds the initialization
 590 function for an instance of the object.  @reserved_1 is used for
 591 GtkEnumValue to hold the enumerated values.
 592 </para>
 593
 594 @type_name:
 595 @object_size:
 596 @class_size:
 597 @class_init_func:
 598 @object_init_func:
 599 @reserved_1:
 600 @reserved_2:
 601 @base_class_init_func:
 602
 603 <!-- ##### STRUCT GtkTypeQuery ##### -->
 604 <para>
 605 A structure used to return values from @gtk_type_query.
 606 </para>
 607
 608 @type:
 609 @type_name:
 610 @object_size:
 611 @class_size:
 612
 613 <!-- ##### STRUCT GtkTypeClass ##### -->
 614 <para>
 615 The base structure for a Gtk Type.  Every type inherits this as a base structure.
 616 </para>
 617
 618
 619 <!-- ##### STRUCT GtkEnumValue ##### -->
 620 <para>
 621 A structure which contains a single enum value, and its name, and it's
 622 nickname.
 623 </para>
 624
 625 @value:
 626 @value_name:
 627 @value_nick:
 628
 629 <!-- ##### FUNCTION gtk_type_init ##### -->
 630 <para>
 631 Initialize the data structures associated with gtk types.
 632 </para>
 633
 634
 635
 636 <!-- ##### FUNCTION gtk_type_unique ##### -->
 637 <para>
 638 Create a new, unique type.
 639 </para>
 640
 641 @parent_type: if zero, a fundamental type is created.
 642 @type_info: must not be null, and @type_info->type_name must also not be null.
 643 @Returns: the new GtkType.
 644
 645
 646 <!-- ##### FUNCTION gtk_type_set_chunk_alloc ##### -->
 647 <para>
 648 Set the mem_chunk size so it will hold @n_chunks of the objects of that @type.
 649 </para>
 650
 651 @type: There must be an unlocked TypeNode associated with this type otherwise nothing happens.
 652 @n_chunks:
 653
 654
 655 <!-- ##### FUNCTION gtk_type_name ##### -->
 656 <para>
 657 </para>
 658
 659 @type: a GtkType
 660 @Returns: a pointer to the name of a type, or NULL if it has none.
 661
 662
 663 <!-- ##### FUNCTION gtk_type_from_name ##### -->
 664 <para>
 665 Get the internal representation of a type given its name.
 666 </para>
 667
 668 @name: the name of a gtk type
 669 @Returns: a GtkType
 670
 671
 672 <!-- ##### FUNCTION gtk_type_parent ##### -->
 673 <para>
 674
 675 </para>
 676
 677 @type: a GtkType
 678 @Returns: the GtkType of the parent
 679
 680
 681 <!-- ##### FUNCTION gtk_type_class ##### -->
 682 <para>
 683 Return a gpointer pointing to the class of @type or NULL if there was
 684 any trouble identifying @type.  Initialize the class if necessary.
 685 </para>
 686
 687 @type: a GtkType
 688 @Returns: gpointer to the klass.
 689
 690
 691 <!-- ##### FUNCTION gtk_type_parent_class ##### -->
 692 <para>
 693 Return the class of the parent.  Initialize the class if necessary.
 694 Return NULL if anything goes wrong.
 695 </para>
 696
 697 @type: GtkType
 698 @Returns: gpointer to the klass.
 699
 700
 701 <!-- ##### FUNCTION gtk_type_children_types ##### -->
 702 <para>
 703 Return the pointer to the type's children's types.
 704 </para>
 705
 706 @type: GtkType
 707 @Returns: pointer to a GList
 708
 709
 710 <!-- ##### FUNCTION gtk_type_new ##### -->
 711 <para>
 712 Create a new object of a given type, and return a gpointer to it.
 713 Returns NULL if you give it an invalid type.  It allocates the object
 714 out of the type's memory chunk if there is a memory chunk.  The object
 715 has all the proper initializers called.
 716 </para>
 717
 718 @type: GtkType
 719 @Returns: gpointer to a GtkTypeObject
 720
 721
 722 <!-- ##### FUNCTION gtk_type_free ##### -->
 723 <para>
 724 Given the type of an object and a pointer to it, the object is freed.
 725 </para>
 726
 727 @type: GtkType
 728 @mem: gpointer to the object
 729
 730
 731 <!-- ##### FUNCTION gtk_type_describe_heritage ##### -->
 732 <para>
 733 Print the types @type inherits from.
 734 </para>
 735
 736 @type: GtkType
 737
 738
 739 <!-- ##### FUNCTION gtk_type_describe_tree ##### -->
 740 <para>
 741 Given a @type, describe all of its children, and their children.  Only
 742 show the size if @show_size is true.
 743 </para>
 744
 745 @type: GtkType
 746 @show_size: gboolean
 747
 748
 749 <!-- ##### FUNCTION gtk_type_is_a ##### -->
 750 <para>
 751 Look in the type hierarchy to see if @type has @is_a_type among its
 752 ancestors.  Do so with a simple lookup, not a loop.
 753 </para>
 754
 755 @type: GtkType
 756 @is_a_type: GtkType
 757 @Returns:
 758
 759
 760 <!-- ##### FUNCTION gtk_type_check_object_cast ##### -->
 761 <para>
 762 Given a pointer to a GtkTypeObject @type_object, and a GtkType @cast_type,
 763 make sure that it's okay to cast @type_object into a @cast_type.
 764 </para>
 765
 766 @type_object: GtkTypeObject*
 767 @cast_type: GtkType
 768 @Returns: the same GtkTypeObject* as @type_object
 769
 770
 771 <!-- ##### FUNCTION gtk_type_check_class_cast ##### -->
 772 <para>
 773 Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make
 774 sure that it's okay to cast something of that @klass into a @cast_type.
 775 </para>
 776
 777 @klass: GtkTypeClass*
 778 @cast_type: GtkType
 779 @Returns: Always return @klass.
 780
 781
 782 <!-- ##### FUNCTION gtk_type_register_enum ##### -->
 783 <para>
 784 Register a new set of enum @values and give them the name in
 785 @type_name.
 786 </para>
 787
 788 @type_name: must not be null.
 789 @values: GtkEnumValue*
 790 @Returns:
 791
 792
 793 <!-- ##### FUNCTION gtk_type_register_flags ##### -->
 794 <para>
 795 Register a new set of flags @values and give them the name in
 796 @type_name.
 797 </para>
 798
 799 @type_name: must not be null.
 800 @values: GtkFlagValue*
 801 @Returns:
 802
 803
 804 <!-- ##### FUNCTION gtk_type_enum_get_values ##### -->
 805 <para>
 806 If @enum_type has values, then return a pointer to all of them.
 807 </para>
 808
 809 @enum_type: GtkType
 810 @Returns: GtkEnumValue*
 811
 812
 813 <!-- ##### FUNCTION gtk_type_flags_get_values ##### -->
 814 <para>
 815 If @flags_type has values, then return a pointer to all of them.
 816 </para>
 817
 818 @flags_type:
 819 @Returns: GtkFlagValue*
 820
 821
 822 <!-- ##### FUNCTION gtk_type_enum_find_value ##### -->
 823 <para>
 824 Return a pointer to one of @enum_type's GtkEnumValues's whose name (or nickname) matches @value_name.
 825 </para>
 826
 827 @enum_type: GtkType
 828 @value_name:
 829 @Returns: GtkEnumValue*
 830
 831
 832 <!-- ##### FUNCTION gtk_type_flags_find_value ##### -->
 833 <para>
 834 Return a pointer to one of @flag_type's GtkFlagValue's whose name (or nickname) matches @value_name.
 835 </para>
 836
 837 @flag_type: GtkType
 838 @value_name:
 839 @Returns: GtkFlagValue*
 840
 841
 842 <!-- ##### FUNCTION gtk_type_set_varargs_type ##### -->
 843 <para>
 844 Set the varargs type for a fundamental type @foreign_type.
 845 </para>
 846
 847 @foreign_type: Must be a GtkType with a sequence number of zero.  Must not be a
 848 fundamental type.
 849 @varargs_type: Must be a GtkType which is either structured or flag, or NONE.
 850
 851
 852 <!-- ##### FUNCTION gtk_type_get_varargs_type ##### -->
 853 <para>
 854 Get the varargs type associated with @foreign_type
 855 </para>
 856
 857 @foreign_type: GtkType
 858 @Returns: GtkType
 859
 860
 861 <!-- ##### FUNCTION gtk_type_query ##### -->
 862 <para>
 863 Given a type, return various interesting parameters of the type.
 864 </para>
 865
 866 @type: GtkType
 867 @Returns: GtkTypeQuery*
 868
 869