S60 Open C
gobject API Specification

gobject API Specification

Table of Contents

API Description
API Categories
GType
GType Plugin
GTypeModule
GObject
Enumeration and Flag
GBoxed
Generic Values
Parameters and Values
Varargs Value Collection
GParamSpec
Signals
Closures
Value arrays

 


API Description

 


API Categories

Following is the classification of the functions.

 


GType

This section lists functions of the GType, which is GLib Runtime type identification and management system.

GType

Function

Description

GType A numerical value which represents the unique identifier of a registered type.
G_TYPE_FUNDAMENTAL Returns the fundamental type which is the ancestor of type.
G_TYPE_FUNDAMENTAL_MAX An integer constant that represents the number of identifiers reserved for types that are assigned at compile-time.
G_TYPE_MAKE_FUNDAMENTAL Returns the type ID for the fundamental type number x.
G_TYPE_IS_ABSTRACT Returns TRUE if type is an abstract type.
G_TYPE_IS_DERIVED Returns TRUE if type is derived from another type.
G_TYPE_IS_FUNDAMENTAL Returns TRUE if type is a fundamental type.
G_TYPE_IS_VALUE_TYPE Returns TRUE if type is a value type which can be used for g_value_init().
G_TYPE_HAS_VALUE_TABLE Returns TRUE if type has a GTypeValueTable.
G_TYPE_IS_CLASSED Returns TRUE if type is a classed type.
G_TYPE_IS_INSTANTIATABLE Returns TRUE if type can be instantiated. Instantiation is the process of creating an instance (object) of this type.
G_TYPE_IS_DERIVABLE Returns TRUE if type is a derivable type.
G_TYPE_IS_DEEP_DERIVABLE Returns TRUE if type is a deep derivable type.
G_TYPE_IS_INTERFACE Returns TRUE if type is an interface type.
GTypeInterface An opaque structure used as the base of all interface types.
GTypeInstance An opaque structure used as the base of all type instances.
GTypeClass An opaque structure used as the base of all classes.
GTypeInfo This structure is used to provide the type system with the information required to initialize and destruct (finalize) a type's class and instances thereof.
GTypeFundamentalInfo A structure that provides information to the type system which is used specifically for managing fundamental types.
GInterfaceInfo A structure that provides information to the type system which is used specifically for managing interface types.
GTypeValueTable The GTypeValueTable provides the functions required by the GValue implementation, to serve as a container for values of a type.
G_TYPE_FROM_INSTANCE Returns the type identifier from a given instance structure.
G_TYPE_FROM_CLASS Returns the type identifier from a given class structure.
G_TYPE_FROM_INTERFACE Returns the type identifier from a given interface structure.
G_TYPE_INSTANCE_GET_CLASS Returns the class structure of a given instance, casted to a specified anchestor type g_type of the instance.
G_TYPE_INSTANCE_GET_INTERFACE Returns the interface structure for interface g_type of a given instance.
G_TYPE_INSTANCE_GET_PRIVATE Gets the private structure for a particular type.
G_TYPE_CHECK_INSTANCE Returns TRUE if instance is a valid GTypeInstance structure.
G_TYPE_CHECK_INSTANCE_CAST Checks that instance is an instance of the type identified by g_type and emits a warning if this is not the case.
G_TYPE_CHECK_INSTANCE_TYPE Returns TRUE if instance is an instance of the type identified by g_type.
G_TYPE_CHECK_CLASS_CAST Checks that g_class is a class structure of the type identified by g_type and emits a warning if this is not the case.
G_TYPE_CHECK_CLASS_TYPE Returns TRUE if g_class is a class structure of the type identified by g_type.
G_TYPE_CHECK_VALUE Returns TRUE if value has been initialized to hold values of a value type.
G_TYPE_CHECK_VALUE_TYPE Returns TRUE if value has been initialized to hold values of type g_type.
G_TYPE_FLAG_RESERVED_ID_BIT A bit in the type number that's supposed to be left untouched.
g_type_init Prior to any use of the type system, g_type_init() has to be called to initialize the type system.
GTypeDebugFlags The GTypeDebugFlags enumeration values can be passed to g_type_init_with_debug_flags() to trigger debugging messages during runtime.
g_type_init_with_debug_flags Similar to g_type_init(), but additionally sets debug flags.
g_type_name Return the corresponding quark of the type IDs name.
g_type_qname Looksup the type ID from a given type name.
g_type_from_name Returns the direct parent type of the passed in type.
g_type_parent Returns the direct parent type of the passed in type.
g_type_depth Returns the length of the ancestry of the passed in type.
g_type_next_base Determines the type that is derived directly from root_type .
g_type_is_a If is_a_type is a derivable type, check whether type is a descendant of is_a_type.
g_type_class_ref Increments the reference count of the class structure belonging to type.
g_type_class_peek This function is essentially the same as g_type_class_ref().
g_type_class_peek_static A more efficient version of g_type_class_peek().
g_type_class_unref Decrements the reference count of the class structure being passed in.
g_type_class_peek_parent This function is often needed in class initializers.
g_type_class_add_private Registers a private structure for a instantiatable type.
g_type_interface_peek Returns the GTypeInterface structure of an interface to which the passed in class conforms.
g_type_interface_peek_parent Returns the corresponding GTypeInterface structure of the parent type of the instance type to which g_iface belongs.
g_type_default_interface_ref Increments the reference count for the interface type g_type, and returns the default interface vtable for the type.
g_type_default_interface_peek If the interface type g_type is currently in use, returns its default interface vtable.
g_type_default_interface_unref Decrements the reference count for the type corresponding to the interface default vtable g_iface.
g_type_children Returns a newly allocated and 0-terminated array of type IDs, listing the child types of type.
g_type_interfaces Returns a newly allocated and 0-terminated array of type IDs, listing the interface types that type conforms to.
g_type_interface_prerequisites Returns the prerequisites of an interfaces type.
g_type_set_qdata Attaches arbitrary data to a type.
g_type_query Obtains data which has previously been attached to type with g_type_set_qdata().
GTypeQuery Queries the type system for information about a specific type.
GBaseInitFunc A structure holding information for a specific type.
GBaseFinalizeFunc A callback function used by the type system to do base initialization of the class structures of derived types.
GClassInitFunc A callback function used by the type system to initialize the class of a specific type.
GClassFinalizeFunc A callback function used by the type system to finalize a class.
GInstanceInitFunc A callback function used by the type system to initialize a new instance of a type.
GInterfaceInitFunc A callback function used by the type system to initialize a new interface.
GInterfaceFinalizeFunc A callback function used by the type system to finalize an interface.
GTypeClassCacheFunc A callback function which is called when the reference count of a class drops to zero.
GTypeFlags Bit masks used to check or determine characteristics of a type.
GTypeFundamentalFlags Bit masks used to check or determine specific characteristics of a fundamental type.
g_type_register_static Registers type_name as the name of a new static type derived from parent_type.
g_type_register_dynamic Registers type_name as the name of a new dynamic type derived from parent_type.
g_type_register_fundamental Registers type_id as the predefined identifier and type_name as the name of a fundamental type.
g_type_add_interface_static Adds the static interface_type to instantiable_type.
g_type_add_interface_dynamic Adds the dynamic interface_type to instantiable_type.
g_type_interface_add_prerequisite Adds prerequisite_type to the list of prerequisites of interface_type.
g_type_get_plugin Returns the GTypePlugin structure for type or NULL if type does not have a GTypePlugin structure.
g_type_interface_get_plugin Returns the GTypePlugin structure for the dynamic interface interface_type.
g_type_fundamental_next Returns the next free fundamental type id which can be used to register a new fundamental type with g_type_register_fundamental().
g_type_fundamental Internal function, used to extract the fundamental type ID portion.
g_type_create_instance Creates and initializes an instance of type if type is valid and can be instantiated.
g_type_free_instance Frees an instance of a type, returning it to the instance pool for the type, if there is one.
g_type_add_class_cache_func Adds a GTypeClassCacheFunc to be called before the reference count of a class goes from one to zero.
g_type_remove_class_cache_func Removes a previously installed GTypeClassCacheFunc.
g_type_class_unref_uncached A variant of g_type_class_unref() for use in GTypeClassCacheFunc implementations.
g_type_add_interface_check Adds a function to be called after an interface vtable is initialized for any class.
g_type_remove_interface_check Removes an interface check function added with g_type_add_interface_check().
GTypeInterfaceCheckFunc A callback called after an interface vtable is initialized.
g_type_value_table_peek Returns the location of the GTypeValueTable associated with type.
G_DEFINE_TYPE Macro used for type implementations.
G_DEFINE_TYPE_WITH_CODE Macro for type implementations. Similar to G_DEFINE_TYPE(), but allows to insert custom code into the *_get_type() function.
G_DEFINE_ABSTRACT_TYPE A convenience macro for type implementations. Similar to G_DEFINE_TYPE(), but defines an abstract type.
G_DEFINE_ABSTRACT_TYPE_WITH_CODE A convenience macro for type implementations.
G_IMPLEMENT_INTERFACE A convenience macro to ease interface addition in the _C_ section of G_DEFINE_TYPE_WITH_CODE() or G_DEFINE_ABSTRACT_TYPE_WITH_CODE().
G_DEFINE_TYPE_EXTENDED The most general convenience macro for type implementations, on which G_DEFINE_TYPE(), etc are based.
G_TYPE_INVALID An invalid GType, used as error return value in some functions which return a GType.
G_TYPE_NONE A fundamental type which is used as a replacement for the C void return type.
G_TYPE_INTERFACE The fundamental type from which all interfaces are derived.
G_TYPE_CHAR The fundamental type corresponding to gchar.
G_TYPE_UCHAR The fundamental type corresponding to guchar.
G_TYPE_BOOLEAN The fundamental type corresponding to gboolean.
G_TYPE_INT The fundamental type corresponding to gint.
G_TYPE_UINT The fundamental type corresponding to guint.
G_TYPE_LONG The fundamental type corresponding to glong.
G_TYPE_ULONG The fundamental type corresponding to gulong.
G_TYPE_INT64 The fundamental type corresponding to gint64.
G_TYPE_UINT64 The fundamental type corresponding to guint64.
G_TYPE_ENUM The fundamental type from which all enumeration types are derived.
G_TYPE_FLAGS The fundamental type from which all flags types are derived.
G_TYPE_FLOAT The fundamental type corresponding to gfloat.
G_TYPE_DOUBLE The fundamental type corresponding to gdouble.
G_TYPE_STRING The fundamental type corresponding to nul-terminated C strings.
G_TYPE_POINTER The fundamental type corresponding to gpointer.
G_TYPE_BOXED The fundamental type from which all boxed types are derived.
G_TYPE_PARAM The fundamental type from which all GParamSpec types are derived.
G_TYPE_OBJECT The fundamental type for GObject.
G_TYPE_RESERVED_GLIB_FIRST First fundamental type number to create a new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL() reserved for GLib.
G_TYPE_RESERVED_GLIB_LAST Last fundamental type number reserved for GLib.
G_TYPE_RESERVED_BSE_FIRST First fundamental type number to create a new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL() reserved for BSE. .
G_TYPE_RESERVED_BSE_LAST Last fundamental type number reserved for BSE.
G_TYPE_RESERVED_USER_FIRST First available fundamental type number to create new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL().

 


