Free the boxed structure boxed which is of type boxed_type.

Parameters:

Number boxed_type Required (not null)

The type of boxed.

void* boxed Required (not null)

The boxed structure to be freed.

Returns:

none

Returns:

none

Parameters:

GObject.Closure closure Required (not null)

GObject.Value return_value Required (not null)

guint32 n_param_values Required (not null)

GObject.Value param_values Required (not null)

void* invocation_hint Required (not null)

void* marshal_data Required (not null)

Returns:

none

A marshaller for a GCClosure with a callback of type
gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data) where the gint parameter
denotes a flags type.

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

a GValue which can store the returned gboolean

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding instance and arg1

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

a GValue, which can store the returned string

guint32 n_param_values Required (not null)

3

GObject.Value param_values Required (not null)

a GValue array holding instance, arg1 and arg2

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gboolean arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the gboolean parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the GBoxed* parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gchar arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the gchar parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gdouble arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the gdouble parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gint arg1, gpointer user_data) where the gint parameter denotes an enumeration type..

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the enumeration parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gint arg1, gpointer user_data) where the gint parameter denotes a flags type.

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the flags parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gfloat arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the gfloat parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gint arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the gint parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, glong arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the glong parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, GObject *arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the GObject* parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the GParamSpec* parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gpointer arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the gpointer parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the gchar* parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, guchar arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the guchar parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, guint arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the guint parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

3

GObject.Value param_values Required (not null)

a GValue array holding instance, arg1 and arg2

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gulong arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the gulong parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

2

GObject.Value param_values Required (not null)

a GValue array holding the instance and the GVariant* parameter

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

A marshaller for a GCClosure with a callback of type
void (*callback) (gpointer instance, gpointer user_data).

Parameters:

GObject.Closure closure Required (not null)

the GClosure to which the marshaller belongs

GObject.Value return_value Required (not null)

ignored

guint32 n_param_values Required (not null)

1

GObject.Value param_values Required (not null)

a GValue array holding only the instance

void* invocation_hint Required (not null)

the invocation hint given as the last argument to g_closure_invoke()

void* marshal_data Required (not null)

additional data specified when registering the marshaller

Returns:

none

This function is meant to be called from the complete_type_info()
function of a GTypePlugin implementation, as in the following
example:
|[
static void
my_enum_complete_type_info (GTypePlugin *plugin,
GType g_type,
GTypeInfo *info,
GTypeValueTable *value_table)
{
static const GEnumValue values[] = {
{ MY_ENUM_FOO, "MY_ENUM_FOO", "foo" },
{ MY_ENUM_BAR, "MY_ENUM_BAR", "bar" },
{ 0, NULL, NULL }
};
g_enum_complete_type_info (type, info, values);
}
]|

Parameters:

Number g_enum_type Required (not null)

the type identifier of the type being completed

GObject.TypeInfo info Required (not null)

the GTypeInfo struct to be filled in

GObject.EnumValue const_values Required (not null)

An array of GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0.

Returns:

none

Registers a new static enumeration type with the name name.
It is normally more convenient to let linkend="glib-mkenums">glib-mkenums generate a
my_enum_get_type() function from a usual C enumeration definition
than to write one yourself using g_enum_register_static().

Parameters:

String name Required (not null)

A nul-terminated string used as the name of the new type.

GObject.EnumValue const_static_values Required (not null)

An array of GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. GObject keeps a reference to the data, so it cannot be stack-allocated.

Returns:

Number The new type identifier.

Returns:

none

This function is meant to be called from the complete_type_info()
function of a GTypePlugin implementation, see the example for
g_enum_complete_type_info() above.

Parameters:

Number g_flags_type Required (not null)

the type identifier of the type being completed

GObject.TypeInfo info Required (not null)

the GTypeInfo struct to be filled in

GObject.FlagsValue const_values Required (not null)

An array of GFlagsValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0.

Returns:

none

Registers a new static flags type with the name name.
It is normally more convenient to let linkend="glib-mkenums">glib-mkenums generate a
my_flags_get_type() function from a usual C enumeration definition
than to write one yourself using g_flags_register_static().

Parameters:

String name Required (not null)

A nul-terminated string used as the name of the new type.

GObject.FlagsValue const_static_values Required (not null)

An array of GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being 0. GObject keeps a reference to the data, so it cannot be stack-allocated.

Returns:

Number The new type identifier.

Returns:

Number

Returns:

