<?xml version="1.0" encoding="UTF-8"?>
<chapter>
	<chapterinfo>
		<keywordset>
			<keyword>rich:dropListener</keyword>
		</keywordset>
	</chapterinfo>
	<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>
		<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:dropListener type="demo.Bean"/>
...
]]></programlisting>
	</section>

	<section>
		<title>Creating the Component Dynamically Using Java</title>
		<para>
			<emphasis role="bold">Example:</emphasis>
		</para>
		<programlisting role="JAVA"><![CDATA[package demo;
	  
public class ImplBean implements org.richfaces.event.DropListener{
	...
}
]]></programlisting>

		<programlisting role="JAVA"><![CDATA[
import demo.ImplBean;
...
ImplBean myListener = new ImplBean();
...
]]></programlisting>

	</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>&quot;type&quot;</property>
			</emphasis>
			defines the fully qualified Java class name for the
			listener. This class should implement
			<code>org.richfaces.event.DropListener</code>
			<ulink
				url="http://labs.jboss.com/file-access/default/members/jbossrichfaces/freezone/docs/apidoc_framework/index.html">
				interface
			</ulink>
			.
		</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>Look-and-Feel Customization</title>

		<para>
			<emphasis role="bold">
				<property>&lt;rich:dropListener&gt;</property>
			</emphasis>
			has no skin parameters and custom
			<property>style classes</property>
			, as the component isn&apos;t visual.
		</para>
	</section>

</chapter>