GType Plugin

This section lists functions of GTypePlugin interface, which is used to handle the lifecycle of dynamically loaded types.

GType Plugin

Functions

Description

GTypePlugin The GTypePlugin typedef is used as a placeholder for objects that implement the GTypePlugin interface.
GTypePluginClass The GTypePlugin interface is used by the type system in order to handle the lifecycle of dynamically loaded types.
GTypePluginUse The type of the use_plugin function of GTypePluginClass, which gets called to increase the use count of plugin.
GTypePluginUnuse The type of the unuse_plugin function of GTypePluginClass.
GTypePluginCompleteTypeInfo The type of the complete_type_info function of GTypePluginClass.
GTypePluginCompleteInterfaceInfo The type of the complete_interface_info function of GTypePluginClass.
g_type_plugin_use Calls the use_plugin function from the GTypePluginClass of plugin.
g_type_plugin_unuse Calls the unuse_plugin function from the GTypePluginClass of plugin.
g_type_plugin_complete_type_info Calls the complete_type_info function from the GTypePluginClass of plugin.
g_type_plugin_complete_interface_info Calls the complete_interface_info function from the GTypePluginClass of plugin.

 


GTypeModule

 This section lists the functions of GTypeModule, which provides a simple implementation of the GTypePlugin interface.