Number

Creates a new GParamSpecPool.
If type_prefixing is TRUE, lookups in the newly created pool will
allow to specify the owner as a colon-separated prefix of the
property name, like "GtkContainer:border-width". This feature is
deprecated, so you should always set type_prefixing to FALSE.

Parameters:

gboolean type_prefixing Required (not null)

Whether the pool will support type-prefixed property names.

Returns:

GObject.ParamSpecPool a newly allocated GParamSpecPool.

Returns:

none

Returns:

none

Registers name as the name of a new static type derived from
G_TYPE_PARAM. The type system uses the information contained in
the GParamSpecTypeInfo structure pointed to by info to manage the
GParamSpec type and its instances.

Parameters:

String name Required (not null)

0-terminated string used as the name of the new GParamSpec type.

GObject.ParamSpecTypeInfo pspec_info Required (not null)

The GParamSpecTypeInfo for this GParamSpec type.

Returns:

Number The new type identifier.

Transforms src_value into dest_value if possible, and then
validates dest_value, in order for it to conform to pspec. If
transformed dest_value complied to pspec without modifications.
See also g_value_type_transformable(), g_value_transform() and
g_param_value_validate().
FALSE otherwise and dest_value is left untouched.

Parameters:

GObject.ParamSpec pspec Required (not null)

a valid GParamSpec

GObject.Value src_value Required (not null)

souce GValue

GObject.Value dest_value Required (not null)

destination GValue of correct type for pspec

gboolean strict_validation Required (not null)

TRUE requires dest_value to conform to pspec without modifications

Returns:

gboolean TRUE if transformation and validation were successful,

Checks whether value contains the default value as specified in pspec.

Parameters:

GObject.ParamSpec pspec Required (not null)

a valid GParamSpec

GObject.Value value Required (not null)

a GValue of correct type for pspec

Returns:

gboolean whether value contains the canonical default for this pspec

Sets value to its default value as specified in pspec.

Parameters:

GObject.ParamSpec pspec Required (not null)

a valid GParamSpec

GObject.Value value Required (not null)

a GValue of correct type for pspec

Returns:

none

Ensures that the contents of value comply with the specifications
set out by pspec. For example, a GParamSpecInt might require
that integers stored in value may not be smaller than -42 and not be
greater than +42. If value contains an integer outside of this range,
it is modified accordingly, so the resulting value will fit into the
range -42 .. +42.

Parameters:

GObject.ParamSpec pspec Required (not null)

a valid GParamSpec

GObject.Value value Required (not null)

a GValue of correct type for pspec

Returns:

gboolean whether modifying value was necessary to ensure validity

Compares value1 with value2 according to pspec, and return -1, 0 or +1,
if value1 is found to be less than, equal to or greater than value2,
respectively.

Parameters:

GObject.ParamSpec pspec Required (not null)

a valid GParamSpec

GObject.Value value1 Required (not null)

a GValue of correct type for pspec

GObject.Value value2 Required (not null)

a GValue of correct type for pspec

Returns:

gint32 -1, 0 or +1, for a less than, equal to or greater than result

Creates a new G_TYPE_POINTER derived type id for a new
pointer type with name name.

Parameters:

String name Required (not null)

the name of the new pointer type.

Returns:

Number a new G_TYPE_POINTER derived type id for name.

A predefined GSignalAccumulator for signals intended to be used as a
hook for application code to provide a particular value. Usually
only one such value is desired and multiple handlers for the same
signal don't make much sense (except for the case of the default
handler defined in the class structure, in which case you will
usually want the signal connection to override the class handler).
This accumulator will use the return value from the first signal
handler that is run as the return value for the signal and not run

Parameters:

GObject.SignalInvocationHint ihint Required (not null)

standard GSignalAccumulator parameter

GObject.Value return_accu Required (not null)

standard GSignalAccumulator parameter

GObject.Value handler_return Required (not null)

standard GSignalAccumulator parameter

void* dummy Required (not null)

standard GSignalAccumulator parameter

Returns:

gboolean standard GSignalAccumulator result

A predefined GSignalAccumulator for signals that return a
boolean values. The behavior that this accumulator gives is
callbacks will be invoked, while a return of FALSE allows
the emission to continue. The idea here is that a TRUE return
indicates that the callback handled the signal,
and no further handling is needed.

Parameters:

GObject.SignalInvocationHint ihint Required (not null)

standard GSignalAccumulator parameter

GObject.Value return_accu Required (not null)

