com.vaadin.ui.components.grid

Class GridDropTarget<T>

java.lang.Object

com.vaadin.server.AbstractClientConnector

com.vaadin.server.AbstractExtension

com.vaadin.ui.dnd.DropTargetExtension<Grid<T>>

com.vaadin.ui.components.grid.GridDropTarget<T>

Type Parameters:

T - Type of the Grid bean.

All Implemented Interfaces:

MethodEventSource, ClientConnector, Extension, Connector, Serializable

Direct Known Subclasses:

TreeGridDropTarget

public class GridDropTarget<T>
extends DropTargetExtension<Grid<T>>

Makes the rows of a Grid HTML5 drop targets. This is the server side counterpart of GridDropTargetExtensionConnector.

Since:

8.1

Author:

Vaadin Ltd

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector

ClientConnector.AttachEvent, ClientConnector.AttachListener, ClientConnector.ConnectorErrorEvent, ClientConnector.DetachEvent, ClientConnector.DetachListener

Constructor Summary

Constructors

Constructor and Description
GridDropTarget(Grid<T> target, DropMode dropMode) Extends a Grid and makes it's rows drop targets for HTML5 drag and drop.

Method Summary

Modifier and Type	Method and Description
Registration	addGridDropListener(GridDropListener<T> listener) Attaches drop listener for the current drop target.
DropMode	getDropMode() Gets the drop mode of this drop target.
int	getDropThreshold() Gets the threshold between drop locations from the top and the bottom of the row.
protected GridDropTargetState	getState() Returns the shared state for this connector.
protected GridDropTargetState	getState(boolean markAsDirty) Returns the shared state for this connector.
protected void	registerDropTargetRpc() Registers the server side RPC methods invoked from client side on drop event.
void	setDropMode(DropMode dropMode) Sets the drop mode of this drop target.
void	setDropThreshold(int threshold) Sets the threshold between drop locations from the top and the bottom of a row in pixels.

Methods inherited from class com.vaadin.ui.dnd.DropTargetExtension

addDropListener, attach, getDropCriteriaScript, getDropEffect, getParent, onDrop, setDropCriteria, setDropCriteriaScript, setDropCriterion, setDropCriterion, setDropCriterion, setDropEffect

Methods inherited from class com.vaadin.server.AbstractExtension

extend, getSupportedParentType, remove, setParent

Methods inherited from class com.vaadin.server.AbstractClientConnector

addAttachListener, addDetachListener, addExtension, addListener, addListener, addListener, addMethodInvocationToQueue, beforeClientResponse, createState, detach, encodeState, equals, fireEvent, getAllChildrenIterable, getConnectorId, getErrorHandler, getExtensions, getListeners, getResource, getRpcManager, getRpcProxy, getSession, getStateType, getUI, handleConnectorRequest, hashCode, hasListeners, isAttached, isConnectorEnabled, isThis, markAsDirty, markAsDirtyRecursive, registerRpc, registerRpc, removeAttachListener, removeDetachListener, removeExtension, removeListener, removeListener, removeListener, removeListener, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler, setResource, updateDiffstate

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.vaadin.server.ClientConnector

addAttachListener, addDetachListener, beforeClientResponse, detach, encodeState, getErrorHandler, getExtensions, getRpcManager, getStateType, getUI, handleConnectorRequest, isAttached, isConnectorEnabled, markAsDirty, markAsDirtyRecursive, removeAttachListener, removeDetachListener, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Constructor Detail

GridDropTarget

public GridDropTarget(Grid<T> target,
                      DropMode dropMode)

Extends a Grid and makes it's rows drop targets for HTML5 drag and drop.

Parameters:

target - Grid to be extended.

dropMode - Drop mode that describes the allowed drop locations within the Grid's row.

See Also:

GridDropEvent.getDropLocation()

Method Detail

setDropMode

public void setDropMode(DropMode dropMode)

Sets the drop mode of this drop target.

Note that when using DropMode.ON_TOP, and the grid is either empty or has empty space after the last row, the drop can still happen on the empty space, and the GridDropEvent.getDropTargetRow() will return an empty optional.

When using DropMode.BETWEEN or DropMode.ON_TOP_OR_BETWEEN, and there is at least one row in the grid, any drop after the last row in the grid will get the last row as the GridDropEvent.getDropTargetRow(). If there are no rows in the grid, then it will return an empty optional.

Parameters:

dropMode - Drop mode that describes the allowed drop locations within the Grid's row.

See Also:

GridDropEvent.getDropLocation()

getDropMode

public DropMode getDropMode()

Gets the drop mode of this drop target.

Returns:

Drop mode that describes the allowed drop locations within the Grid's row.

addGridDropListener

public Registration addGridDropListener(GridDropListener<T> listener)

Attaches drop listener for the current drop target. GridDropListener.drop(GridDropEvent) is called when drop event happens on the client side.

Parameters:

listener - Listener to handle drop event.

Returns:

Handle to be used to remove this listener.

setDropThreshold

public void setDropThreshold(int threshold)

Sets the threshold between drop locations from the top and the bottom of a row in pixels.

Dropping an element

• within threshold pixels from the top of a row results in a drop event with DropLocation.ABOVE
• within threshold pixels from the bottom of a row results in a drop event with DropLocation.BELOW
• anywhere else within the row results in a drop event with DropLocation.ON_TOP

The value only has an effect when drop mode is set to DropMode.ON_TOP_OR_BETWEEN.

Default is 5 pixels.

Parameters:

threshold - The threshold from the top and bottom of the row in pixels.

getDropThreshold

public int getDropThreshold()

Gets the threshold between drop locations from the top and the bottom of the row.

Returns:

The threshold in pixels.

registerDropTargetRpc

protected void registerDropTargetRpc()

Description copied from class: DropTargetExtension

Registers the server side RPC methods invoked from client side on drop event.

Override this method if you need to have a custom RPC interface for transmitting the drop event with more data. If just need to do additional things before firing the drop event, then you should override DropTargetExtension.onDrop(List, Map, DropEffect, MouseEventDetails) instead.

Overrides:

registerDropTargetRpc in class DropTargetExtension<Grid<T>>

getState

protected GridDropTargetState getState()

Description copied from class: AbstractClientConnector

Returns the shared state for this connector. The shared state object is shared between the server connector and the client connector. Changes are only communicated from the server to the client and not in the other direction.

As a side effect, marks the connector dirty so any changes done to the state will be sent to the client. Use getState(false) to avoid marking the connector as dirty.

Overrides:

getState in class DropTargetExtension<Grid<T>>

Returns:

The shared state for this connector. Never null.

getState

protected GridDropTargetState getState(boolean markAsDirty)

Description copied from class: AbstractClientConnector

Returns the shared state for this connector.

Overrides:

getState in class DropTargetExtension<Grid<T>>

Parameters:

markAsDirty - true if the connector should automatically be marked dirty, false otherwise

Returns:

The shared state for this connector. Never null.

See Also:

AbstractClientConnector.getState()