zk

Class DnD

java.lang.Object

zk.DnD

public class DnD
extends java.lang.Object

Drag-and-drop utility. It is the low-level utility reserved for overriding for advanced customization.

Method Summary

Modifier and Type	Method and Description
static Widget	getDrop(Draggable drag, Offset pt, Event evt) Returns the widget to drop to.
static Widget	getDropTarget(Event evt, Draggable drag) Returns the drop target from the event, or the element from the event's ClientX and ClientY.
static DOMElement	ghost(Draggable drag, Offset ofs, String msg) Ghost the DOM element being dragged.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getDropTarget

public static Widget getDropTarget(Event evt,
                                   Draggable drag)

Returns the drop target from the event, or the element from the event's ClientX and ClientY. This function is to fix IE9~11, Edge, and Firefox which will receive a wrong target from the mouseup event.

Parameters:

evt - the DOM event

drag - the draggable controller

Returns:

zk.Widget

Since:

8.0.2

getDrop

public static Widget getDrop(Draggable drag,
                             Offset pt,
                             Event evt)

Returns the widget to drop to.

Parameters:

drag - the draggable controller

pt - the mouse pointer's position.

evt - the DOM event

Returns:

zk.Widget

ghost

public static DOMElement ghost(Draggable drag,
                               Offset ofs,
                               String msg)

Ghost the DOM element being dragged.

Parameters:

drag - the draggable controller

ofs - the offset of the returned element (left/top)

msg - the message to show inside the returned element

Returns:

DOMElement the element representing what is being dragged