diff options
author | Johan Dahlin <jdahlin@async.com.br> | 2007-07-02 15:31:02 +0000 |
---|---|---|
committer | Johan Dahlin <johan@src.gnome.org> | 2007-07-02 15:31:02 +0000 |
commit | 18c26fee2d41842f5f4665ec55ba3303191f6a36 (patch) | |
tree | e3f365ae90e1677b266416926a7155c40fb96baa | |
parent | b863097016027b191945b48acfb229c2e8656f3a (diff) | |
download | gdk-pixbuf-18c26fee2d41842f5f4665ec55ba3303191f6a36.tar.gz |
Updates
2007-07-02 Johan Dahlin <jdahlin@async.com.br>
* gtk/tmpl/gtkbuilder.sgml: Updates
svn path=/trunk/; revision=18341
-rw-r--r-- | docs/reference/ChangeLog | 4 | ||||
-rw-r--r-- | docs/reference/gtk/tmpl/gtkbuilder.sgml | 30 |
2 files changed, 21 insertions, 13 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index cd456066a..6f235266e 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,7 @@ +2007-07-02 Johan Dahlin <jdahlin@async.com.br> + + * gtk/tmpl/gtkbuilder.sgml: Updates + 2007-07-01 Matthias Clasen <mclasen@redhat.com> * gtk/tmpl/gtkbuilder.sgml: Add more details diff --git a/docs/reference/gtk/tmpl/gtkbuilder.sgml b/docs/reference/gtk/tmpl/gtkbuilder.sgml index 5a4c75046..4e291fc67 100644 --- a/docs/reference/gtk/tmpl/gtkbuilder.sgml +++ b/docs/reference/gtk/tmpl/gtkbuilder.sgml @@ -64,6 +64,10 @@ which are more limited in scope. </para> <para> The toplevel element is <interface>. +It optionally takes a "domain" attribute, which will make +the builder look for translated strings using dgettext() in the +domain specified. This can also be done by calling +gtk_builder_set_translation_domain() on the builder. Objects are described by <object> elements, which can contain <property> elements to set properties, <signal> elements which connect signals to handlers, and <child> @@ -86,7 +90,7 @@ specifying the id of the #GtkUIManager in the "constructor" attribute and the name of the object in the "id" attribute. </para> <para> -Objects can be given a name with the "id" attribute, which +Objects must be given a name with the "id" attribute, which allows the application to retrieve them from the builder with gtk_builder_get_object(). An id is also necessary to use the object as property value in other parts of the UI definition. @@ -97,7 +101,7 @@ the <property> element: the "name" attribute specifies the name of the property, and the content of the element specifies the value. If the "translatable" attribute is set to a true value, GTK+ uses gettext() (or dgettext() if -the builder has a translation domain) to find a translation +the builder has a translation domain set) to find a translation for the value. This happens before the value is parsed, so it can be used for properties of any type, but it is probably most useful for string properties. @@ -108,12 +112,12 @@ common property types: characters, strings, integers, floating-point numbers, booleans (strings like "TRUE", "t", "yes", "y", "1" are interpreted as %TRUE, strings like "FALSE, "f", "no", "n", "0" are interpreted as %FALSE), enumerations (can be specified by their -name or nick), flags (can be specified by their name or nick, combined -with "|", e.g. "GTK_VISIBLE|GTK_REALIZED") and colors (in a format -understood by gdk_color_parse()). Objects can be referred to -by their name. GtkBuilder currently does not allow forward references -to objects — an object must be constructed before it can be used -as a property value. +name, nick or integer value), flags (can be specified by their name, +nick, integer value, optionally combined with "|", e.g. +"GTK_VISIBLE|GTK_REALIZED") and colors (in a format understood by +gdk_color_parse()). Objects can be referred to by their name. +GtkBuilder allows forward references to objects — an object +doesn't have to constructed before it can be used as a property value. </para> <para> Signal handlers are set up with the <signal> element. @@ -148,14 +152,14 @@ the sections describing the widget-specific portions of UI definitions. <interface> <object class="GtkDialog" id="dialog1"> <child internal-child="vbox"> - <object class="GtkVBox"> + <object class="GtkVBox" id="vbox1"> <property name="border-width">10</property> <child internal-child="action_area"> - <object class="GtkHButtonBox"> + <object class="GtkHButtonBox" id="hbuttonbox1"> <property name="border-width">20</property> - <child id="ok-button"> - <object class="GtkButton"/> - <property name="label">OK</property> + <child> + <object class="GtkButton" id="ok_button"> + <property name="label">gtk-ok</property> <property name="use-stock">TRUE</property> <signal name="clicked" handler="ok_button_clicked"/> </object> |