standard GSignalAccumulator parameter

GObject.Value handler_return Required (not null)

standard GSignalAccumulator parameter

void* dummy Required (not null)

standard GSignalAccumulator parameter

Returns:

gboolean standard GSignalAccumulator result

Adds an emission hook for a signal, which will get called for any emission
of that signal, independent of the instance. This is possible only
for signals which don't have G_SIGNAL_NO_HOOKS flag set.

Parameters:

guint32 signal_id Required (not null)

the signal identifier, as returned by g_signal_lookup().

guint32 detail Required (not null)

the detail on which to call the hook.

Function (SignalInvocationHint ihint, guint32 n_param_values, Value param_values, void* data) : guint32 Required (not null)

a GSignalEmissionHook function.

void* hook_data Required (not null)

user data for hook_func.

Function (void* data) : guint32 Required (not null)

a GDestroyNotify for hook_data.

Returns:

guint32 the hook id, for later use with g_signal_remove_emission_hook().

Calls the original class closure of a signal. This function should only
be called from an overridden class closure; see
g_signal_override_class_closure() and
g_signal_override_class_handler().

Parameters:

GObject.Value instance_and_params Required (not null)

the argument list of the signal emission. The first element in the array is a GValue for the instance the signal is being emitted on. The rest are any arguments to be passed to the signal.

GObject.Value return_value Required (not null)

Location for the return value.

Returns:

none

Connects a closure to a signal for a particular object.

Parameters:

void* instance Required (not null)

the instance to connect to.

String detailed_signal Required (not null)

a string of the form "signal-name::detail".

GObject.Closure closure Required (not null)

the closure to connect.

gboolean after Required (not null)

whether the handler should be called before or after the default handler of the signal.

Returns:

guint32 the handler id

Connects a closure to a signal for a particular object.

Parameters:

void* instance Required (not null)

the instance to connect to.

guint32 signal_id Required (not null)

the id of the signal.

guint32 detail Required (not null)

the detail.

GObject.Closure closure Required (not null)

the closure to connect.

gboolean after Required (not null)

whether the handler should be called before or after the default handler of the signal.

Returns:

guint32 the handler id

Emits a signal.
Note that g_signal_emitv() doesn't change return_value if no handlers are
connected, in contrast to g_signal_emit() and g_signal_emit_valist().

Parameters:

GObject.Value instance_and_params Required (not null)

argument list for the signal emission. The first element in the array is a GValue for the instance the signal is being emitted on. The rest are any arguments to be passed to the signal.

guint32 signal_id Required (not null)

the signal id

guint32 detail Required (not null)

the detail

GObject.Value return_value Required (not null)

Location to store the return value of the signal emission.

Returns:

none

Blocks a handler of an instance so it will not be called during any
signal emissions unless it is unblocked again. Thus "blocking" a
signal handler means to temporarily deactive it, a signal handler
has to be unblocked exactly the same amount of times it has been
blocked before to become active again.
The handler_id has to be a valid signal handler id, connected to a
signal of instance.

Parameters:

void* instance Required (not null)

The instance to block the signal handler of.

guint32 handler_id Required (not null)

Handler id of the handler to be blocked.

Returns:

none

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. The handler_id becomes invalid and may be reused.
The handler_id has to be a valid signal handler id, connected to a
signal of instance.

Parameters:

void* instance Required (not null)

The instance to remove the signal handler from.

guint32 handler_id Required (not null)

Handler id of the handler to be disconnected.

Returns:

none

Finds the first signal handler that matches certain selection criteria.
The criteria mask is passed as an OR-ed combination of GSignalMatchType
flags, and the criteria values are passed as arguments.
The match mask has to be non-0 for successful matches.
If no handler was found, 0 is returned.

Parameters:

void* instance Required (not null)

The instance owning the signal handler to be found.

GObject.SignalMatchType mask Required (not null)

Mask indicating which of signal_id, detail, closure, func and/or data the handler has to match.

guint32 signal_id Required (not null)

Signal the handler has to be connected to.

guint32 detail Required (not null)

Signal detail the handler has to be connected to.

GObject.Closure closure Required (not null)

The closure the handler will invoke.

void* func Required (not null)

The C closure callback of the handler (useless for non-C closures).

void* data Required (not null)

The closure data of the handler's closure.

Returns:

guint32 A valid non-0 signal handler id for a successful match.

Returns whether handler_id is the id of a handler connected to instance.

Parameters:

