summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2005-02-08 15:54:09 +0000
committerMatthias Clasen <matthiasc@src.gnome.org>2005-02-08 15:54:09 +0000
commitda920e08f8aa9540fbfb5693121dcbe14f607169 (patch)
treeeb2f56d92fbda8c52229ec63f2fef79a94174c09 /docs
parent4c1cab8dff511c795e382e9ac7afaf4272c36486 (diff)
downloadgtk+-da920e08f8aa9540fbfb5693121dcbe14f607169.tar.gz
Accept the "expand" attribute and set a flag in the node if it is set to
2005-02-08 Matthias Clasen <mclasen@redhat.com> * gtk/gtkuimanager.c (start_element_handler): Accept the "expand" attribute and set a flag in the node if it is set to "true". (update_node): If the expand flag is set, make separator toolitems non-drawn and expanding. (#166489, Christian Persch)
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/ChangeLog5
-rw-r--r--docs/reference/gtk/tmpl/gtkuimanager.sgml49
2 files changed, 33 insertions, 21 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 56308930ca..ae018f88f7 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2005-02-08 Matthias Clasen <mclasen@redhat.com>
+
+ * gtk/tmpl/gtkuimanager.sgml: Mention the expanding
+ toolbar separators.
+
2005-02-03 Matthias Clasen <mclasen@redhat.com>
* gtk/gtk-sections.txt: Add gtk_stock_set_translate_func.
diff --git a/docs/reference/gtk/tmpl/gtkuimanager.sgml b/docs/reference/gtk/tmpl/gtkuimanager.sgml
index 9f82abf6d9..cda5c00fba 100644
--- a/docs/reference/gtk/tmpl/gtkuimanager.sgml
+++ b/docs/reference/gtk/tmpl/gtkuimanager.sgml
@@ -25,27 +25,28 @@ roughly described by the following DTD.
&lt;!ELEMENT toolitem EMPTY &gt;
&lt;!ELEMENT separator EMPTY &gt;
&lt;!ELEMENT accelerator EMPTY &gt;
-&lt;!ATTLIST menubar name &num;IMPLIED
- action &num;IMPLIED &gt;
-&lt;!ATTLIST toolbar name &num;IMPLIED
- action &num;IMPLIED &gt;
-&lt;!ATTLIST popup name &num;IMPLIED
- action &num;IMPLIED &gt;
-&lt;!ATTLIST placeholder name &num;IMPLIED
- action &num;IMPLIED &gt;
-&lt;!ATTLIST separator name &num;IMPLIED
- action &num;IMPLIED &gt;
-&lt;!ATTLIST menu name &num;IMPLIED
- action &num;REQUIRED
- position (top|bot) &num;IMPLIED &gt;
-&lt;!ATTLIST menuitem name &num;IMPLIED
- action &num;REQUIRED
- position (top|bot) &num;IMPLIED &gt;
-&lt;!ATTLIST toolitem name &num;IMPLIED
- action &num;REQUIRED
- position (top|bot) &num;IMPLIED &gt;
-&lt;!ATTLIST accelerator name &num;IMPLIED
- action &num;REQUIRED &gt;
+&lt;!ATTLIST menubar name &num;IMPLIED
+ action &num;IMPLIED &gt;
+&lt;!ATTLIST toolbar name &num;IMPLIED
+ action &num;IMPLIED &gt;
+&lt;!ATTLIST popup name &num;IMPLIED
+ action &num;IMPLIED &gt;
+&lt;!ATTLIST placeholder name &num;IMPLIED
+ action &num;IMPLIED &gt;
+&lt;!ATTLIST separator name &num;IMPLIED
+ action &num;IMPLIED
+ expand (true|false) &num;IMPLIED &gt;
+&lt;!ATTLIST menu name &num;IMPLIED
+ action &num;REQUIRED
+ position (top|bot) &num;IMPLIED &gt;
+&lt;!ATTLIST menuitem name &num;IMPLIED
+ action &num;REQUIRED
+ position (top|bot) &num;IMPLIED &gt;
+&lt;!ATTLIST toolitem name &num;IMPLIED
+ action &num;REQUIRED
+ position (top|bot) &num;IMPLIED &gt;
+&lt;!ATTLIST accelerator name &num;IMPLIED
+ action &num;REQUIRED &gt;
</programlisting>
There are some additional restrictions beyond those specified in the
DTD, e.g. every toolitem must have a toolbar in its anchestry and
@@ -166,6 +167,12 @@ is a useful feature, since the merging of UI elements from multiple sources
can make it hard or impossible to determine in advance whether a separator
will end up in such an unfortunate position.
</para>
+
+<para>
+For separators in toolbars, you can set <literal>expand="true"</literal> to
+turn them from a small, visible separator to an expanding, invisible one.
+Toolitems following an expanding separator are effectively right-aligned.
+</para>
</refsect2>
<refsect2>
<title>Empty Menus</title>