GTypeModule

Functions

Description

GTypeModule GTypeModule provides a simple implementation of the GTypePlugin interface.
GTypeModuleClass In order to implement dynamic loading of types based on GTypeModule, the load and unload functions in GTypeModuleClass must be implemented.
g_type_module_use Increases the use count of aGTypeModule by one.
g_type_module_unuse Decreases the use count of a GTypeModule by one.
g_type_module_set_name Sets the name for a GTypeModule.
g_type_module_register_type Looks up or registers a type that is implemented with a particular type plugin.
g_type_module_add_interface Registers an additional interface for a type, whose interface lives in the given type plugin.
g_type_module_register_enum Looks up or registers an enumeration that is implemented with a particular type plugin.
g_type_module_register_flags Looks up or registers a flags type that is implemented with a particular type plugin.

 


GObject

This section lists functions of the type GObject.

GObject

Functions

Description

GObject GObject is the fundamental type providing the common attributes and methods for all object types in GTK+, Pango and other libraries based on GObject.
GObjectClass The class structure for the GObject type.
GObjectConstructParam The GObjectConstructParam struct is an auxiliary structure used to hand GParamSpec/GValue pairs to the constructor of a GObjectClass.
GObjectGetPropertyFunc The type of the get_property function of GObjectClass.
GObjectSetPropertyFunc The type of the set_property function of GObjectClass.
GObjectFinalizeFunc The type of the finalize function of GObjectClass.
G_TYPE_IS_OBJECT Returns a boolean value of FALSE or TRUE indicating whether the passed in type id is a G_TYPE_OBJECT or derived from it.
G_OBJECT Casts a GObject or derived pointer into a (GObject*) pointer.
G_IS_OBJECT Checks whether a valid GTypeInstance pointer is of type G_TYPE_OBJECT.
G_OBJECT_CLASS Casts a derived GObjectClass structure into a GObjectClass structure.
G_IS_OBJECT_CLASS Checks whether class "is a" valid GObjectClass structure of type G_TYPE_OBJECT or derived.
G_OBJECT_GET_CLASS Returns the class structure associated to a GObject instance.
G_OBJECT_TYPE Returns the type id of an object.
G_OBJECT_TYPE_NAME Returns the name of an object's type.
G_OBJECT_CLASS_TYPE Returns the type id of a class structure.
G_OBJECT_CLASS_NAME Returns the name of a class structure's type.
g_object_class_install_property Installs a new property.
g_object_class_find_property Looks up the GParamSpec for a property of a class.
g_object_class_list_properties Returns an array of GParamSpec* for all properties of a class.
g_object_class_override_property Registers property_id as referring to a property with the name name in a parent class or in an interface implemented by oclass.
g_object_interface_install_property Adds a property to an interface; this is only useful for interfaces that are added to GObject-derived types.
g_object_interface_find_property Finds the GParamSpec with the given name for an interface.
g_object_interface_list_properties Lists the properties of an interface.
g_object_new Creates a new instance of a GObject subtype and sets its properties.
g_object_newv Creates a new instance of a GObject subtype and sets its properties.
GParameter The GParameter struct is an auxiliary structure used to hand parameter name/value pairs to g_object_newv().
g_object_ref Increases the reference count of object.
g_object_unref Decreases the reference count if object.
GWeakNotify A GWeakNotify function can be added to an object as a callback that gets triggered when the object is finalized.
g_object_weak_ref Adds a weak reference callback to an object.
g_object_weak_unref Removes a weak reference callback to an object.
g_object_add_weak_pointer Adds a weak reference from weak_pointer to object to indicate that the pointer located at weak_pointer_location is only valid during the lifetime of object.
g_object_remove_weak_pointer Removes a weak reference from object that was previously added using g_object_add_weak_pointer().
GToggleNotify A callback function used for notification when the state of a toggle reference changes.
g_object_add_toggle_ref Increases the reference count of the object by one and sets a callback to be called when all other references to the object are dropped, or when this is already the last reference to the object and another reference is established.
g_object_remove_toggle_ref Removes a reference added with g_object_add_toggle_ref().
g_object_connect Connects multiple signals at once.
g_object_disconnect Disconnects multiple signals at once.
g_object_set Sets properties on an object.
g_object_get Gets properties of an object.
g_object_notify Emits a "notify" signal for the property property_name on object.
g_object_freeze_notify Stops emission of "notify" signals on object.
g_object_thaw_notify Reverts the effect of a previous call to g_object_freeze_notify().
g_object_get_data Gets a named field from the objects table of associations.
g_object_set_data Each object carries around a table of associations from strings to pointers.
g_object_set_data_full Similar to g_object_set_data() except it adds notification for when the association is destroyed
g_object_steal_data Removes a specified datum from the object's data associations, without invoking the association's destroy handler.
g_object_get_qdata This function gets back user data pointers stored via g_object_set_qdata().
g_object_set_qdata This sets an opaque, named pointer on an object.
g_object_set_qdata_full This function works like g_object_set_qdata(), but in addition, a void (*destroy) (gpointer) function may be specified.
g_object_steal_qdata This function gets back user data pointers stored via g_object_set_qdata().
g_object_set_property Sets a property of an object.
g_object_get_property Gets a property of an object.
g_object_new_valist Creates a new instance of a GObject subtype and sets its properties.
g_object_set_valist Sets properties on an object.
g_object_get_valist Gets properties of an object.
g_object_watch_closure This function essentially limits the life time of the closure to the life time of the object.
g_object_run_dispose Releases all references to other objects.
G_OBJECT_WARN_INVALID_PROPERTY_ID The notify signal is emitted on an object when one of its properties has been changed.

 


Enumeration and Flag

This section lists the functions of Enumeration and Flag types.

Enumeration and Flag

Functions

Description

