[richfaces-svn-commits] JBoss Rich Faces SVN: r8357 - trunk/docs/faq/en/src/main/docbook/module.

Author: artdaw Date: 2008-04-30 06:27:47 -0400 (Wed, 30 Apr 2008) New Revision: 8357 Modified: trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml Log: http://jira.jboss.com/jira/browse/RF-3042 - info about optional object selection was added into FAQ Modified: trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml =================================================================== --- trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml 2008-04-30 10:08:50 UTC (rev 8356) +++ trunk/docs/faq/en/src/main/docbook/module/RFCfaq.xml 2008-04-30 10:27:47 UTC (rev 8357) @@ -2313,4 +2313,33 @@ </filter> ...]]></programlisting> </section> + <section id="suggestionboxObjectSelection"> + <?dbhtml filename="suggestionboxObjectSelection.html"?> + <title>Optional object selection in &lt;rich:suggestionbox&gt;</title> + <para> + The <emphasis role="bold"><property>&lt;rich:suggestionbox&gt;</property></emphasis> component provides such feature as + object selection. In order to store selected items as objects and then get access to them you could use next scenario: + </para> + <itemizedlist> + <listitem> + <para> + Add <emphasis><property>&quot;usingSuggestObjects&quot;</property></emphasis> attribute with &quot;true&quot; value to + <emphasis role="bold"><property>&lt;rich:suggestionbox&gt;</property></emphasis> + </para> + </listitem> + <listitem> + <para> + Use <emphasis><property>&quot;onobjectchanged&quot;</property></emphasis> event attribute + to store objects currently selected + </para> + </listitem> + <listitem> + <para> + All selected objects are stored under <property>suggestion.SelectedItems</property> array. + Each array element contains of <property>text</property> and <property>object</property> properties. + So, you could iterate this array, get <property>not null objects</property> and then get the property you need. + </para> + </listitem> + </itemizedlist> + </section> </chapter>