void* instance Required (not null)

The instance where a signal handler is sought.

guint32 handler_id Required (not null)

the handler id.

Returns:

gboolean whether handler_id identifies a handler connected to instance.

Undoes the effect of a previous g_signal_handler_block() call. A
blocked handler is skipped during signal emissions and will not be
invoked, unblocking it (for exactly the amount of times it has been
blocked before) reverts its "blocked" state, so the handler will be
recognized by the signal system and is called upon future or
currently ongoing signal emissions (since the order in which
handlers are called during signal emissions is deterministic,
whether the unblocked handler in question is called as part of a
currently ongoing emission depends on how far that emission has
proceeded yet).
The handler_id has to be a valid id of a signal handler that is
connected to a signal of instance and is currently blocked.

Parameters:

void* instance Required (not null)

The instance to unblock the signal handler of.

guint32 handler_id Required (not null)

Handler id of the handler to be unblocked.

Returns:

none

Blocks all handlers on an instance that match a certain selection criteria.
The criteria mask is passed as an OR-ed combination of GSignalMatchType
flags, and the criteria values are passed as arguments.
Passing at least one of the G_SIGNAL_MATCH_CLOSURE, G_SIGNAL_MATCH_FUNC
or G_SIGNAL_MATCH_DATA match flags is required for successful matches.
If no handlers were found, 0 is returned, the number of blocked handlers
otherwise.

Parameters:

void* instance Required (not null)

The instance to block handlers from.

GObject.SignalMatchType mask Required (not null)

Mask indicating which of signal_id, detail, closure, func and/or data the handlers have to match.

guint32 signal_id Required (not null)

Signal the handlers have to be connected to.

guint32 detail Required (not null)

Signal detail the handlers have to be connected to.

GObject.Closure closure Required (not null)

The closure the handlers will invoke.

void* func Required (not null)

The C closure callback of the handlers (useless for non-C closures).

void* data Required (not null)

The closure data of the handlers' closures.

Returns:

guint32 The number of handlers that matched.

Parameters:

void* instance Required (not null)

Returns:

none

Disconnects all handlers on an instance that match a certain
selection criteria. The criteria mask is passed as an OR-ed
combination of GSignalMatchType flags, and the criteria values are
passed as arguments. Passing at least one of the
G_SIGNAL_MATCH_CLOSURE, G_SIGNAL_MATCH_FUNC or
G_SIGNAL_MATCH_DATA match flags is required for successful
matches. If no handlers were found, 0 is returned, the number of
disconnected handlers otherwise.

Parameters:

void* instance Required (not null)

The instance to remove handlers from.

GObject.SignalMatchType mask Required (not null)

Mask indicating which of signal_id, detail, closure, func and/or data the handlers have to match.

guint32 signal_id Required (not null)

Signal the handlers have to be connected to.

guint32 detail Required (not null)

Signal detail the handlers have to be connected to.

GObject.Closure closure Required (not null)

The closure the handlers will invoke.

void* func Required (not null)

The C closure callback of the handlers (useless for non-C closures).

void* data Required (not null)

The closure data of the handlers' closures.

Returns:

guint32 The number of handlers that matched.

Unblocks all handlers on an instance that match a certain selection
criteria. The criteria mask is passed as an OR-ed combination of
GSignalMatchType flags, and the criteria values are passed as arguments.
Passing at least one of the G_SIGNAL_MATCH_CLOSURE, G_SIGNAL_MATCH_FUNC
or G_SIGNAL_MATCH_DATA match flags is required for successful matches.
If no handlers were found, 0 is returned, the number of unblocked handlers
otherwise. The match criteria should not apply to any handlers that are
not currently blocked.

Parameters:

void* instance Required (not null)

The instance to unblock handlers from.

GObject.SignalMatchType mask Required (not null)

Mask indicating which of signal_id, detail, closure, func and/or data the handlers have to match.

guint32 signal_id Required (not null)

Signal the handlers have to be connected to.

guint32 detail Required (not null)

Signal detail the handlers have to be connected to.

GObject.Closure closure Required (not null)

The closure the handlers will invoke.

void* func Required (not null)

The C closure callback of the handlers (useless for non-C closures).

void* data Required (not null)

The closure data of the handlers' closures.

Returns:

guint32 The number of handlers that matched.

Returns whether there are any handlers connected to instance for the
given signal id and detail.
One example of when you might use this is when the arguments to the
signal are difficult to compute. A class implementor may opt to not
emit the signal if no one is attached anyway, thus saving the cost
of building the arguments.
otherwise.

