GObject.BindingGroup¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`new` ()
	`bind` (source_property, target, target_property, flags)
	`bind_full` (source_property, target, target_property, flags, transform_to, transform_from)
	`dup_source` ()
	`set_source` (source)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`source`	`GObject.Object`	r/w/en	The source `GObject.Object` used for binding properties.

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Class Details¶

class GObject.BindingGroup(**kwargs)¶

Bases:: GObject.Object
Abstract:: No

The GObject.BindingGroup can be used to bind multiple properties from an object collectively.

Use the various methods to bind properties from a single source object to multiple destination objects. Properties can be bound bidirectionally and are connected when the source object is set with GObject.BindingGroup.set_source().

New in version 2.72.

classmethod new()¶

Returns:: a new GObject.BindingGroup
Return type:: GObject.BindingGroup

Creates a new GObject.BindingGroup.

New in version 2.72.

bind(source_property, target, target_property, flags)¶

Parameters:

source_property (str) – the property on the source to bind
target (GObject.Object) – the target GObject.Object
target_property (str) – the property on target to bind
flags (GObject.BindingFlags) – the flags used to create the GObject.Binding

Creates a binding between source_property on the source object and target_property on target. Whenever the source_property is changed the target_property is updated using the same value. The binding flag GObject.BindingFlags.SYNC_CREATE is automatically specified.

See GObject.Object.bind_property() for more information.

New in version 2.72.

bind_full(source_property, target, target_property, flags, transform_to, transform_from)¶

Parameters:

source_property (str) – the property on the source to bind
target (GObject.Object) – the target GObject.Object
target_property (str) – the property on target to bind
flags (GObject.BindingFlags) – the flags used to create the GObject.Binding
transform_to (GObject.Closure or None) – a GObject.Closure wrapping the transformation function from the source object to the target, or None to use the default
transform_from (GObject.Closure or None) – a GObject.Closure wrapping the transformation function from the target to the source object, or None to use the default

Creates a binding between source_property on the source object and target_property on target, allowing you to set the transformation functions to be used by the binding. The binding flag GObject.BindingFlags.SYNC_CREATE is automatically specified.

This function is the language bindings friendly version of g_binding_group_bind_property_full(), using GObject.Closures instead of function pointers.

See GObject.Object.bind_property_full() for more information.

New in version 2.72.

dup_source()¶

Returns:: a GObject.Object or None.
Return type:: GObject.Object or None

Gets the source object used for binding properties.

New in version 2.72.

set_source(source)¶

Parameters:: source (GObject.Object or None) – the source GObject.Object, or None to clear it

Sets source as the source object used for creating property bindings. If there is already a source object all bindings from it will be removed.

Note that all properties that have been bound must exist on source.

New in version 2.72.

Property Details¶

GObject.BindingGroup.props.source¶

Name:: source
Type:: GObject.Object
Default Value:: None
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

The source object used for binding properties.

New in version 2.72.