Author: SeanRogers
Date: 2010-12-06 21:12:48 -0500 (Mon, 06 Dec 2010)
New Revision: 20424
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richtoolbarGroup-richtoolbarGroup.xml_sample
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richtoolbarGroup-richtoolbarGroup.png
Modified:
modules/docs/trunk/Component_Development_Kit_Guide/src/main/docbook/en-US/Component_Development_Kit_Guide.xml
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml
Log:
Added rich:toolbarGroup
Modified:
modules/docs/trunk/Component_Development_Kit_Guide/src/main/docbook/en-US/Component_Development_Kit_Guide.xml
===================================================================
---
modules/docs/trunk/Component_Development_Kit_Guide/src/main/docbook/en-US/Component_Development_Kit_Guide.xml 2010-12-06
20:34:27 UTC (rev 20423)
+++
modules/docs/trunk/Component_Development_Kit_Guide/src/main/docbook/en-US/Component_Development_Kit_Guide.xml 2010-12-07
02:12:48 UTC (rev 20424)
@@ -13,6 +13,6 @@
<xi:include href="Creating_components_in_other_environments.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
<xi:include href="Naming_conventions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
<xi:include href="Template_tags_reference.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="Revision_History.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <!--<xi:include href="Revision_History.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
</book>
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml
===================================================================
---
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml 2010-12-06
20:34:27 UTC (rev 20423)
+++
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Menus_and_toolbars.xml 2010-12-07
02:12:48 UTC (rev 20424)
@@ -387,6 +387,40 @@
The <sgmltag><rich:toolbarGroup></sgmltag> component is a
child component of the <sgmltag><rich:toolbar></sgmltag>
component. The <sgmltag><rich:toolbarGroup></sgmltag> component
is used to group a number of items together on a toolbar.
</para>
+ <section id="sect-Component_Reference-richtoolbarGroup-Basic_usage">
+ <title>Basic usage</title>
+ <para>
+ Like the <sgmltag><rich:toolbar></sgmltag> parent
component, the <sgmltag><rich:toolbarGroup></sgmltag> component
does not require any extra attributes for basic functionality. Add child components to the
<sgmltag><rich:toolbarGroup></sgmltag> component to have them
appear grouped on the parent toolbar when rendered.
+ </para>
+ </section>
+
+ <section id="sect-Component_Reference-richtoolbarGroup-Appearance">
+ <title>Appearance</title>
+ <para>
+ Similar to the <sgmltag><rich:toolbar></sgmltag>
component, items within a <sgmltag><rich:toolbarGroup></sgmltag>
can be separated by specifying the <varname>itemSeparator</varname> attribute.
Refer to <xref linkend="sect-Component_Reference-richtoolbar-Appearance"
/> for details on using the <varname>itemSeparator</varname> attribute.
+ </para>
+ <para>
+ Groups of toolbar items can be located on either the left-hand side or the
right-hand side of the parent toolbar. By default, they appear to the left. To locate the
toolbar group to the right of the parent toolbar, set
<code>location="right"</code>.
+ </para>
+ <example
id="exam-Component_Reference-richtoolbarGroup-richtoolbarGroup">
+ <title><sgmltag><rich:toolbarGroup></sgmltag></title>
+ <programlisting language="XML" role="XML"><xi:include
parse="text"
href="extras/exam-Component_Reference-richtoolbarGroup-richtoolbarGroup.xml_sample"
xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting>
+ <para>
+ The example shows how to locate a toolbar group to the right-hand side of the
parent toolbar. It also demonstrates how item separators on the parent toolbar work with
toolbar groups.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Component_Reference-richtoolbarGroup-richtoolbarGroup.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <para>
+ A toolbar using icons. Two toolbar groups are located on the left-hand side of
the toolbar and separated by a grid pattern. The third toolbar group is located to the
right-hand side.
+ </para>
+ </textobject>
+ </mediaobject>
+ </example>
+ </section>
+
<section
id="sect-Component_Reference-richtoolbarGroup-Reference_data">
<title>Reference data</title>
<itemizedlist>
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richtoolbarGroup-richtoolbarGroup.xml_sample
===================================================================
---
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richtoolbarGroup-richtoolbarGroup.xml_sample
(rev 0)
+++
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richtoolbarGroup-richtoolbarGroup.xml_sample 2010-12-07
02:12:48 UTC (rev 20424)
@@ -0,0 +1,16 @@
+<rich:toolBar height="26" itemSeparator="grid">
+ <rich:toolBarGroup>
+ <h:graphicImage value="/images/icons/create_doc.gif"/>
+ <h:graphicImage value="/images/icons/create_folder.gif"/>
+ <h:graphicImage value="/images/icons/copy.gif"/>
+ </rich:toolBarGroup>
+ <rich:toolBarGroup>
+ <h:graphicImage value="/images/icons/save.gif"/>
+ <h:graphicImage value="/images/icons/save_as.gif"/>
+ <h:graphicImage value="/images/icons/save_all.gif"/>
+ </rich:toolBarGroup>
+ <rich:toolBarGroup location="right">
+ <h:graphicImage value="/images/icons/find.gif"/>
+ <h:graphicImage value="/images/icons/filter.gif"/>
+ </rich:toolBarGroup>
+</rich:toolBar>
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richtoolbarGroup-richtoolbarGroup.png
===================================================================
(Binary files differ)
Property changes on:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richtoolbarGroup-richtoolbarGroup.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream