gobject/org.gtkkn.bindings.gobject/BindingGroup

BindingGroup

open class BindingGroup(pointer: <Error class: unknown class><<Error class: unknown class>>) : Object, KGTyped

The #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 g_binding_group_set_source().

Skipped during bindings generation

method bind_full: g_binding_group_bind_full is shadowedBy bind_with_closures
method source: Property has no getter

Since

2.72

Constructors

BindingGroup

constructor()

Creates a new #GBindingGroup.

constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Companion

object Companion : TypeCompanion<BindingGroup>

Properties

gobjectBindingGroupPointer

val gobjectBindingGroupPointer: <Error class: unknown class><<Error class: unknown class>>

gPointer

val gPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

asType

inline fun <T : KGTyped> Object.asType(): T

Convert object into type T.

bind

open fun bind(sourceProperty: String, target: Object, targetProperty: String, 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 flag %G_BINDING_SYNC_CREATE is automatically specified.

bindFull

open fun bindFull(sourceProperty: String, target: Object, targetProperty: String, flags: BindingFlags, transformTo: Closure? = null, transformFrom: Closure? = null)

Creates a binding between @source_property on the source object and

bindProperty

open fun bindProperty(sourceProperty: String, target: Object, targetProperty: String, flags: BindingFlags): Binding

Creates a binding between @source_property on @source and @target_property on @target.

bindPropertyFull

open fun bindPropertyFull(sourceProperty: String, target: Object, targetProperty: String, flags: BindingFlags, transformTo: Closure, transformFrom: Closure): Binding

Creates a binding between @source_property on @source and @target_property on @target, allowing you to set the transformation functions to be used by the binding.

connectNotify

fun connectNotify(connectFlags: ConnectFlags = ConnectFlags(0u), handler: (pspec: ParamSpec) -> Unit): <Error class: unknown class>

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

dupSource

open fun dupSource(): Object?

Gets the source object used for binding properties.

forceFloating

open fun forceFloating()

This function is intended for #GObject implementations to re-enforce a floating-ref object reference. Doing this is seldom required: all #GInitiallyUnowneds are created with a floating reference which usually just needs to be sunken by calling g_object_ref_sink().

freezeNotify

open fun freezeNotify()

Increases the freeze count on @object. If the freeze count is non-zero, the emission of "notify" signals on @object is stopped. The signals are queued until the freeze count is decreased to zero. Duplicate notifications are squashed so that at most one #GObject::notify signal is emitted for each property modified while the object is frozen.

getBooleanProperty

fun Object.getBooleanProperty(propertyName: String): Boolean

getIntProperty

fun Object.getIntProperty(propertyName: String): Int

getProperty

open fun getProperty(propertyName: String, value: Value)

Gets a property of an object.

getStringProperty

fun Object.getStringProperty(propertyName: String): String?

isFloating

open fun isFloating(): Boolean

Checks whether @object has a floating-ref reference.

notify

open fun notify(propertyName: String)

Emits a "notify" signal for the property @property_name on @object.

notifyByPspec

open fun notifyByPspec(pspec: ParamSpec)

Emits a "notify" signal for the property specified by @pspec on @object.

ref

open fun ref(): Object

Increases the reference count of @object.

refSink

open fun refSink(): Object

Increase the reference count of @object, and possibly remove the floating-ref reference, if @object has a floating reference.

runDispose

open fun runDispose()

Releases all references to other objects. This can be used to break reference cycles.

setProperty

open fun setProperty(propertyName: String, value: Value)

Sets a property on an object.

setProperty

fun Object.setProperty(propertyName: String, value: Boolean)

fun Object.setProperty(propertyName: String, value: Int)

fun Object.setProperty(propertyName: String, value: String?)

setSource

open fun setSource(source: Object? = null)

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.

thawNotify

open fun thawNotify()

Reverts the effect of a previous call to g_object_freeze_notify(). The freeze count is decreased on @object and when it reaches zero, queued "notify" signals are emitted.

unref

open fun unref()

Decreases the reference count of @object. When its reference count drops to 0, the object is finalized (i.e. its memory is freed).

watchClosure

open fun watchClosure(closure: Closure)

This function essentially limits the life time of the @closure to the life time of the object. That is, when the object is finalized, the @closure is invalidated by calling g_closure_invalidate() on it, in order to prevent invocations of the closure with a finalized (nonexisting) object. Also, g_object_ref() and g_object_unref() are added as marshal guards to the @closure, to ensure that an extra reference count is held on @object during invocation of the