GtkBuilder types (Re: GtkBuilder Public API - Last call)

[Tim Janik <timj gtk org>]

On Tue, 12 Jun 2007, Johan Dahlin wrote:

> Hi,
>
> During the Gtk+ developer meeting today it was decided that there will be a
> final GtkBuilder discussion before it gets committed to trunk.
> The current plan is that there will be a new developer release in the end of
> the week, most likely on friday and that GtkBuilder is going to be included
> in that release.
>
> I'd like this discussion to be focus on the Public API. I've included the
> two new public headers (gtkbuilder.h and gtkbuildable.h) with the API
> documentation embedded.
> Suggestions and questions about the documentation are also welcome, but
> remember that the documentation is still very much open for changes during
> the next couple of weeks, before the final release of 2.12.
>
> I've also attached a .glade file which demonstrates some of the new
> capabilities.
>
> gtkbuilder.h
> ============
>
> GtkBuilder is a replacement for the GladeXML found in the libglade library.
> It is responsible for parsing a GtkBuilder UI definition and constructing
> the object tree from that definition, usually a user interface.
>
> This is the API which applications are going to use.
>
> typedef enum
> {
>  GTK_BUILDER_ERROR_INVALID_TYPE_FUNCTION,
>  GTK_BUILDER_ERROR_UNHANDLED_TAG,
>  GTK_BUILDER_ERROR_MISSING_ATTRIUTE,
>  GTK_BUILDER_ERROR_INVALID_ATTRIBUTE,
>  GTK_BUILDER_ERROR_INVALID_TAG
> } GtkBuilderError;
>
> struct _GtkBuilder
> {
>  GObject parent;

"parent" is a bad name for a nested instance structure, GtkWidget->parent is
the best example for this. better use something like parent_instance here,
people are never supposed to access this member directly anyway (we have our
casting macros for getting at the parent types).

>  GtkBuilderPrivate *priv;
> };


> /**
> * gtk_builder_get_type_from_name:
> * @builder: a #GtkBuilder
> * @typename: Type name to lookup.
> *
> * This method is used to lookup a type. It can be implemented in a subclass to
> * override the #GType of an object created by the builder.
> *
> * Since 2.12
> */
> GType        gtk_builder_get_type_from_name      (GtkBuilder   *builder,
>                                                  const char   *typename);

how is this different from g_type_from_name() ?

> --
> Johan Dahlin <jdahlin async com br>

---
ciaoTJ