bibliothek.gui.dock.control.relocator
Interface DockRelocatorEvent

All Known Implementing Classes:

DefaultDockRelocatorEvent

public interface DockRelocatorEvent

An event created by the DockRelocator and forwarded to the VetoableDockRelocatorListener.

Author:

Benjamin Sigg

Method Summary

void	cancel() Cancels the entire operation, the Dockable remains at its current place and all visible indicators are removed.
void	drop() Advices to complete the drag and drop operation right now, this operation at least requires getTarget() to be not null, otherwise this operation is equal to calling cancel().
void	forbid() Forbids the current event to complete, depending on the state of the operation this is equivalent to calling cancel().
DockController	getController() Gets the controller in whose realm this event was created.
Dockable	getDockable() Gets the Dockable which is or will be dragged.
DockRelocator	getSource() Gets the DockRelocator which created this event.
DockStation	getTarget() Gets the current target of the drag and drop operation, if the operation would finish now, the dockable would be dropped onto this station.
boolean	isCanceled() Tells whether this event is already canceled.
boolean	isDropping() Tells whether this event will result in a drop operation.
boolean	isForbidden() Tells whether this event is forbidden.

Method Detail

getController

DockController getController()

Gets the controller in whose realm this event was created.

Returns:

the controller, not null

getSource

DockRelocator getSource()

Gets the DockRelocator which created this event.

Returns:

the relocator, not null

getDockable

Dockable getDockable()

Gets the Dockable which is or will be dragged.

Returns:

the dragged item

getTarget

DockStation getTarget()

Gets the current target of the drag and drop operation, if the operation would finish now, the dockable would be dropped onto this station.

Returns:

the current target or null if either the drag and drop operation is not yet started or if there is no target selected

cancel

void cancel()

Cancels the entire operation, the Dockable remains at its current place and all visible indicators are removed.

isCanceled

boolean isCanceled()

Tells whether this event is already canceled. This can either be due to a call to cancel() or because the DockRelocator already decided that the operation has to be canceled.

Returns:

whether the operation is canceled

See Also:

cancel()

forbid

void forbid()

Forbids the current event to complete, depending on the state of the operation this is equivalent to calling cancel().

isForbidden

boolean isForbidden()

Tells whether this event is forbidden. This can either be due to a call to forbid() or because the DockRelocator already decided that this operation should not have an effect.

Returns:

whether the operation is forbidden

See Also:

forbid()

drop

void drop()

Advices to complete the drag and drop operation right now, this operation at least requires getTarget() to be not null, otherwise this operation is equal to calling cancel().

isDropping

boolean isDropping()

Tells whether this event will result in a drop operation. This can be either due to a call to drop() or because the DockRelocator already decided that a the operation has to finish.

Returns:

whether the dockable will be dropped

See Also:

drop()