Struct dazzle::BindingGroup

pub struct BindingGroup { /* private fields */ }

BindingGroup manages to simplify the process of binding many properties from a [glib::Object][crate::glib::Object] as a group. As such there is no API to unbind a property from the group.

In particular, this allows you to change the source instance for the bindings. This automatically causes the unbinding of the properties from the old instance and binding to the new instance.

This should not be confused with GtkBindingGroup.

Properties

source

The source object used for binding properties.

Readable | Writeable

Implements

glib::ObjectExt

Implementations

impl BindingGroup

pub fn new() -> BindingGroup

Creates a new BindingGroup.

Returns

a new BindingGroup

pub fn bind( &self, source_property: &str, target: &impl IsA<Object>, target_property: &str, flags: BindingFlags )

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 flags [glib::BindingFlags::SYNC_CREATE][crate::glib::BindingFlags::SYNC_CREATE] is automatically specified.

See: [ObjectExt::bind_property()][crate::glib::prelude::ObjectExt::bind_property()].

source_property

the property on the source to bind

target

the target [glib::Object][crate::glib::Object]

target_property

the property on target to bind

flags

the flags used to create the [glib::Binding][crate::glib::Binding]

pub fn bind_with_closures( &self, source_property: &str, target: &impl IsA<Object>, target_property: &str, flags: BindingFlags, transform_to: Option<&Closure>, transform_from: Option<&Closure> )

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 flags [glib::BindingFlags::SYNC_CREATE][crate::glib::BindingFlags::SYNC_CREATE] is automatically specified.

This function is the language bindings friendly version of dzl_binding_group_bind_property_full(), using GClosures instead of function pointers.

See: [ObjectExt::bind_property_with_closures()][crate::glib::prelude::ObjectExt::bind_property_with_closures()].

source_property

the property on the source to bind

target

the target [glib::Object][crate::glib::Object]

target_property

the property on target to bind

flags

the flags used to create the [glib::Binding][crate::glib::Binding]

transform_to

a [glib::Closure][crate::glib::Closure] wrapping the transformation function from the source object to the target, or None to use the default

transform_from

a [glib::Closure][crate::glib::Closure] wrapping the transformation function from the target to the source object, or None to use the default

pub fn source(&self) -> Option<Object>

Gets the source object used for binding properties.

Returns

the source object.

pub fn set_source(&self, source: Option<&impl IsA<Object>>)

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: All properties that have been bound must exist on source.

source

the source [glib::Object][crate::glib::Object]

pub fn connect_source_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

Trait Implementations

impl Clone for BindingGroup

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BindingGroup

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BindingGroup

fn default() -> Self

Returns the “default value” for a type.

impl Display for BindingGroup

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for BindingGroup

type ParamSpec = ParamSpecObject

type SetValue = BindingGroup

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, BindingGroup>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for BindingGroup

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for BindingGroup

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl ParentClassIs for BindingGroup

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for BindingGroup

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for BindingGroup

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for BindingGroup

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for BindingGroup