GEnumClass The class of an enumeration type holds information about its possible values.
GFlagsClass The class of a flags type holds information about its possible values.
G_ENUM_CLASS_TYPE Returns the type identifier from a given GEnumClass structure.
G_ENUM_CLASS_TYPE_NAME Returns the static type name from a given GEnumClass structure.
G_TYPE_IS_ENUM Returns whether type "is a" G_TYPE_ENUM.
G_ENUM_CLASS Casts a derived GEnumClass structure into a GEnumClass structure.
G_IS_ENUM_CLASS Checks whether class "is a" valid GEnumClass structure of type G_TYPE_ENUM or derived.
G_TYPE_IS_FLAGS Returns whether type "is a" G_TYPE_FLAGS.
G_FLAGS_CLASS Casts a derived GEnumClass structure into a GEnumClass structure.
G_IS_FLAGS_CLASS Checks whether class "is a" valid GEnumClass structure of type G_TYPE_FLAGS or derived.
G_FLAGS_CLASS_TYPE Returns the type identifier from a given GEnumClass structure.
G_FLAGS_CLASS_TYPE_NAME Returns the static type name from a given GEnumClass structure.
GEnumValue A structure which contains a single enum value, it's name, and it's nickname.
GFlagsValue A structure which contains a single flags value, it's name, and it's nickname.
g_enum_get_value Returns the GEnumClass for a value.
g_enum_get_value_by_name Looks up a GEnumClass by name.
g_enum_get_value_by_nick Looks up a GEnumClass by nickname.
g_flags_get_first_value Returns the first GEnumClass which is set in value.
g_flags_get_value_by_name Looks up a GFlagsValue by name.
g_flags_get_value_by_nick Looks up a GFlagsValue by nickname.
g_enum_register_static Registers a new static enumeration type with the name name.
g_flags_register_static Registers a new static flags type with the name name.
g_enum_complete_type_info This function is meant to be called from the complete_type_info() function of a GTypePlugin.
g_flags_complete_type_info This function is meant to be called from the complete_type_info() function of a GTypePlugin.

 


GBoxed

 This section lists functions of the type GBoxed, which is a mechanism to wrap opaque C structures registered by the type system.

GBoxed

Functions

Description

GBoxedCopyFunc This function is provided by the user and should produce a copy of the passed in boxed structure.
GBoxedFreeFunc This function is provided by the user and should free the boxed structure passed.
g_boxed_copy Provide a copy of a boxed structure src_boxed which is of type boxed_type.
g_boxed_free Free the boxed structure boxed which is of type boxed_type.
g_boxed_type_register_static This function creates a new G_TYPE_BOXED derived type id for a new boxed type with name name.
g_pointer_type_register_static Creates a new G_TYPE_POINTER derived type id for a new pointer type with name name.
G_TYPE_DATE The GType for GDate.
G_TYPE_GSTRING The GType for GString.
G_TYPE_STRV The GType for a boxed type holding a NULL-terminated array of strings.
GStrv C represent-able type name for G_TYPE_STRV.

 


Generic Values

This section lists functions of the type Generic Values, a polymorphic type that can hold values of any other type.

Generic Values

Functions

Description

G_VALUE_HOLDS Returns TRUE if value holds (or contains) a value of type.
G_VALUE_TYPE Returns the type identifier of value.
G_VALUE_TYPE_NAME Returns the type name of value.
G_TYPE_IS_VALUE Return whether the passed in type ID can be used for g_value_init().
G_TYPE_IS_VALUE_ABSTRACT Returns TRUE if type is an abstract value type.
G_IS_VALUE Returns TRUE if value is a valid and initialized GValue structure.
GValue An opaque structure used to hold different types of values.
G_TYPE_VALUE Returns the type ID of the "GValue" type which is a boxed type, used to pass around pointers to GValues.
G_TYPE_VALUE_ARRAY Returns the type ID of the "GValueArray" type which is a boxed type, used to pass around pointers to GValueArrays.
g_value_init Initializes value with the default value of type.
g_value_copy Copies the value of src_value into dest_value.
g_value_reset Clears the current value in value and resets it to the default value (as if the value had just been initialized).
g_value_unset Clears the current value in value and "unsets" the type.
g_value_fits_pointer Determines if value will fit inside the size of a pointer value.
g_value_peek_pointer Returns the value contents as pointer.
g_value_type_compatible Returns whether a GValue of type src_type can be copied into a GValue of type dest_type.
g_value_type_transformable Checks whether g_value_transform() is able to transform values of type src_type into values of type dest_type.
g_value_transform Tries to cast the contents of src_value into a type appropriate to store in dest_value.
GValueTransform The type of value transformation functions which can be registered with g_value_register_transform_func().
g_value_register_transform_func Registers a value transformation function for use in g_value_transform().
g_strdup_value_contents Return a newly allocated string, which describes the contents of a GValue.

 


Parameters and Values

This section lists functions of the type Parameters and Values.

Parameters and Values

Functions

Description

