GObject.CClosure¶

Fields¶

Name	Type	Access	Description
callback	`object`	r/w	the callback function
closure	`GObject.Closure`	r/w	the `GObject.Closure`

Methods¶

class	`marshal_BOOLEAN__BOXED_BOXED` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_BOOLEAN__FLAGS` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_STRING__OBJECT_POINTER` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__BOOLEAN` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__BOXED` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__CHAR` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__DOUBLE` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__ENUM` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__FLAGS` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__FLOAT` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__INT` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__LONG` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__OBJECT` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__PARAM` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__POINTER` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__STRING` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__UCHAR` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__UINT` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__UINT_POINTER` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__ULONG` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__VARIANT` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_VOID__VOID` (closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)
class	`marshal_generic` (closure, return_gvalue, n_param_values, param_values, invocation_hint, marshal_data)

Details¶

class GObject.CClosure¶

A GObject.CClosure is a specialization of GObject.Closure for C function callbacks.

classmethod marshal_BOOLEAN__BOXED_BOXED(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with handlers that take two boxed pointers as arguments and return a boolean. If you have such a signal, you will probably also need to use an accumulator, such as GObject.signal_accumulator_true_handled().

classmethod marshal_BOOLEAN__FLAGS(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with handlers that take a flags type as an argument and return a boolean. If you have such a signal, you will probably also need to use an accumulator, such as GObject.signal_accumulator_true_handled().

classmethod marshal_STRING__OBJECT_POINTER(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with handlers that take a GObject.Object and a pointer and produce a string. It is highly unlikely that your signal handler fits this description.

classmethod marshal_VOID__BOOLEAN(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single boolean argument.

classmethod marshal_VOID__BOXED(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single argument which is any boxed pointer type.

classmethod marshal_VOID__CHAR(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single character argument.

classmethod marshal_VOID__DOUBLE(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with one double-precision floating point argument.

classmethod marshal_VOID__ENUM(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single argument with an enumerated type.

classmethod marshal_VOID__FLAGS(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single argument with a flags types.

classmethod marshal_VOID__FLOAT(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with one single-precision floating point argument.

classmethod marshal_VOID__INT(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single integer argument.

classmethod marshal_VOID__LONG(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with with a single long integer argument.

classmethod marshal_VOID__OBJECT(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single GObject.Object argument.

classmethod marshal_VOID__PARAM(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single argument of type GObject.ParamSpec.

classmethod marshal_VOID__POINTER(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single raw pointer argument type.

If it is possible, it is better to use one of the more specific functions such as GObject.CClosure.marshal_VOID__OBJECT() or GObject.CClosure.marshal_VOID__OBJECT().

classmethod marshal_VOID__STRING(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single string argument.

classmethod marshal_VOID__UCHAR(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single unsigned character argument.

classmethod marshal_VOID__UINT(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with with a single unsigned integer argument.

classmethod marshal_VOID__UINT_POINTER(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with an unsigned int and a pointer as arguments.

classmethod marshal_VOID__ULONG(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single unsigned long integer argument.

classmethod marshal_VOID__VARIANT(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with a single GLib.Variant argument.

classmethod marshal_VOID__VOID(closure, return_value, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_value (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A GObject.ClosureMarshal function for use with signals with no arguments.

classmethod marshal_generic(closure, return_gvalue, n_param_values, param_values, invocation_hint, marshal_data)[source]¶

Parameters:

closure (GObject.Closure) – A GObject.Closure.
return_gvalue (GObject.Value) – A GObject.Value to store the return value. May be None if the callback of closure doesn’t return a value.
n_param_values (int) – The length of the param_values array.
param_values (GObject.Value) – An array of GObject.Values holding the arguments on which to invoke the callback of closure.
invocation_hint (object or None) – The invocation hint given as the last argument to GObject.Closure.invoke().
marshal_data (object or None) – Additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal()

A generic marshaller function implemented via libffi.

Normally this function is not passed explicitly to GObject.signal_new(), but used automatically by GLib when specifying a None marshaller.

New in version 2.30.