GObject.TypeInterface

Fields

Name	Type	Access	Description
g_instance_type	GObject.GType	r
g_type	GObject.GType	r

Methods

class	add_prerequisite (interface_type, prerequisite_type)
class	get_plugin (instance_type, interface_type)
class	instantiatable_prerequisite (interface_type)
class	peek (instance_class, iface_type)
class	prerequisites (interface_type)
	peek_parent ()

Details

class GObject.TypeInterface

An opaque structure used as the base of all interface types.

classmethod add_prerequisite(interface_type, prerequisite_type)

Parameters:

• interface_type (GObject.GType) – GObject.GType value of an interface type

• prerequisite_type (GObject.GType) – GObject.GType value of an interface or instantiatable type

Adds prerequisite_type to the list of prerequisites of interface_type. This means that any type implementing interface_type must also implement prerequisite_type. Prerequisites can be thought of as an alternative to interface derivation (which GObject.GType doesn’t support). An interface can have at most one instantiatable prerequisite type.

classmethod get_plugin(instance_type, interface_type)

Parameters:

• instance_type (GObject.GType) – GObject.GType of an instantiatable type

• interface_type (GObject.GType) – GObject.GType of an interface type

Returns:

the GObject.TypePlugin for the dynamic interface interface_type of instance_type

Return type:

GObject.TypePlugin

Returns the GObject.TypePlugin structure for the dynamic interface interface_type which has been added to instance_type, or None if interface_type has not been added to instance_type or does not have a GObject.TypePlugin structure. See GObject.type_add_interface_dynamic().

classmethod instantiatable_prerequisite(interface_type)

Parameters:

interface_type (GObject.GType) – an interface type

Returns:

the instantiatable prerequisite type or GObject.TYPE_INVALID if none

Return type:

GObject.GType

Returns the most specific instantiatable prerequisite of an interface type. If the interface type has no instantiatable prerequisite, GObject.TYPE_INVALID is returned.

See GObject.TypeInterface.add_prerequisite() for more information about prerequisites.

New in version 2.68.

classmethod peek(instance_class, iface_type)

Parameters:

• instance_class (GObject.TypeClass) – a GObject.TypeClass structure

• iface_type (GObject.GType) – an interface ID which this class conforms to

Returns:

the GObject.TypeInterface structure of iface_type if implemented by instance_class, None otherwise

Return type:

GObject.TypeInterface or None

Returns the GObject.TypeInterface structure of an interface to which the passed in class conforms.

classmethod prerequisites(interface_type)

Parameters:

interface_type (GObject.GType) – an interface type

Returns:

a newly-allocated zero-terminated array of GObject.GType containing the prerequisites of interface_type

Return type:

[GObject.GType]

Returns the prerequisites of an interfaces type.

New in version 2.2.

peek_parent()

Returns:

the corresponding GObject.TypeInterface structure of the parent type of the instance type to which self belongs, or None if the parent type doesn’t conform to the interface

Return type:

GObject.TypeInterface or None

Returns the corresponding GObject.TypeInterface structure of the parent type of the instance type to which self belongs.

This is useful when deriving the implementation of an interface from the parent type and then possibly overriding some methods.