gtype.sgml

GLib是GTK+和GNOME工程的基础底层核心程序库

will never be finalized (they are artificially kept alive when their
reference count drops to zero).
</para>

@g_class: 	The #GTypeClass structure to finalize.
@class_data: 	The @class_data member supplied via the #GTypeInfo structure.


<!-- ##### USER_FUNCTION GInstanceInitFunc ##### -->
<para>
A callback function used by the type system to initialize a new
instance of a type. This function initializes all instance members and
allocates any resources required by it.
Initialization of a derived instance involves calling all its parent
types instance initializers, therefore the class member of the instance
is altered during its initialization to always point to the class that
belongs to the type the current initializer was introduced for.
</para>

@instance: 	The instance to initialize.
@g_class: 	The class of the type the instance is created for.


<!-- ##### USER_FUNCTION GInterfaceInitFunc ##### -->
<para>
A callback function used by the type system to initialize a new
interface.  This function should initialize all internal data and
allocate any resources required by the interface.
</para>

@g_iface: 	The interface structure to initialize.
@iface_data: 	The @class_data supplied via the #GTypeInfo structure.


<!-- ##### USER_FUNCTION GInterfaceFinalizeFunc ##### -->
<para>
A callback function used by the type system to finalize an interface.
This function should destroy any internal data and release any resources
allocated by the corresponding GInterfaceInitFunc() function.
</para>

@g_iface: 	The interface structure to finalize.
@iface_data: 	The @class_data supplied via the #GTypeInfo structure.


<!-- ##### USER_FUNCTION GTypeClassCacheFunc ##### -->
<para>

</para>

@cache_data: 
@g_class: 
@Returns: 


<!-- ##### ENUM GTypeFlags ##### -->
<para>
Bit masks used to check or determine characteristics of a type.
</para>

@G_TYPE_FLAG_ABSTRACT: 	Indicates an abstract type. No instances can be
			created for an abstract type.
@G_TYPE_FLAG_VALUE_ABSTRACT: 

<!-- ##### ENUM GTypeFundamentalFlags ##### -->
<para>
Bit masks used to check or determine specific characteristics of a
fundamental type.
</para>

@G_TYPE_FLAG_CLASSED: 		Indicates a classed type.
@G_TYPE_FLAG_INSTANTIATABLE: 	Indicates an instantiable type (implies classed).
@G_TYPE_FLAG_DERIVABLE: 		Indicates a flat derivable type.
@G_TYPE_FLAG_DEEP_DERIVABLE: 	Indicates a deep derivable type (implies derivable).

<!-- ##### FUNCTION g_type_register_static ##### -->
<para>
Registers @type_name as the name of a new static type derived from
@parent_type.  The type system uses the information contained in the
#GTypeInfo structure pointed to by @info to manage the type and its
instances (if not abstract).  The value of @flags determines the nature
(e.g. abstract or not) of the type.
</para>

@parent_type: 	Type which this type will be derived from.
@type_name: 	Null-terminated string used as the name of the new type.
@info: 		The #GTypeInfo structure for this type.
@flags: 		Bitwise combination of #GTypeFlags values.
@Returns: 	The new type identifier.


<!-- ##### FUNCTION g_type_register_dynamic ##### -->
<para>
Registers @type_name as the name of a new dynamic type derived from
@parent_type.  The type system uses the information contained in the
#GTypePlugin structure pointed to by @plugin to manage the type and its
instances (if not abstract).  The value of @flags determines the nature
(e.g. abstract or not) of the type.
</para>

@parent_type: 	Type which this type will be derived from.
@type_name: 	Null-terminated string used as the name of the new type.
@plugin: 	The #GTypePlugin structure to retrive the #GTypeInfo from.
@flags: 		Bitwise combination of #GTypeFlags values.
@Returns: 	The new type identifier.
<!-- # Unused Parameters # -->
@Returns: #G_TYPE_INVALID if registration failed or the new type identifier.


<!-- ##### FUNCTION g_type_register_fundamental ##### -->
<para>
Registers @type_id as the predefined identifier and @type_name as the
name of a fundamental type.  The type system uses the information
contained in the #GTypeInfo structure pointed to by @info and the 
#GTypeFundamentalInfo structure pointed to by @finfo to manage the
type and its instances.  The value of @flags determines additional
characteristics of the fundamental type.
</para>

@type_id: 	A predefined #GTypeFundamentals value.
@type_name: 	Null-terminated string used as the name of the new type.
@info: 		The #GTypeInfo structure for this type.
@finfo: 		The #GTypeFundamentalInfo structure for this type.
@flags: 		Bitwise combination of #GTypeFlags values.
@Returns: 	The predefined type identifier.


