<section role="NotInToc" id="rich_dropListener">
   <title>
				&lt;
				rich:dropListener
				&gt;
				<emphasis role="since">
         <superscript> available since <emphasis role="version">3.1.0</emphasis>
         </superscript>
      </emphasis>
   </title>
   <section>
        <title>Description</title>
        <para>The <emphasis role="bold">
            <property>&lt;rich:dropListener&gt;</property>
         </emphasis>
		represents an action listener method that  is notified after a drop operation.
		</para>	
    </section>
   <section>
        <title>Key Features</title>
        <itemizedlist>
			      <listitem>
            <para>Allows to define some drop listeners for the components with "Drag and Drop" support</para>
         </listitem>
        </itemizedlist>
    </section>
   <section>
		    <title>Details of Usage</title>

		    <para>
			The
			<emphasis role="bold">
				        <property>&lt;rich:dropListener&gt;</property>
			      </emphasis>
			is used as a nested tag with components like
			<emphasis role="bold">
				        <property>&lt;rich:dropSupport&gt;</property>
			      </emphasis>
			,
			<emphasis role="bold">
				        <property>&lt;rich:tree&gt;</property>
			      </emphasis>
			and
			<emphasis role="bold">
				        <property>&lt;rich:treeNode&gt;</property>
			      </emphasis>
			.
		</para>
		    <para>
			Attribute
			<emphasis>
				        <property>"type"</property>
			      </emphasis>
			defines the fully qualified Java class name for the
			listener. This class should implement
			<ulink url="&apidoc_framework;org/richfaces/event/DropListener.html">
				        <code>org.richfaces.event.DropListener</code>
			      </ulink>
			interface.
			.
		</para>

		    <para>
			      <emphasis role="bold">
				The typical variant of using:
			</emphasis>
		    </para>

		    <programlisting role="XML"><![CDATA[...
<rich:panel style="width:100px;height:100px;">
	<f:facet name="header">Drop Zone</f:facet>
	<rich:dropSupport acceptedTypes="text"> 
		<rich:dropListener type="demo.ListenerBean"/>
	</rich:dropSupport>				
</rich:panel>
...
]]></programlisting>

		    <para>
			      <emphasis role="bold">Java bean source:</emphasis>
		    </para>

		    <programlisting role="JAVA"><![CDATA[package demo;

import org.richfaces.event.DropEvent;

public class ListenerBean implements org.richfaces.event.DropListener{
...	
	public void processDrop(DropEvent arg0){
		//Custom Developer Code 
	}
...
}
]]></programlisting>
	  </section>
   <section>
      <title>Reference Data</title>
      <para>
         <ulink url="&tlddoc;rich/dropListener.html">Table of 
							&lt;rich:dropListener&gt; 
							 attributes</ulink>.
						</para>
      <table>
		       <title>Component Identification Parameters</title>
		       <tgroup cols="2">
			         <thead>
				           <row>
					             <entry>Name</entry>
					             <entry>Value</entry>
				           </row>
			         </thead>
			         <tbody>

				           <row>
					             <entry>listener-class</entry>
					             <entry>org.richfaces.event.DropListener</entry>
				           </row>
				           <row>
					             <entry>event-class</entry>
					             <entry>org.richfaces.event.DropEvent</entry>
				           </row>

				           <row>
					             <entry>tag-class</entry>
					             <entry>org.richfaces.taglib.DropListenerTag</entry>
				           </row>

			         </tbody>
		       </tgroup>
	     </table>
   </section>
</section>