Parameters:

void* instance Required (not null)

the object whose signal handlers are sought.

guint32 signal_id Required (not null)

the signal id.

guint32 detail Required (not null)

the detail.

gboolean may_be_blocked Required (not null)

whether blocked handlers should count as match.

Returns:

gboolean TRUE if a handler is connected to the signal, FALSE

Returns:

none

Lists the signals by id that a certain instance or interface type
created. Further information about the signals can be acquired through
g_signal_query().

Parameters:

Number itype Required (not null)

Instance or interface type.

guint32 n_ids Required (not null)

Location to store the number of signal ids for itype.

Returns:

guint32 Newly allocated array of signal IDs.

Given the name of the signal and the type of object it connects to, gets
the signal's identifying integer. Emitting the signal by number is
somewhat faster than using the name each time.
Also tries the ancestors of the given type.
See g_signal_new() for details on allowed signal names.

Parameters:

String name Required (not null)

the signal's name.

Number itype Required (not null)

the type that the signal operates on.

Returns:

guint32 the signal's identifying number, or 0 if no signal was found.

Given the signal's identifier, finds its name.
Two different signals may have the same name, if they have differing types.

Parameters:

guint32 signal_id Required (not null)

the signal's identifying number.

Returns:

String the signal name, or NULL if the signal number was invalid.

Overrides the class closure (i.e. the default handler) for the given signal
for emissions on instances of instance_type. instance_type must be derived
from the type to which the signal belongs.
See g_signal_chain_from_overridden() and
g_signal_chain_from_overridden_handler() for how to chain up to the
parent class closure from inside the overridden one.

Parameters:

guint32 signal_id Required (not null)

the signal id

Number instance_type Required (not null)

the instance type on which to override the class closure for the signal.

GObject.Closure class_closure Required (not null)

the closure.

Returns:

none

Internal function to parse a signal name into its signal_id
and detail quark.

Parameters:

String detailed_signal Required (not null)

a string of the form "signal-name::detail".

Number itype Required (not null)

The interface/instance type that introduced "signal-name".

guint32 signal_id_p Required (not null)

Location to store the signal id.

guint32 detail_p Required (not null)

Location to store the detail quark.

gboolean force_detail_quark Required (not null)

TRUE forces creation of a GQuark for the detail.

Returns:

gboolean Whether the signal name could successfully be parsed and signal_id_p and detail_p contain valid return values.

Queries the signal system for in-depth information about a
specific signal. This function will fill in a user-provided
structure to hold signal-specific information. If an invalid
signal id is passed in, the signal_id member of the GSignalQuery
is 0. All members filled into the GSignalQuery structure should
be considered constant and have to be left untouched.

Parameters:

guint32 signal_id Required (not null)

The signal id of the signal to query information for.

GObject.SignalQuery query Required (not null)

A user provided structure that is filled in with constant values upon success.

Returns:

none

Deletes an emission hook.

Parameters:

guint32 signal_id Required (not null)

the id of the signal

guint32 hook_id Required (not null)

the id of the emission hook, as returned by g_signal_add_emission_hook()

Returns:

none

Stops a signal's current emission.
This will prevent the default method from running, if the signal was
G_SIGNAL_RUN_LAST and you connected normally (i.e. without the "after"
flag).
Prints a warning if used on a signal which isn't being emitted.

Parameters:

void* instance Required (not null)

the object whose signal handlers you wish to stop.

guint32 signal_id Required (not null)

the signal identifier, as returned by g_signal_lookup().

guint32 detail Required (not null)

the detail which the signal was emitted with.

Returns:

none

Stops a signal's current emission.
This is just like g_signal_stop_emission() except it will look up the
signal id for you.

Parameters:

void* instance Required (not null)

the object whose signal handlers you wish to stop.

String detailed_signal Required (not null)

a string of the form "signal-name::detail".

Returns:

none

Creates a new closure which invokes the function found at the offset
identified by itype.

Parameters:

Number itype Required (not null)

the GType identifier of an interface or classed type

guint32 struct_offset Required (not null)

the offset of the member function of itype's class structure which is to be invoked by the new closure

Returns:

GObject.Closure a new GCClosure

Set the callback for a source as a GClosure.
If the source is not one of the standard GLib types, the closure_callback
and closure_marshal fields of the GSourceFuncs structure must have been
filled in with pointers to appropriate functions.

