Class GridDropTarget<T>

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

• getGrid

  public Grid<T> getGrid()

  Gets the grid this extension has been attached to.

  Returns:

  the grid for this extension

  Since:

  8.2

• setDropMode

  public void setDropMode​(DropMode dropMode)

  Sets the drop mode of this drop target.

  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.

  If using DropMode.ON_GRID, then the drop will not happen on any row, but instead just "on the grid". The target row will not be present in this case.

  NOTE: DropMode.ON_GRID is used automatically when the grid has been sorted and setDropAllowedOnRowsWhenSorted(boolean) is false - since the drop location would not necessarily match the correct row because of the sorting. During the sorting, any calls to this method don't have any effect until the sorting has been removed, or setDropAllowedOnRowsWhenSorted(boolean) is set back to true.

  Parameters:

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

  See Also:

  GridDropEvent.getDropLocation(), setDropAllowedOnRowsWhenSorted(boolean)

• 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.

• setDropAllowedOnRowsWhenSorted

  public void setDropAllowedOnRowsWhenSorted​(boolean dropAllowedOnSortedGridRows)

  Sets whether the grid accepts drop on rows as target when the grid has been sorted by the user.

  Default value is true for backwards compatibility with 8.1. When true is used or the grid is not sorted, the mode used in setDropMode(DropMode) is always used.

  false value means that when the grid has been sorted, the drop mode is always DropMode.ON_GRID, regardless of what was set with setDropMode(DropMode). Once the grid is not sorted anymore, the sort mode is reverted back to what was set with setDropMode(DropMode).

  Parameters:

  dropAllowedOnSortedGridRows - true for allowing, false for not allowing drops on sorted grid rows

  Since:

  8.2

• isDropAllowedOnRowsWhenSorted

  public boolean isDropAllowedOnRowsWhenSorted()

  Gets whether drops are allowed on rows as target, when the user has sorted the grid.

  Returns:

  whether drop are allowed for the grid's rows when user has sorted the grid

  Since:

  8.2

• 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()

• remove

  public void remove()

  Description copied from interface: Extension

  Remove this extension from its target. After an extension has been removed, it cannot be attached again.

  Specified by:

  remove in interface Extension

  Overrides:

  remove in class AbstractExtension