G_IS_PARAM_SPEC_BOOLEAN Returns whether the given GParamSpec is of type G_TYPE_PARAM_BOOLEAN.
G_PARAM_SPEC_BOOLEAN Casts a GParamSpec instance into a GParamSpecBoolean.
G_VALUE_HOLDS_BOOLEAN Returns whether the given GValue can hold values of type G_TYPE_BOOLEAN.
G_TYPE_PARAM_BOOLEAN The GType of GParamSpecBoolean.
GParamSpecBoolean A GParamSpec derived structure that contains the meta data for boolean properties.
g_param_spec_boolean Creates a new GParamSpecBoolean instance specifying a G_TYPE_BOOLEAN property.
g_value_set_boolean Sets the contents of a G_TYPE_BOOLEAN GValue to v_boolean.
g_value_get_boolean Gets the contents of a G_TYPE_BOOLEAN GValue.
G_IS_PARAM_SPEC_CHAR Returns whether the given GParamSpec is of type G_TYPE_PARAM_CHAR.
G_PARAM_SPEC_CHAR Casts a GParamSpec instance into a GParamSpecChar.
G_VALUE_HOLDS_CHAR Returns whether the given GValue can hold values of type G_TYPE_CHAR.
G_TYPE_PARAM_CHAR The GType of GParamSpecChar.
GParamSpecChar A GParamSpec derived structure that contains the meta data for character properties.
g_param_spec_char Creates a new GParamSpecChar instance specifying a G_TYPE_CHAR property.
g_value_set_char Sets the contents of a G_TYPE_CHAR GValue to v_char.
g_value_get_char Gets the contents of a G_TYPE_CHAR GValue.
G_IS_PARAM_SPEC_UCHAR Returns whether the given GParamSpec is of type G_TYPE_PARAM_UCHAR.
G_PARAM_SPEC_UCHAR Casts a GParamSpec instance into a GParamSpecUChar.
G_VALUE_HOLDS_UCHAR Returns whether the given GValue can hold values of type G_TYPE_UCHAR.
G_TYPE_PARAM_UCHAR The GType of GParamSpecUChar.
GParamSpecUChar A GParamSpec derived structure that contains the meta data for unsigned character properties.
g_param_spec_uchar Creates a new GParamSpecUChar instance specifying a G_TYPE_UCHAR property.
g_value_set_uchar Sets the contents of a G_TYPE_UCHAR GValue to v_uchar.
g_value_get_uchar Gets the contents of a G_TYPE_UCHAR GValue.
G_IS_PARAM_SPEC_INT Returns whether the given GParamSpec is of type G_TYPE_PARAM_INT.
G_PARAM_SPEC_INT Casts a GParamSpec instance into a GParamSpecInt.
G_VALUE_HOLDS_INT Returns whether the given GValue can hold values of type G_TYPE_INT.
G_TYPE_PARAM_INT The GType of GParamSpecInt.
GParamSpecInt A GParamSpec derived structure that contains the meta data for integer properties.
g_param_spec_int Creates a new GParamSpecInt instance specifying a G_TYPE_INT property.
g_value_set_int Sets the contents of a G_TYPE_INT GValue to v_int.
g_value_get_int Gets the contents of a G_TYPE_INT GValue.
G_IS_PARAM_SPEC_UINT Returns whether the given GParamSpec is of type G_TYPE_PARAM_UINT.
G_PARAM_SPEC_UINT Casts a GParamSpec instance into a GParamSpecUInt.
G_VALUE_HOLDS_UINT Returns whether the given GValue can hold values of type G_TYPE_UINT.
G_TYPE_PARAM_UINT The GType of GParamSpecUInt.
GParamSpecUInt A GParamSpec derived structure that contains the meta data for unsigned integer properties.
g_param_spec_uint Creates a new GParamSpecUInt instance specifying a G_TYPE_UINT property.
g_value_set_uint Sets the contents of a G_TYPE_UINT GValue to v_uint.
g_value_get_uint Gets the contents of a G_TYPE_UINT GValue.
G_IS_PARAM_SPEC_LONG Returns whether the given GParamSpec is of type G_TYPE_PARAM_LONG.
G_PARAM_SPEC_LONG Casts a GParamSpec instance into a GParamSpecLong.
G_VALUE_HOLDS_LONG Returns whether the given GValue can hold values of type G_TYPE_LONG.
G_TYPE_PARAM_LONG The GType of GParamSpecLong.
GParamSpecLong A GParamSpec derived structure that contains the meta data for long integer properties.
g_param_spec_long Creates a new GParamSpecLong instance specifying a G_TYPE_LONG property.
g_value_set_long Sets the contents of a G_TYPE_LONG GValue to v_long.
g_value_get_long Gets the contents of a G_TYPE_LONG GValue.
G_IS_PARAM_SPEC_ULONG Returns whether the given GParamSpec is of type G_TYPE_PARAM_ULONG.
G_PARAM_SPEC_ULONG Casts a GParamSpec instance into a GParamSpecULong.
G_VALUE_HOLDS_ULONG Returns whether the given GValue can hold values of type G_TYPE_ULONG.
G_TYPE_PARAM_ULONG The GType of GParamSpecULong.
GParamSpecULong A GParamSpec derived structure that contains the meta data for unsigned long integer properties.
g_param_spec_ulong Creates a new GParamSpecULong instance specifying a G_TYPE_ULONG property.
g_value_set_ulong Sets the contents of a G_TYPE_ULONG GValue to v_ulong.
g_value_get_ulong Gets the contents of a G_TYPE_ULONG GValue.
G_IS_PARAM_SPEC_INT64 Returns whether the given GParamSpec is of type G_TYPE_PARAM_INT64.
G_PARAM_SPEC_INT64 Casts a GParamSpec instance into a GParamSpecInt64.
G_VALUE_HOLDS_INT64 Returns whether the given GValue can hold values of type G_TYPE_INT64.
G_TYPE_PARAM_INT64 The GType of GParamSpecInt64.
GParamSpecInt64 A GParamSpec derived structure that contains the meta data for 64bit integer properties.
g_param_spec_int64 Creates a new GParamSpecInt64 instance specifying a G_TYPE_INT64 property.
g_value_set_int64 Sets the contents of a G_TYPE_INT64 GValue to v_int64.
g_value_get_int64 Gets the contents of a G_TYPE_INT64 GValue.
G_IS_PARAM_SPEC_UINT64 Returns whether the given GParamSpec is of type G_TYPE_PARAM_UINT64.
G_PARAM_SPEC_UINT64 Casts a GParamSpec instance into a GParamSpecUInt64.
G_VALUE_HOLDS_UINT64 Returns whether the given GValue can hold values of type G_TYPE_UINT64.
G_TYPE_PARAM_UINT64 The GType of GParamSpecUInt64.
GParamSpecUInt64 A GParamSpec derived structure that contains the meta data for unsigned 64bit integer properties.
g_param_spec_uint64 Creates a new GParamSpecUInt64 instance specifying a G_TYPE_UINT64 property.
g_value_set_uint64 Sets the contents of a G_TYPE_UINT64 GValue to v_uint64.
g_value_get_uint64 Gets the contents of a G_TYPE_UINT64 GValue.
G_IS_PARAM_SPEC_FLOAT Returns whether the given GParamSpec is of type G_TYPE_PARAM_FLOAT.
G_PARAM_SPEC_FLOAT Casts a GParamSpec instance into a GParamSpecFloat.
G_VALUE_HOLDS_FLOAT Returns whether the given GValue can hold values of type G_TYPE_FLOAT.
G_TYPE_PARAM_FLOAT The GType of GParamSpecFloat.
GParamSpecFloat A GParamSpec derived structure that contains the meta data for float properties.
g_value_set_float Sets the contents of a G_TYPE_FLOAT GValue to v_float.
g_value_get_float Gets the contents of a G_TYPE_FLOAT GValue.
G_IS_PARAM_SPEC_DOUBLE Returns whether the given GParamSpec is of type G_TYPE_PARAM_DOUBLE.
G_PARAM_SPEC_DOUBLE Casts a GParamSpec instance into a GParamSpecDouble.
G_VALUE_HOLDS_DOUBLE Returns whether the given GValue can hold values of type G_TYPE_DOUBLE.
G_TYPE_PARAM_DOUBLE The GType of GParamSpecDouble.
GParamSpecDouble A GParamSpec derived structure that contains the meta data for double properties.
g_param_spec_double Creates a new GParamSpecDouble instance specifying a G_TYPE_DOUBLE property.
g_value_set_double Sets the contents of a G_TYPE_DOUBLE GValue to v_double.
g_value_get_double Gets the contents of a G_TYPE_DOUBLE GValue.
G_IS_PARAM_SPEC_ENUM Returns whether the given GParamSpec is of type G_TYPE_PARAM_ENUM.
G_PARAM_SPEC_ENUM Casts a GParamSpec instance into a GParamSpecEnum.
G_VALUE_HOLDS_ENUM Returns whether the given GValue can hold values derived from type G_TYPE_ENUM.
G_TYPE_PARAM_ENUM The GType of GParamSpecEnum.
GParamSpecEnum A GParamSpec derived structure that contains the meta data for enum properties.
g_param_spec_enum Creates a new GParamSpecEnum instance specifying a G_TYPE_ENUM property.
g_value_set_enum Sets the contents of a G_TYPE_ENUM GValue to v_enum.
g_value_get_enum Gets the contents of a G_TYPE_ENUM GValue.
G_IS_PARAM_SPEC_FLAGS Returns whether the given GParamSpec is of type G_TYPE_PARAM_FLAGS.
G_PARAM_SPEC_FLAGS Casts a GParamSpec instance into a GParamSpecFlags.
G_VALUE_HOLDS_FLAGS Returns whether the given GValue can hold values derived from type G_TYPE_FLAGS.
G_TYPE_PARAM_FLAGS The GType of GParamSpecFlags.
GParamSpecFlags A GParamSpec derived structure that contains the meta data for flags properties.
g_param_spec_flags Creates a new GParamSpecEnum instance specifying a G_TYPE_FLAGS property.
g_value_set_flags Sets the contents of a G_TYPE_FLAGS GValue to v_flags.
g_value_get_flags Gets the contents of a G_TYPE_FLAGS GValue.
G_IS_PARAM_SPEC_STRING Returns whether the given GParamSpec is of type G_TYPE_PARAM_STRING.
G_PARAM_SPEC_STRING Casts a GParamSpec instance into a GParamSpecString.
G_VALUE_HOLDS_STRING Returns whether the given GValue can hold values of type G_TYPE_STRING.
G_TYPE_PARAM_STRING The GType of GParamSpecString.
GParamSpecString A GParamSpec derived structure that contains the meta data for string properties.
gchararray C representable type name for G_TYPE_STRING.
g_param_spec_string Creates a new GParamSpecString instance.
g_value_set_string Sets the contents of a G_TYPE_STRING GValue to v_string.
g_value_set_static_string Sets the contents of a G_TYPE_STRING GValue to v_string.
g_value_take_string Sets the contents of a G_TYPE_STRING GValue to v_string.
g_value_set_string_take_ownership This is an internal function introduced mainly for C marshallers.
g_value_get_string Gets the contents of a G_TYPE_STRING GValue.
g_value_dup_string Gets a copy the contents of a G_TYPE_STRING GValue.

 


