[richfaces-svn-commits] JBoss Rich Faces SVN: r5307 - trunk/docs/userguide/en/src/main/docbook/included.

[richfaces-svn-commits at lists.jboss.org]

Author: artdaw
Date: 2008-01-11 10:45:12 -0500 (Fri, 11 Jan 2008)
New Revision: 5307

Added:
   trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml
Log:
http://jira.jboss.com/jira/browse/RF-1702 - add Component identification parameters, Creating the Component with a Page Tag, Creating the Component Dynamically Using Java

Added: trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml	                        (rev 0)
+++ trunk/docs/userguide/en/src/main/docbook/included/comboBox.xml	2008-01-11 15:45:12 UTC (rev 5307)
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<section>
+    <sectioninfo>
+        <keywordset>
+            <keyword>rich:comboBox</keyword>
+            <keyword>comboBox</keyword>
+        </keywordset>
+    </sectioninfo>
+    <table>
+        <title>Component identification parameters</title>
+        
+        <tgroup cols="2">
+            <thead>
+                <row>
+                    <entry>Name</entry>
+                    
+                    <entry>Value</entry>
+                </row>
+            </thead>
+            <tbody>
+                <row>
+                    <entry>component-type</entry>
+                    <entry>org.richfaces.ComboBox</entry>
+                </row>
+                <row>
+                    <entry>component-class</entry>
+                    <entry>org.richfaces.component.html.HtmlComboBox</entry>
+                </row>
+                <row>
+                    <entry>component-family</entry>
+                    <entry>org.richfaces.ComboBox</entry>
+                </row>
+                <row>
+                    <entry>renderer-type</entry>
+                    <entry>org.richfaces.renderkit.ComboBoxRenderer</entry>
+                </row>
+                <!--row>
+                    <entry>tag-class</entry>
+                    <entry></entry>
+                </row-->
+            </tbody>
+        </tgroup>
+    </table>
+    <section>
+        <title>Creating the Component with a Page Tag</title>
+        <para>Here is a simple example as it could be used on a page: </para>
+        
+        <para>
+            <emphasis role="bold">Example:</emphasis>
+        </para>
+        <programlisting role="XML"><![CDATA[...
+<rich:comboBox value="#{bean.state}" valueChangeListener="#{bean.selectionChanged}"  suggestionValues="#{bean.suggestions}">
+        <f:selectItems  value="#{bean.selectItems}"/>
+<rich:comboBox>
+...]]></programlisting>
+    </section>
+    <section>
+        <title>Creating the Component Dynamically Using Java</title>
+        <para>
+            <emphasis role="bold">Example:</emphasis>
+        </para>
+        <programlisting role="JAVA"><![CDATA[import org.richfaces.component.html.HtmlComboBox;
+...	
+HtmlComboBox myComboBox = new HtmlComboBox();
+...]]></programlisting>
+    </section>
+</section>
\ No newline at end of file