<!-- ##### FUNCTION g_type_add_interface_static ##### -->
<para>
Adds the static @interface_type to @instantiable_type.  The information
contained in the #GTypeInterfaceInfo structure pointed to by @info
is used to manage the relationship.
</para>

@instance_type: 	 #GType value of an instantiable type.
@interface_type: #GType value of an interface type.
@info: 		 The #GInterfaceInfo structure for this
		 (@instance_type, @interface_type) combination.


<!-- ##### FUNCTION g_type_add_interface_dynamic ##### -->
<para>
</para>

@instance_type: 
@interface_type: 
@plugin: 


<!-- ##### FUNCTION g_type_interface_add_prerequisite ##### -->
<para>

</para>

@interface_type: 
@prerequisite_type: 


<!-- ##### FUNCTION g_type_get_plugin ##### -->
<para>
Returns the the #GTypePlugin structure for @type or
#NULL if @type does not have a #GTypePlugin structure.
</para>

@type: 		The #GType to retrive the plugin for.
@Returns: 	The corresponding plugin if @type is a dynamic type,
		NULL otherwise.


<!-- ##### FUNCTION g_type_interface_get_plugin ##### -->
<para>
</para>

@instance_type: 
@implementation_type: 
@Returns: 


<!-- ##### FUNCTION g_type_fundamental_next ##### -->
<para>
Returns the next free fundamental type id which can be used to
register a new fundamental type with g_type_register_fundamental().
The returned type ID represents the highest currently registered
fundamental type identifier.

</para>

@Returns: The nextmost fundamental type ID to be registered,
          or 0 if the type system ran out of fundamental type IDs.


<!-- ##### FUNCTION g_type_fundamental ##### -->
<para>
Internal function, used to extract the fundamental type ID portion.
use G_TYPE_FUNDAMENTAL() instead.
</para>

@type_id: valid type ID
@Returns: fundamental type ID


<!-- ##### FUNCTION g_type_create_instance ##### -->
<para>
Creates and initializes an instance of @type if @type is valid and can
be instantiated. The type system only performs basic allocation and
structure setups for instances, actual instance creation should happen
through functions supplied by the type's fundamental type implementation.
So use of g_type_create_instance() is reserved for implementators of
fundamental types only. E.g. instances of the #GObject hierarchy
should be created via g_object_new() and <emphasis>never</emphasis>
directly through g_type_create_instance() which doesn't handle
things like singleton objects or object construction.
Note: Do <emphasis>not</emphasis> use this function, unless you're
implementing a fundamental type. Also language bindings should <emphasis>not</emphasis>
use this function but g_object_new() instead.
</para>

@type: 	  An instantiabtable type to create an instance for.
@Returns: An allocated and initialized instance, subject to further
	  treatment by the fundamental type implementation.


<!-- ##### FUNCTION g_type_free_instance ##### -->
<para>
</para>

@instance: 


<!-- ##### FUNCTION g_type_add_class_cache_func ##### -->
<para>

</para>

@cache_data: 
@cache_func: 


<!-- ##### FUNCTION g_type_remove_class_cache_func ##### -->
<para>

</para>

@cache_data: 
@cache_func: 


<!-- ##### FUNCTION g_type_class_unref_uncached ##### -->
<para>

</para>

@g_class: 


<!-- ##### FUNCTION g_type_value_table_peek ##### -->
<para>
Returns the location of the #GTypeValueTable associated with @type.
<emphasis>Note, this function should only be used from source code
that implements or has internal knowledge of the implementation of
@type.</emphasis>
</para>

@type:    A #GType value.
@Returns: Location of the #GTypeValueTable associated with @type or
          #NULL if there is no #GTypeValueTable associated with @type.


<!-- ##### MACRO G_TYPE_INVALID ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_NONE ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_INTERFACE ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_CHAR ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_UCHAR ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_BOOLEAN ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_INT ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_UINT ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_LONG ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_ULONG ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_INT64 ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_UINT64 ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_ENUM ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_FLAGS ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_FLOAT ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_DOUBLE ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_STRING ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_POINTER ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_BOXED ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_PARAM ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_OBJECT ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_RESERVED_GLIB_FIRST ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_RESERVED_GLIB_LAST ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_RESERVED_BSE_FIRST ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_RESERVED_BSE_LAST ##### -->
<para>

</para>



<!-- ##### MACRO G_TYPE_RESERVED_USER_FIRST ##### -->
<para>

</para>