6.43.  < rich:dragListener >

6.43.1. Description

The <rich:dragListener> represents an action listener method that is notified after a drag operation.

6.43.2. Key Features

  • Allows to define some drag listeners for the components with "Drag and Drop" support

Table 6.158. rich : dragListener attributes

Attribute NameDescription
bindingThe attribute takes a value-binding expression for a component property of a backing bean

Table 6.159. Component identification parameters

NameValue
listener-classorg.richfaces.event.DragListener
event-classorg.richfaces.event.DragEvent
tag-classorg.richfaces.taglib.DragListenerTag

6.43.3. Creating the Component with a Page Tag

To create the simplest variant on a page use the following syntax:

Example:


...
    <rich:dragListener type="demo.Bean"/>
...

6.43.4. Creating the Component Dynamically Using Java

Example:


package demo;
      
public class ImplBean implements org.richfaces.event.DragListener{
    ...
}


import demo.ImplBean;
...
ImplBean myDragListener = new ImplBean();
...

6.43.5. Details of Usage

The <rich:dragListener> is used as a nested tag with components like <rich:dragSupport> , <rich:tree> and <rich:treeNode> .

Attribute "type" defines the fully qualified Java class name for a listener. This class should implement org.richfaces.event.DragListener interface.

The typical variant of using:


...
<h:panelGrid id="dragPanel">
    <rich:dragSupport dragType="item">
        <rich:dragListener type="demo.ListenerBean"/>   
    </rich:dragSupport>
    <!--Some content to be dragged-->
</h:panelGrid>
...

Java bean source:


package demo;

import org.richfaces.event.DragEvent;

public class ListenerBean implements org.richfaces.event.DragListener{
... 
    public void processDrag(DragEvent arg0){
        //Custom Developer Code 
    }
...
}

6.43.6. Look-and-Feel Customization

<rich:dragListener> has no skin parameters and custom style classes, as the component isn't visual.