Author: artdaw Date: 2008-04-14 09:02:31 -0400 (Mon, 14 Apr 2008) New Revision: 7794 Modified: trunk/docs/userguide/en/src/main/docbook/included/inplaceSelect.xml Log: http://jira.jboss.com/jira/browse/RF-1226 - inplaceSelect screenshots were added Modified: trunk/docs/userguide/en/src/main/docbook/included/inplaceSelect.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/inplaceSelect.xml 2008-04-14 12:13:24 UTC (rev 7793) +++ trunk/docs/userguide/en/src/main/docbook/included/inplaceSelect.xml 2008-04-14 13:02:31 UTC (rev 7794) @@ -139,7 +139,7 @@ <title>Changed state</title> <mediaobject> <imageobject> - <imagedata fileref="images/inplaceSelectCh1.png"/> + <imagedata fileref="images/inplaceSelectCh1.png"/> </imageobject> </mediaobject> </figure> @@ -224,7 +224,23 @@ The <emphasis><property>&quot;selectOnEdit&quot;</property></emphasis> (with possible values &quot;true&quot;, &quot;false&quot;) gives you an option to make the text in the input field selected right after the change from <property>view</property> state to <property>edit</property> occurs. </para> + <programlisting role="XML"><![CDATA[... +<rich:inplaceSelect value="#{bean.inputValue}" selectOnEdit="true"> + <f:selectItems value="#{bean.selectItems}"/> +</rich:inplaceSelect> +...]]></programlisting> <para> + This is the result: + </para> + <figure> + <title>The <emphasis><property>&quot;selectOnEdit&quot;</property></emphasis> attribute usage</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/inplaceSelectSoE.png"/> + </imageobject> + </mediaobject> + </figure> + <para> Another useful attribute is <emphasis><property>&quot;openOnEdit&quot;</property></emphasis>. With &quot;true&quot; value it defines that the drop-down list with items opens automatically after <property>edit</property> state is activated. </para> @@ -241,8 +257,18 @@ <f:selectItems value="#{bean.selectItems}"/> </rich:inplaceSelect> ...]]></programlisting> + <para> + This is the result: + </para> + <figure> + <title>The <emphasis><property>&quot;showControls&quot;</property></emphasis> attribute usage</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/inplaceSelectSC.png"/> + </imageobject> + </mediaobject> + </figure> - <para> You can also position the controls relatively to the input field, by means of </para> @@ -264,12 +290,22 @@ <emphasis role="bold">Example:</emphasis> </para> <programlisting role="XML"><![CDATA[... -<rich:inplaceSelect value="#{bean.inputValue}" controlsHorizontalPosition="left" controlsVerticalPosition="bottom" showControls="true"> +<rich:inplaceSelect value="#{bean.inputValue}" controlsHorizontalPosition="left" controlsVerticalPosition="center" showControls="true"> <f:selectItems value="#{bean.selectItems}"/> </rich:inplaceSelect> ...]]> </programlisting> + <para> + This is the result: + </para> + <figure> + <title>Controls positioning</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/inplaceSelectCentLeft.png"/> + </imageobject> + </mediaobject> + </figure> - <para>It is also possible to use <emphasis><property>&quot;controls&quot;</property></emphasis> facet in order to replace the default controls with facets content. See the example below. </para> @@ -278,7 +314,7 @@ <emphasis role="bold">Example:</emphasis> </para> <programlisting role="XML"><![CDATA[... -<rich:inplaceSelect value="#{bean.inputValue}" showControls="true" controlsHorizontalPosition="left" controlsVerticalPosition="bottom"> +<rich:inplaceSelect value="#{bean.inputValue}" showControls="true"> <f:facet name="controls"> <button onclick="#{rich:component('inplaceSelect')}.save();" type="button">Save</button> <button onclick="#{rich:component('inplaceSelect')}.cancel();" type="button">Cancel</button> @@ -286,7 +322,17 @@ <f:selectItems value="#{bean.selectItems}"/> </rich:inplaceSelect> ...]]> </programlisting> - + <para> + This is the result: + </para> + <figure> + <title><emphasis><property>&quot;controls&quot;</property></emphasis> facet usage</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/inplaceSelectFct.png"/> + </imageobject> + </mediaobject> + </figure> <note> <title>Note:</title> <para>