#include <gtkbuildable.h>

Data Fields
GTypeInterface	g_iface

void(*	set_id )(GtkBuildable buildable, const char id)

const char (	get_id )(GtkBuildable *buildable)

void(*	add_child )(GtkBuildable buildable, GtkBuilder builder, GObject child, const char type)

void(*	set_buildable_property )(GtkBuildable buildable, GtkBuilder builder, const char name, const GValue value)

GObject (	construct_child )(GtkBuildable buildable, GtkBuilder builder, const char *name)

gboolean(*	custom_tag_start )(GtkBuildable buildable, GtkBuilder builder, GObject child, const char tagname, GtkBuildableParser parser, gpointer data)

void(*	custom_tag_end )(GtkBuildable buildable, GtkBuilder builder, GObject child, const char tagname, gpointer data)

void(*	custom_finished )(GtkBuildable buildable, GtkBuilder builder, GObject child, const char tagname, gpointer data)

void(*	parser_finished )(GtkBuildable buildable, GtkBuilder builder)

GObject (	get_internal_child )(GtkBuildable buildable, GtkBuilder builder, const char *childname)

Detailed Description

GtkBuildableIface: @g_iface: the parent class @set_id: Stores the id attribute given in the GtkBuilder UI definition. GtkWidget stores the name as object data. Implement this method if your object has some notion of “ID” and it makes sense to map the XML id attribute to it. @get_id: The getter corresponding to @set_id. Implement this if you implement @set_id. @add_child: Adds a child. The @type parameter can be used to differentiate the kind of child. GtkWidget implements this to add event controllers to the widget, GtkNotebook uses the @type to distinguish between page labels (of type "page-label") and normal children. @set_buildable_property: Sets a property of a buildable object. It is normally not necessary to implement this, g_object_set_property() is used by default. GtkWindow implements this to delay showing itself (i.e. setting the [prope.nosp@m.rty@.nosp@m.Gtk.W.nosp@m.idge.nosp@m.t:visible] property) until the whole interface is created. @construct_child: Constructs a child of a buildable that has been specified as “constructor” in the UI definition. This can be used to reference a widget created in a <ui> tag which is outside of the normal GtkBuilder UI definition hierarchy. A reference to the constructed object is returned and becomes owned by the caller. @custom_tag_start: Implement this if the buildable needs to parse content below <child>. To handle an element, the implementation must fill in the @parser and @user_data and return TRUE. GtkWidget implements this to parse accessible attributes specified in <accessibility> elements. Note that @user_data must be freed in @custom_tag_end or @custom_finished. @custom_tag_end: Called for the end tag of each custom element that is handled by the buildable (see @custom_tag_start). @custom_finished: Called for each custom tag handled by the buildable when the builder finishes parsing (see @custom_tag_start) @parser_finished: Called when a builder finishes the parsing of a UI definition. It is normally not necessary to implement this, unless you need to perform special cleanup actions. GtkWindow sets the GtkWidget:visible property here. @get_internal_child: Returns an internal child of a buildable. GtkDialog implements this to give access to its @vbox, making it possible to add children to the vbox in a UI definition. Implement this if the buildable has internal children that may need to be accessed from a UI definition.

The GtkBuildableIface interface contains methods that are necessary to allow GtkBuilder to construct an object from a GtkBuilder UI definition.

Definition at line 138 of file gtkbuildable.h.

Field Documentation

◆ add_child

void(* _GtkBuildableIface::add_child) (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *type)

GtkBuildableIface::add_child: @buildable: a GtkBuildable @builder: a GtkBuilder @child: child to add @type: (nullable): kind of child or NULL

Adds a child to @buildable. @type is an optional string describing how the child should be added.

Definition at line 157 of file gtkbuildable.h.

◆ construct_child

GObject *(* _GtkBuildableIface::construct_child) (GtkBuildable *buildable, GtkBuilder *builder, const char *name)

Definition at line 165 of file gtkbuildable.h.

◆ custom_finished

void(* _GtkBuildableIface::custom_finished) (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *tagname, gpointer data)

GtkBuildableIface::custom_finished: @buildable: a GtkBuildable @builder: a GtkBuilder @child: (nullable): child object or NULL for non-child tags @tagname: the name of the tag @data: user data created in custom_tag_start

Similar to gtk_buildable_parser_finished() but is called once for each custom tag handled by the @buildable.

Definition at line 217 of file gtkbuildable.h.

◆ custom_tag_end

void(* _GtkBuildableIface::custom_tag_end) (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *tagname, gpointer data)

GtkBuildableIface::custom_tag_end: @buildable: A GtkBuildable @builder: GtkBuilder used to construct this object @child: (nullable): child object or NULL for non-child tags @tagname: name of tag @data: user data that will be passed in to parser functions

Called at the end of each custom element handled by the buildable.

Definition at line 201 of file gtkbuildable.h.

◆ custom_tag_start

gboolean(* _GtkBuildableIface::custom_tag_start) (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const char *tagname, GtkBuildableParser *parser, gpointer *data)

GtkBuildableIface::custom_tag_start: @buildable: a GtkBuildable @builder: a GtkBuilder used to construct this object @child: (nullable): child object or NULL for non-child tags @tagname: name of tag @parser: (out): a GtkBuildableParser to fill in @data: (out): return location for user data that will be passed in to parser functions

Called for each unknown element under <child>.

Returns: TRUE if an object has a custom implementation, FALSE if it doesn't.

Definition at line 184 of file gtkbuildable.h.

◆ g_iface

GTypeInterface _GtkBuildableIface::g_iface

Definition at line 140 of file gtkbuildable.h.

◆ get_id

const char *(* _GtkBuildableIface::get_id) (GtkBuildable *buildable)

Definition at line 145 of file gtkbuildable.h.

◆ get_internal_child

GObject *(* _GtkBuildableIface::get_internal_child) (GtkBuildable *buildable, GtkBuilder *builder, const char *childname)

GtkBuildableIface::get_internal_child: @buildable: a GtkBuildable @builder: a GtkBuilder @childname: name of child

Retrieves the internal child called @childname of the @buildable object.

Returns: (transfer none): the internal child of the buildable object

Definition at line 235 of file gtkbuildable.h.

◆ parser_finished

void(* _GtkBuildableIface::parser_finished) (GtkBuildable *buildable, GtkBuilder *builder)

Definition at line 222 of file gtkbuildable.h.

◆ set_buildable_property

void(* _GtkBuildableIface::set_buildable_property) (GtkBuildable *buildable, GtkBuilder *builder, const char *name, const GValue *value)

Definition at line 161 of file gtkbuildable.h.

◆ set_id

void(* _GtkBuildableIface::set_id) (GtkBuildable *buildable, const char *id)

Definition at line 143 of file gtkbuildable.h.

The documentation for this struct was generated from the following file:

gtkbuildable.h

Data Fields