Varargs Value Collection

 This section lists functions of the type Varargs Value Collection, which convert varargs to generic values.

Varargs Value Collection

Functions

Description

GTypeCValue A union holding one collected value.
G_VALUE_COLLECT Collects a variable argument value from a va_list.
G_VALUE_LCOPY Collects a value's variable argument locations from a va_list.
G_VALUE_COLLECT_FORMAT_MAX_LENGTH The maximal number of GTypeCValues which can be collected for a single GValue.

 


GParamSpec

 This section lists functions of the type GParamSpec, which is an object structure that encapsulates the metadata required to specify parameters.

GParamSpec

Functions

Description

G_TYPE_IS_PARAM Returns whether type "is a" G_TYPE_PARAM.
G_PARAM_SPEC Casts a derived GParamSpec object into a GParamSpec object.
G_IS_PARAM_SPEC Checks whether pspec "is a" valid GParamSpec structure of type G_TYPE_PARAM or derived.
G_PARAM_SPEC_CLASS' Casts a derived GParamSpecClass structure into a GParamSpecClass structure.
G_IS_PARAM_SPEC_CLASS Checks whether pclass "is a" valid GParamSpecClass structure of type G_TYPE_PARAM or derived.
G_PARAM_SPEC_GET_CLASS Retrieves the GParamSpecClass of a GParamSpec.
G_PARAM_SPEC_TYPE Retrieves the GType of this pspec.
G_PARAM_SPEC_TYPE_NAME Retrieves the GType name of this pspec.
G_PARAM_SPEC_VALUE_TYPE Retrieves the GType to initialize a GValue for this parameter.
GParamSpec Metadata for parameter specifications.
GParamSpecClass The class structure for the GParamSpec type.
GParamFlags Through the GParamFlags flag values, certain aspects of parameters can be configured.
G_PARAM_READWRITE GParamFlags value alias for G_PARAM_READABLE | G_PARAM_WRITABLE.
G_PARAM_MASK Masks containing the bits of GParamSpec flags which are reserved for GLib.
G_PARAM_USER_SHIFT Minimum shift count to be used for user defined flags, to be stored in GParamSpec flags.
g_param_spec_ref Increments the reference count of pspec.
g_param_spec_unref Decrements the reference count of a pspec.
g_param_spec_sink Convenient function to ref and sink a GParamSpec.
g_param_value_set_default Sets value to its default value as specified in pspec.
g_param_value_defaults Checks whether value contains the default value as specified in pspec.
g_param_value_validate Ensures that the contents of value comply with the specifications set out by pspec.
g_param_value_convert Transforms src_value into dest_value if possible, and then validates dest_value, in order for it to conform to pspec.
g_param_values_cmp Compares value1 with value2 according to pspec.
g_param_spec_get_name Returns the name of a GParamSpec.
g_param_spec_get_nick Returns the nickname of a GParamSpec.
g_param_spec_get_blurb Returns the short description of a GParamSpec.
g_param_spec_get_qdata Sets an opaque, named pointer on a GParamSpec.
g_param_spec_set_qdata Sets an opaque, named pointer on a GParamSpec.
g_param_spec_set_qdata_full This function works like g_param_spec_set_qdata().
g_param_spec_steal_qdata Gets back user data pointers stored via g_param_spec_set_qdata().
g_param_spec_get_redirect_target If the paramspec redirects operations to another paramspec, returns that paramspec.
g_param_spec_internal Creates a new GParamSpec instance.
GParamSpecTypeInfo This structure is used to provide the type system with the information required to initialize and destruct (finalize) a parameter's class and instances thereof.
g_param_type_register_static Registers name as the name of a new static type derived from G_TYPE_PARAM.
GParamSpecPool A GParamSpecPool maintains a collection of GParamSpecs which can be quickly accessed by owner and name.
g_param_spec_pool_new Creates a new GParamSpecPool.
g_param_spec_pool_insert Inserts a GParamSpec in the pool.
g_param_spec_pool_remove Removes a GParamSpec from the pool.
g_param_spec_pool_lookup Looks up a GParamSpec in the pool.
g_param_spec_pool_list Gets an array of all GParamSpecs owned by owner_type in the pool.
g_param_spec_pool_list_owned Gets an GList of all GParamSpecs owned by owner_type in the pool.

 


