AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2025-01-13 22:10:08 +00:00
Code Issues Projects Releases Wiki Activity

Improvements

Browse Source 
svn path=/trunk/; revision=18352
This commit is contained in:
Matthias Clasen 2007-07-03 15:38:53 +00:00
parent 9aefa08f09
commit d953125970
2 changed files with 26 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/reference/ChangeLog
View File

@ -1,3 +1,9 @@
2007-07-03 Matthias Clasen <mclasen@redhat.com>
* gtk/tmpl/gtkbuilder.sgml: Some wordsmithing
on the memory management explanation, asked for
by Murray Cumming.
2007-07-02 Matthias Clasen <mclasen@redhat.com> 2007-07-02 Matthias Clasen <mclasen@redhat.com>
* === Released 2.11.5 === * === Released 2.11.5 ===

31
docs/reference/gtk/tmpl/gtkbuilder.sgml
View File

@ -11,20 +11,29 @@ of a user interface and instantiates the described objects. To pass a
description to a GtkBuilder, call gtk_builder_add_from_file() or description to a GtkBuilder, call gtk_builder_add_from_file() or
gtk_builder_add_from_string(). These functions can be called multiple gtk_builder_add_from_string(). These functions can be called multiple
times; the builder merges the content of all descriptions. times; the builder merges the content of all descriptions.
The functions gtk_builder_get_object() and gtk_builder_get_objects()
can be used to access the widgets in the interface by the names assigned
to them inside the UI description. The function gtk_builder_connect_signals()
and variants thereof can be used to connect handlers to the named signals
in the description.
</para> </para>
<para> <para>
A GtkBuilder holds a reference to all objects that it has constructed A GtkBuilder holds a reference to all objects that it has constructed
and drops these references when it is finalized. To keep objects beyond and drops these references when it is finalized. This finalization can
the lifespan of the builder, they must be fetched with gtk_builder_get_object() cause the destruction of non-widget objects or widgets which are not
and reffed with g_object_ref(). It is the responsibility of the user contained in a toplevel window. For toplevel windows constructed by a
to destroy all toplevel windows that have been constructed by a builder builder, it is the responsibility of the user to call gtk_widget_destroy()
(these are not automatically cleaned up when the builder is finalized, to get rid of them and all the widgets they contain.
since GTK+ itself holds a reference to each toplevel window). </para>
<para>
The functions gtk_builder_get_object() and gtk_builder_get_objects()
can be used to access the widgets in the interface by the names assigned
to them inside the UI description. Toplevel windows returned by these
functions will stay around until the user explicitly destroys them
with gtk_widget_destroy(). Other widgets will either be part of a
larger hierarchy constructed by the builder (in which case you should
not have to worry about their lifecycle), or without a parent, in which
case they have to be added to some container to make use of them.
Non-widget objects need to be reffed with g_object_ref() to keep them
beyond the lifespan of the builder.
</para>
The function gtk_builder_connect_signals() and variants thereof can be
used to connect handlers to the named signals in the description.
</para> </para>
<refsect2 id="BUILDER-UI"><title>GtkBuilder UI Definitions</title> <refsect2 id="BUILDER-UI"><title>GtkBuilder UI Definitions</title>