WidgetClass.bindTemplateChildFull

Automatically assign an object declared in the class template XML to be set to a location on a freshly built instance’s private data, or alternatively accessible via Widget.getTemplateChild.

The struct can point either into the public instance, then you should use G_STRUCT_OFFSET(WidgetType, member) for struct_offset, or in the private struct, then you should use G_PRIVATE_OFFSET(WidgetType, member).

An explicit strong reference will be held automatically for the duration of your instance’s life cycle, it will be released automatically when gobject.ObjectClass.ObjectClass.dispose|gobject.ObjectClass.dispose runs on your instance and if a struct_offset that is != 0 is specified, then the automatic location in your instance public or private data will be set to NULL. You can however access an automated child pointer the first time your classes gobject.ObjectClass.ObjectClass.dispose|gobject.ObjectClass.dispose runs, or alternatively in gtk.WidgetClass.WidgetClass.destroy|gtk.WidgetClass.destroy.

If internal_child is specified, GtkBuildableIface.get_internal_child|GtkBuildableIface.get_internal_child will be automatically implemented by the gtk.Widget class so there is no need to implement it manually.

The wrapper macros Widget.classBindTemplateChild, Widget.classBindTemplateChildInternal, Widget.classBindTemplateChildPrivate and Widget.classBindTemplateChildInternalPrivate might be more convenient to use.

Note that this must be called from a composite widget classes class initializer after calling Widget.classSetTemplate.

class WidgetClass
void
bindTemplateChildFull
(
string name
,,
ptrdiff_t structOffset
)

Parameters

name string

The “id” of the child defined in the template XML

internalChild bool

Whether the child should be accessible as an “internal-child” when this class is used in GtkBuilder XML

structOffset ptrdiff_t

The structure offset into the composite widget’s instance public or private structure where the automated child pointer should be set, or 0 to not assign the pointer.

Meta

Since

3.10