Signals

 This section lists functions of the type Signals, which is a means for customization of object behaviour and a general purpose notification mechanism.

Signals

Functions

Description

GSignalInvocationHint The GSignalInvocationHint structure is used to pass on additional information to callbacks during a signal emission.
GSignalAccumulator The signal accumulator is a special callback function that can be used to collect return values of the various callbacks that are called during a signal emission.
GSignalCMarshaller This is the signature of marshaller functions, required to marshall arrays of parameter values to signal emissions into C language callback invocations.
GSignalEmissionHook A simple function pointer to get invoked when the signal is emitted.
GSignalFlags The signal flags are used to specify a signal's behaviour.
GSignalMatchType The match types specify what g_signal_handlers_block_matched(), g_signal_handlers_unblock_matched() and g_signal_handlers_disconnect_matched() match signals by.
GSignalQuery A structure holding in-depth information for a specific signal
G_SIGNAL_TYPE_STATIC_SCOPE This macro flags signal argument types for which the signal system may assume that instances thereof remain persistent across all signal emissions they are used in.
G_SIGNAL_MATCH_MASK A mask for all GSignalMatchType bits.
G_SIGNAL_FLAGS_MASK A mask for all GSignalFlags bits.
g_signal_new Creates a new signal.
g_signal_newv Creates a new signal.
g_signal_new_valist Creates a new signal.
g_signal_query Queries the signal system for in-depth information about a specific signal.
g_signal_lookup Given the name of the signal and the type of object it connects to, gets the signal's identifying integer.
g_signal_name Given the signal's identifier, finds its name.
g_signal_list_ids Lists the signals by id that a certain instance or interface type created.
g_signal_emit Emits a signal.
g_signal_emit_by_name Emits a signal.
g_signal_emitv Emits a signal.
g_signal_emit_valist Emits a signal.
g_signal_connect Connects a GCallback function to a signal for a particular object.
g_signal_connect_after Connects a GCallback function to a signal for a particular object.
g_signal_connect_swapped This is similar to g_signal_connect_data(), but uses a closure which ensures that the gobject stays alive during the call to c_handler by temporarily adding a reference count to gobject.
g_signal_connect_object The connection flags are used to specify the behaviour of a signal's connection.
GConnectFlags Connects a GCallback function to a signal for a particular object.
g_signal_connect_closure Connects a closure to a signal for a particular object.
g_signal_connect_closure_by_id Connects a closure to a signal for a particular object.
g_signal_handler_block Blocks a handler of an instance so it will not be called during any signal emissions unless it is unblocked again.
g_signal_handler_unblock Undoes the effect of a previous g_signal_handler_block() call.
g_signal_handler_disconnect Disconnects a handler from an instance so it will not be called during any future or currently ongoing emissions of the signal it has been connected to.
g_signal_handler_find Finds the first signal handler that matches certain selection criteria.
g_signal_handlers_block_matched Blocks all handlers on an instance that match a certain selection criteria.
g_signal_handlers_unblock_matched Unblocks all handlers on an instance that match a certain selection criteria.
g_signal_handlers_disconnect_matched Disconnects all handlers on an instance that match a certain selection criteria.
g_signal_handler_is_connected Returns whether handler_id is the id of a handler connected to instance.
g_signal_handlers_block_by_func Blocks all handlers on an instance that match func and data.
g_signal_handlers_unblock_by_func Unblocks all handlers on an instance that match func and data.
g_signal_handlers_disconnect_by_func Disconnects all handlers on an instance that match func and data.
g_signal_has_handler_pending Returns whether there are any handlers connected to instance for the given signal id and detail.
g_signal_stop_emission Stops a signal's current emission.
g_signal_stop_emission_by_name Stops a signal's current emission.
g_signal_override_class_closure Overrides the class closure.
g_signal_chain_from_overridden Calls the original class closure of a signal.
g_signal_add_emission_hook Adds an emission hook for a signal, which will get called for any emission of that signal, independent of the instance.
g_signal_remove_emission_hook Deletes an emission hook.
g_signal_parse_name Internal function to parse a signal name into its signal_id and detail quark.
g_signal_get_invocation_hint Returns the invocation hint of the innermost signal emission of instance.
g_signal_type_cclosure_new Creates a new closure which invokes the function found at the offset struct_offset in the class structure of the interface or classed type identified by itype.
g_signal_accumulator_true_handled A predefined GSignalAccumulator for signals that return a boolean values.

 


