Method

GtkExpressionbind

Declaration [src]

GtkExpressionWatch*
gtk_expression_bind (
  GtkExpression* self,
  GObject* target,
  const char* property,
  GObject* this_
)

Description [src]

Bind targets property named property to self.

The value that self evaluates to is set via g_object_set() on target. This is repeated whenever self changes to ensure that the object’s property stays synchronized with self.

If selfs evaluation fails, targets property is not updated. Use a GtkTryExpression to provide a fallback for this case.

Note that this function takes ownership of self. If you want to keep it around, you should gtk_expression_ref() it beforehand.

Parameters

self

Type: GtkExpression

A GtkExpression.

The instance takes ownership of the data, and is responsible for freeing it.
target

Type: GObject

The target object to bind to.

The data is owned by the caller of the method.
property

Type: const char*

Name of the property on target to bind to.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
this_

Type: GObject

The this argument for the evaluation of self.

The argument can be NULL.
The data is owned by the caller of the method.

Return value

Type: GtkExpressionWatch

A GtkExpressionWatch.

The returned data is owned by the instance.