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

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

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

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.