Closures

This section lists the functions of the type Closures, which behave as first-class objects.

Closures

Functions

Description

G_CLOSURE_NEEDS_MARSHAL Returns TRUE if a GClosureMarshal marshaller has not yet been set on closure.
G_CLOSURE_N_NOTIFIERS Returns the total number of notifiers connected with the closure cl.
G_CCLOSURE_SWAP_DATA Returns whether the user data of the GCClosure should be passed as the first parameter to the callback.
G_CALLBACK Casts a function pointer to a GCallback.
GCallback The type used for callback functions in structure definitions and function signatures.
GClosure A GClosure represents a callback supplied by the programmer.
G_TYPE_CLOSURE The GType for GClosure.
GClosureMarshal The type used for marshaller functions.
GClosureNotify The type used for the various notification callbacks which can be registered on closures.
g_cclosure_new Creates a new closure which invokes callback_func with user_data as the last parameter.
g_cclosure_new_swap Creates a new closure which invokes callback_func with user_data as the first parameter.
g_cclosure_new_object A variant of g_cclosure_new() which uses object as user_data and calls g_object_watch_closure() on object and the created closure.
g_cclosure_new_object_swap A variant of g_cclosure_new_swap() which uses object as user_data and calls g_object_watch_closure() on object and the created closure.
g_closure_new_object A variant of g_closure_new_simple() which stores object in the data field of the closure and calls g_object_watch_closure() on object and the created closure.
g_closure_ref Increments the reference count on a closure to force it staying alive while the caller holds a pointer to it.
g_closure_sink Takes over the initial ownership of a closure.
g_closure_unref Decrements the reference count of a closure after it was previously incremented by the same caller.
g_closure_invoke Invokes the closure, i.e. executes the callback represented by the closure.
g_closure_invalidate Sets a flag on the closure to indicate that it's calling environment has become invalid.
g_closure_add_finalize_notifier Registers a finalization notifier which will be called when the reference count of closure goes down to 0.
g_closure_add_invalidate_notifier Registers an invalidation notifier which will be called when the closure is invalidated with g_closure_invalidate().
g_closure_remove_finalize_notifier Removes a finalization notifier. Notifiers are automatically removed after they are run.
g_closure_remove_invalidate_notifier Removes a invalidation notifier. Notifiers are automatically removed after they are run.
g_closure_new_simple Allocates a struct of the given size and initializes the initial part as a GClosure.
g_closure_set_marshal Sets the marshaller of closure. The marshal_data provides a way for a meta marshaller to provide additional information to the marshaller.
g_closure_add_marshal_guards Adds a pair of notifiers which get invoked before and after the closure callback, respectively.
g_closure_set_meta_marshal Sets the meta marshaller of closure.
g_source_set_closure Sets the callback for a source as a GClosure.
G_TYPE_IO_CHANNEL The GType for GIOChannel.
G_TYPE_IO_CONDITION The GType for GIOCondition.
g_cclosure_marshal_VOID__VOID A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gpointer user_data).
g_cclosure_marshal_VOID__BOOLEAN A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gboolean arg1, gpointer user_data).
g_cclosure_marshal_VOID__CHAR A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gchar arg1, gpointer user_data).
g_cclosure_marshal_VOID__UCHAR A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, guchar arg1, gpointer user_data).
g_cclosure_marshal_VOID__INT A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gint arg1, gpointer user_data).
g_cclosure_marshal_VOID__UINT A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, guint arg1, gpointer user_data).
g_cclosure_marshal_VOID__LONG A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, glong arg1, gpointer user_data).
g_cclosure_marshal_VOID__ULONG A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gulong arg1, gpointer user_data).
g_cclosure_marshal_VOID__ENUM A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gint arg1, gpointer user_data).
g_cclosure_marshal_VOID__FLAGS A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gint arg1, gpointer user_data).
g_cclosure_marshal_VOID__FLOAT A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gfloat arg1, gpointer user_data).
g_cclosure_marshal_VOID__DOUBLE A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gdouble arg1, gpointer user_data).
g_cclosure_marshal_VOID__STRING A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data).
g_cclosure_marshal_VOID__PARAM A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data).
g_cclosure_marshal_VOID__BOXED A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data).
g_cclosure_marshal_VOID__POINTER A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, gpointer arg1, gpointer user_data).
g_cclosure_marshal_VOID__OBJECT A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, GOBject *arg1, gpointer user_data).
g_cclosure_marshal_STRING__OBJECT_POINTER A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data).
g_cclosure_marshal_VOID__UINT_POINTER A marshaller for a GCClosure with a callback of type void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data).
g_cclosure_marshal_BOOLEAN__FLAGS A marshaller for a GCClosure with a callback of type gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data).
g_cclosure_marshal_BOOL__FLAGS Another name for g_cclosure_marshal_BOOLEAN__FLAGS()

 


Value arrays

This section lists functions of the type Value arrays, which are container structure to maintain an array of generic values.

Value arrays

Functions

Description

GValueArray A GValueArray contains an array of GValue elements.
g_value_array_get_nth Return a pointer to the value at index_ containd in value_array.
g_value_array_new Allocates and initializes a new GValueArray, optionally preserves space for n_prealloced elements.
g_value_array_copy Constructs an exact copy of a GValueArray by duplicating all its contents.
g_value_array_free Frees a GValueArray including its contents.
g_value_array_append Inserts a copy of value as last element of value_array.
g_value_array_prepend Inserts a copy of value as first element of value_array.
g_value_array_insert Inserts a copy of value at specified position into value_array.
g_value_array_remove Removes the value at position index_ from value_array.
g_value_array_sort Sorts value_array using compare_func to compare the elements accoring to the semantics of GCompareFunc.

Give feedback of this article


©Nokia 2007

Back to top


This material, including documentation and any related computer programs, is protected by copyright controlled by Nokia. All rights are reserved. Copying, including reproducing, storing, adapting or translating, any or all of this material requires the prior written consent of Nokia. This material also contains confidential information, which may not be disclosed to others without the prior written consent of Nokia.

Nokia is a registered trademark of Nokia Corporation. S60 and logo is a trademark of Nokia Corporation. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. Other company and product names mentioned herein may be trademarks or tradenames of their respective owners.