<?xml version="1.0" encoding="UTF-8"?>
<section>
    <sectioninfo>
        <keywordset>
            <keyword>rich:layoutPanel</keyword>
            <keyword>layoutPanel</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.LayoutPanel</entry>
                </row>
                <row>
                    <entry>component-class</entry>
                    <entry>org.richfaces.component.html.HtmlLayoutPanel</entry>
                </row>
                <row>
                    <entry>component-family</entry>
                    <entry>org.richfaces.LayoutPanel</entry>
                </row>
                <row>
                    <entry>renderer-type</entry>
                    <entry>org.richfaces.LayoutPanelRenderer</entry>
                </row>
                <row>
                    <entry>tag-class</entry>
                    <entry>org.richfaces.taglib.LayoutPanelTag</entry>
                </row>
                
            </tbody>
           
        </tgroup>
       
        
    </table>
    <section>
        <title>Creating the Component with a Page Tag</title>
        <para>To create the simplest variant on a page use the following syntax:</para>

        <para>
            <emphasis role="bold">Example:</emphasis>
        </para>
        <programlisting role="XML"><![CDATA[...
<rich:layout>
 <rich:layoutPanel position="center">
        <!--center-->
</rich:layoutPanel>     
</rich:layout>
...]]></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.HtmllayoutPanel;
...
HtmllayoutPanel mylayoutPanel = new HtmllayoutPanel();
...]]></programlisting>
    </section>
    <section>
        <title>Details of Usage</title>
        <para>The <emphasis role="bold">
                <property>&lt;rich:layoutPanel&gt;</property>
        </emphasis> component is  used to split the area inside the <emphasis role="bold"><property>&lt;rich:layout&gt;</property></emphasis> into  up to 5 parts: top, left, center, right, bottom.
            
        </para>
        <para>The <emphasis><property>&quot;position&quot;</property></emphasis> attribute defines the position of the <emphasis role="bold"><property>&lt;rich:layoutPanel&gt;</property></emphasis> in the area created with <emphasis role="bold"><property>&lt;rich:layout&gt;</property></emphasis> .</para>
<programlisting role="XML"><![CDATA[...
<rich:layout>
	<rich:layoutPanel position="top">
		<!--top-->
	</rich:layoutPanel>
	<rich:layoutPanel position="left">
		<!--left-->
	</rich:layoutPanel>
	<rich:layoutPanel position="center">
		<!--center-->
	</rich:layoutPanel>
	<rich:layoutPanel position="right">
		<!--right-->
	</rich:layoutPanel>
	<rich:layoutPanel position="bottom">
		<!--bottom-->
	</rich:layoutPanel>
</rich:layout>
...]]></programlisting>         
        
        <para>You can specify the width of the layout area with the <emphasis><property>&quot;width&quot;</property></emphasis>attribute.</para>
        
        
    </section>
    <section>
        <title>Relevant Resources Links</title>
        <para><ulink
                url="http://livedemo.exadel.com/richfaces-demo/richfaces/layouts.jsf"
                >On RichFaces Live Demo page </ulink> you can see an example of <emphasis role="bold">
                <property>&lt;rich:layoutPanel&gt;</property>
                </emphasis> usage and sources for the given example. </para>
        <para>The <link linkend="rich_layout"><emphasis role="bold"><property>&lt;rich:layout&gt;</property></emphasis></link> chapter of the guide.</para>
        <para>The <ulink url="http://www.jboss.org/community/docs/DOC-13336">Layout components for RichFaces 3.3.1</ulink> on  the JBoss.org Wiki.</para>
    </section>

</section>