Parameters:

GLib.Source source Required (not null)

the source

GObject.Closure closure Required (not null)

a GClosure

Returns:

none

Sets a dummy callback for source. The callback will do nothing, and
if the source expects a gboolean return value, it will return TRUE.
(If the source expects any other type of return value, it will return
a 0/NULL value; whatever g_value_init() initializes a GValue to for
that type.)
If the source is not one of the standard GLib types, the
structure must have been filled in with pointers to appropriate
functions.

Parameters:

GLib.Source source Required (not null)

the source

Returns:

none

Return a newly allocated string, which describes the contents of a
GValue. The main purpose of this function is to describe GValue
contents for debugging output, the way in which the contents are
described may change between different GLib versions.

Parameters:

GObject.Value value Required (not null)

GValue which contents are to be described.

Returns:

String Newly allocated string.

Returns:

Number

Registers a private class structure for a classed type;
when the class is allocated, the private structures for
the class and all of its parent types are allocated
sequentially in the same memory block as the public
structures. This function should be called in the
type's get_type() function after the type is registered.
The private structure can be retrieved using the
G_TYPE_CLASS_GET_PRIVATE() macro.

Parameters:

Number class_type Required (not null)

GType of an classed type.

guint32 private_size Required (not null)

size of private structure.

Returns:

none

Adds the dynamic interface_type to instantiable_type. The information
contained in the GTypePlugin structure pointed to by plugin
is used to manage the relationship.

Parameters:

Number instance_type Required (not null)

the GType value of an instantiable type.

Number interface_type Required (not null)

the GType value of an interface type.

GObject.TypePlugin plugin Required (not null)

the GTypePlugin structure to retrieve the GInterfaceInfo from.

Returns:

none

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.

Parameters:

Number instance_type Required (not null)

GType value of an instantiable type.

Number interface_type Required (not null)

GType value of an interface type.

GObject.InterfaceInfo info Required (not null)

The GInterfaceInfo structure for this (instance_type, interface_type) combination.

Returns:

none

Parameters:

GObject.TypeClass g_class Required (not null)

Number is_a_type Required (not null)

Returns:

gboolean

Private helper function to aid implementation of the G_TYPE_CHECK_INSTANCE()
macro.

Parameters:

GObject.TypeInstance instance Required (not null)

A valid GTypeInstance structure.

Returns:

gboolean

Parameters:

GObject.TypeInstance instance Required (not null)

Number iface_type Required (not null)

Returns:

gboolean

Parameters:

Number type Required (not null)

Returns:

gboolean

Parameters:

GObject.Value value Required (not null)

Returns:

gboolean

Parameters:

GObject.Value value Required (not null)

Number type Required (not null)

Returns:

gboolean

Return a newly allocated and 0-terminated array of type IDs, listing the
child types of type. The return value has to be g_free()ed after use.
and 0-terminated array of child types.

Parameters:

Number type Required (not null)

The parent type.

Object out_values

guint32 n_children

Returns:

Array Newly allocated

Registers a private structure for an instantiatable type.
When an object is allocated, the private structures for
the type and all of its parent types are allocated
sequentially in the same memory block as the public
structures.
Note that the accumulated size of the private structures of
a type and all its parent types cannot excced 64kB.
This function should be called in the type's class_init() function.
The private structure can be retrieved using the
G_TYPE_INSTANCE_GET_PRIVATE() macro.
The following example shows attaching a private structure
MyObjectPrivate to an object
MyObject defined in the standard GObject
fashion.
type's class_init() function.
|[
typedef struct _MyObject MyObject;
typedef struct _MyObjectPrivate MyObjectPrivate;
struct _MyObject {
GObject parent;
MyObjectPrivate *priv;
};
struct _MyObjectPrivate {
int some_field;
};
static void
my_object_class_init (MyObjectClass *klass)
{
g_type_class_add_private (klass, sizeof (MyObjectPrivate));
}
static void
my_object_init (MyObject *my_object)
{
my_object->priv = G_TYPE_INSTANCE_GET_PRIVATE (my_object,
MY_TYPE_OBJECT,
MyObjectPrivate);
}
static int
my_object_get_some_field (MyObject *my_object)
{
MyObjectPrivate *priv = my_object->priv;
return priv->some_field;
}
]|

Parameters:

void* g_class Required (not null)

class structure for an instantiatable type

guint32 private_size Required (not null)

size of private structure.

Returns:

none

