GObject.BindingGroup

g GObject.BindingGroup GObject.BindingGroup GObject.Object GObject.Object GObject.Object->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

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Class Details

class GObject.BindingGroup(**kwargs)
Bases:

GObject.Object

Abstract:

No

GBindingGroup 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 [method`GObject`.BindingGroup.set_source].

New in version 2.72.

classmethod new()[source]
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)[source]
Parameters:

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)[source]
Parameters:

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()[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)[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.