This function is essentially the same as g_type_class_ref(), except that
the classes reference count isn't incremented. As a consequence, this function
may return NULL if the class of the type passed in does not currently
exist (hasn't been referenced before).
structure for the given type ID or NULL if the class does not
currently exist.

Parameters:

Number type Required (not null)

Type ID of a classed type.

Returns:

GObject.TypeClass The GTypeClass

A more efficient version of g_type_class_peek() which works only for
static types.
structure for the given type ID or NULL if the class does not
currently exist or is dynamically loaded.

Parameters:

Number type Required (not null)

Type ID of a classed type.

Returns:

GObject.TypeClass The GTypeClass

If the interface type g_type is currently in use, returns its
default interface vtable.
vtable for the interface, or NULL if the type is not currently in
use.

Parameters:

Number g_type Required (not null)

an interface type

Returns:

GObject.TypeInterface the default

Returns the length of the ancestry of the passed in type. This
includes the type itself, so that e.g. a fundamental type has depth 1.

Parameters:

Number type Required (not null)

A GType value.

Returns:

guint32 The depth of type.

Frees an instance of a type, returning it to the instance pool for
the type, if there is one.
Like g_type_create_instance(), this function is reserved for
implementors of fundamental types.

Parameters:

GObject.TypeInstance instance Required (not null)

an instance of a type.

Returns:

none

Lookup the type ID from a given type name, returning 0 if no type
has been registered under this name (this is the preferred method
to find out by name whether a specific type has been registered
yet).

Parameters:

String name Required (not null)

Type name to lookup.

Returns:

Number Corresponding type ID or 0.

Internal function, used to extract the fundamental type ID portion.
use G_TYPE_FUNDAMENTAL() instead.

Parameters:

Number type_id Required (not null)

valid type ID

Returns:

Number fundamental type ID

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.
or 0 if the type system ran out of fundamental type IDs.

Returns:

Number The nextmost fundamental type ID to be registered,

Returns the GTypePlugin structure for type or
NULL if type does not have a GTypePlugin structure.
dynamic type, NULL otherwise.

Parameters:

Number type Required (not null)

The GType to retrieve the plugin for.

Returns:

GObject.TypePlugin The corresponding plugin if type is a

Obtains data which has previously been attached to type
with g_type_set_qdata().

Parameters:

Number type Required (not null)

a GType

guint32 quark Required (not null)

a GQuark id to identify the data

Returns:

void* the data, or NULL if no data was found

Prior to any use of the type system, g_type_init() has to be called
to initialize the type system and assorted other code portions
(such as the various fundamental type implementations or the signal
system).
Since version 2.24 this also initializes the thread system

Returns:

none

Similar to g_type_init(), but additionally sets debug flags.

Parameters:

GObject.TypeDebugFlags debug_flags Required (not null)

Bitwise combination of GTypeDebugFlags values for debugging purposes.

Returns:

none

Adds prerequisite_type to the list of prerequisites of interface_type.
This means that any type implementing interface_type must also implement
interface derivation (which GType doesn't support). An interface can have
at most one instantiatable prerequisite type.

Parameters:

Number interface_type Required (not null)

GType value of an interface type.

Number prerequisite_type Required (not null)

GType value of an interface or instantiatable type.

Returns:

none

Returns the GTypePlugin structure for the dynamic interface
have a GTypePlugin structure. See g_type_add_interface_dynamic().
interface interface_type of instance_type.

Parameters:

Number instance_type Required (not null)

the GType value of an instantiatable type.

Number interface_type Required (not null)

the GType value of an interface type.

Returns:

GObject.TypePlugin the GTypePlugin for the dynamic

Returns the GTypeInterface structure of an interface to which the
passed in class conforms.
structure of iface_type if implemented by instance_class, NULL
otherwise

Parameters:

GObject.TypeClass instance_class Required (not null)

A GTypeClass structure.

Number iface_type Required (not null)

An interface ID which this class conforms to.

Returns:

GObject.TypeInterface The GTypeInterface

Returns the prerequisites of an interfaces type.
newly-allocated zero-terminated array of GType containing
the prerequisites of interface_type

Parameters:

Number interface_type Required (not null)

an interface type

Object out_values

guint32 n_prerequisites

Returns:

Array a

Return a newly allocated and 0-terminated array of type IDs, listing the
interface types that type conforms to. The return value has to be
g_free()ed after use.
allocated and 0-terminated array of interface types.

Parameters:

Number type Required (not null)

The type to list interface types for.

Object out_values

guint32 n_interfaces

Returns:

Array Newly

If is_a_type is a derivable type, check whether type is a
descendant of is_a_type. If is_a_type is an interface, check
whether type conforms to it.

Parameters:

Number type Required (not null)

Type to check anchestry for.

Number is_a_type Required (not null)

Possible anchestor of type or interface type could conform to.

Returns:

gboolean TRUE if type is_a is_a_type holds true.

Get the unique name that is assigned to a type ID. Note that this
function (like all other GType API) cannot cope with invalid type
IDs. G_TYPE_INVALID may be passed to this function, as may be any
other validly registered type ID, but randomized type IDs should
not be passed in and will most likely lead to a crash.

Parameters:

Number type Required (not null)

Type to return name for.

Returns:

String Static type name or NULL.

Parameters:

GObject.TypeClass g_class Required (not null)

Returns:

String

Parameters:

GObject.TypeInstance instance Required (not null)

Returns:

String

Given a leaf_type and a root_type which is contained in its
anchestry, return the type that root_type is the immediate parent
of. In other words, this function determines the type that is
derived directly from root_type which is also a base class of
be used to determine the types and order in which the leaf type is
descended from the root type.

Parameters:

Number leaf_type Required (not null)

Descendant of root_type and the type to be returned.

Number root_type Required (not null)

Immediate parent of the returned type.

Returns:

Number Immediate child of root_type and anchestor of leaf_type.

Return the direct parent type of the passed in type. If the passed
in type has no parent, i.e. is a fundamental type, 0 is returned.

Parameters:

Number type Required (not null)

The derived type.

Returns:

Number The parent type.

Get the corresponding quark of the type IDs name.

Parameters:

Number type Required (not null)

Type to return quark of type name for.

Returns:

guint32 The type names quark or 0.

Queries the type system for information about a specific type.
This function will fill in a user-provided structure to hold
type-specific information. If an invalid GType is passed in, the
GTypeQuery structure should be considered constant and have to be
left untouched.

Parameters:

Number type Required (not null)

the GType value of a static, classed type.

Returns:

GObject.TypeQuery

Registers type_name as the name of a new dynamic type derived from
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.

Parameters:

Number parent_type Required (not null)

Type from which this type will be derived.

String type_name Required (not null)

0-terminated string used as the name of the new type.

GObject.TypePlugin plugin Required (not null)

The GTypePlugin structure to retrieve the GTypeInfo from.

GObject.TypeFlags flags Required (not null)

Bitwise combination of GTypeFlags values.

Returns:

Number The new type identifier or G_TYPE_INVALID if registration failed.

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.

Parameters:

Number type_id Required (not null)

A predefined type identifier.

String type_name Required (not null)

0-terminated string used as the name of the new type.

GObject.TypeInfo info Required (not null)

The GTypeInfo structure for this type.

GObject.TypeFundamentalInfo finfo Required (not null)

The GTypeFundamentalInfo structure for this type.

GObject.TypeFlags flags Required (not null)

Bitwise combination of GTypeFlags values.

Returns:

Number The predefined type identifier.

Registers type_name as the name of a new static type derived from
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.

Parameters:

Number parent_type Required (not null)

Type from which this type will be derived.

String type_name Required (not null)

0-terminated string used as the name of the new type.

GObject.TypeInfo info Required (not null)

The GTypeInfo structure for this type.

GObject.TypeFlags flags Required (not null)

Bitwise combination of GTypeFlags values.

Returns:

Number The new type identifier.

Attaches arbitrary data to a type.

Parameters:

Number type Required (not null)

a GType

guint32 quark Required (not null)

a GQuark id to identify the data

void* data Required (not null)

the data

Returns:

none

Parameters:

Number type Required (not null)

guint32 flags Required (not null)

Returns:

gboolean

Returns:

none

Returns:

none

Returns whether a GValue of type src_type can be copied into
a GValue of type dest_type.

Parameters:

Number src_type Required (not null)

source type to be copied.

Number dest_type Required (not null)

destination type for copying.

Returns:

gboolean TRUE if g_value_copy() is possible with src_type and dest_type.

Check whether g_value_transform() is able to transform values
of type src_type into values of type dest_type.

Parameters:

Number src_type Required (not null)

Source type.

Number dest_type Required (not null)

Target type.

Returns:

gboolean TRUE if the transformation is possible, FALSE otherwise.

Returns:

none

Returns:

Number

Returns:

Number