jdk.awt.dnd.DropTarget — clojure-interop/java.awt 1.0.5

The DropTarget is associated with a Component when that Component wishes to accept drops during Drag and Drop operations.

Each DropTarget is associated with a FlavorMap. The default FlavorMap hereafter designates the FlavorMap returned by SystemFlavorMap.getDefaultFlavorMap().

->drop-target clj

(->drop-target)

(->drop-target c dtl)

(->drop-target c ops dtl)

(->drop-target c ops dtl act)

(->drop-target c ops dtl act fm)

Constructor.

Creates a new DropTarget given the Component to associate itself with, an int representing the default acceptable action(s) to support, a DropTargetListener to handle event processing, a boolean indicating if the DropTarget is currently accepting drops, and a FlavorMap to use (or null for the default FlavorMap).

The Component will receive drops only if it is enabled.

c - The Component with which this DropTarget is associated - java.awt.Component ops - The default acceptable actions for this DropTarget - int dtl - The DropTargetListener for this DropTarget - java.awt.dnd.DropTargetListener act - Is the DropTarget accepting drops. - boolean fm - The FlavorMap to use, or null for the default FlavorMap - java.awt.datatransfer.FlavorMap

throws: java.awt.HeadlessException - if GraphicsEnvironment.isHeadless() returns true

active? clj

(active? this)

Reports whether or not this DropTarget is currently active (ready to accept drops).

returns: true if active, false if not - boolean

add-drop-target-listener clj

(add-drop-target-listener this dtl)

Adds a new DropTargetListener (UNICAST SOURCE).

dtl - The new DropTargetListener - java.awt.dnd.DropTargetListener

throws: java.util.TooManyListenersException - if a DropTargetListener is already added to this DropTarget.

add-notify clj

(add-notify this peer)

Notify the DropTarget that it has been associated with a Component

This method is usually called from java.awt.Component.addNotify() of the Component associated with this DropTarget to notify the DropTarget that a ComponentPeer has been associated with that Component.

Calling this method, other than to notify this DropTarget of the association of the ComponentPeer with the Component may result in a malfunction of the DnD system.

peer - The Peer of the Component we are associated with! - java.awt.peer.ComponentPeer

drag-enter clj

(drag-enter this dtde)

Calls dragEnter on the registered DropTargetListener and passes it the specified DropTargetDragEvent. Has no effect if this DropTarget is not active.

dtde - the DropTargetDragEvent - java.awt.dnd.DropTargetDragEvent

throws: java.lang.NullPointerException - if this DropTarget is active and dtde is null

drag-exit clj

(drag-exit this dte)

Calls dragExit on the registered DropTargetListener and passes it the specified DropTargetEvent. Has no effect if this DropTarget is not active.

This method itself does not throw any exception for null parameter but for exceptions thrown by the respective method of the listener.

dte - the DropTargetEvent - java.awt.dnd.DropTargetEvent

drag-over clj

(drag-over this dtde)

Calls dragOver on the registered DropTargetListener and passes it the specified DropTargetDragEvent. Has no effect if this DropTarget is not active.

dtde - the DropTargetDragEvent - java.awt.dnd.DropTargetDragEvent

throws: java.lang.NullPointerException - if this DropTarget is active and dtde is null

drop clj

(drop this dtde)

Calls drop on the registered DropTargetListener and passes it the specified DropTargetDropEvent if this DropTarget is active.

dtde - the DropTargetDropEvent - java.awt.dnd.DropTargetDropEvent

throws: java.lang.NullPointerException - if dtde is null and at least one of the following is true: this DropTarget is not active, or there is no a DropTargetListener registered.

drop-action-changed clj

(drop-action-changed this dtde)

Calls dropActionChanged on the registered DropTargetListener and passes it the specified DropTargetDragEvent. Has no effect if this DropTarget is not active.

dtde - the DropTargetDragEvent - java.awt.dnd.DropTargetDragEvent

throws: java.lang.NullPointerException - if this DropTarget is active and dtde is null

get-component clj

(get-component this)

Gets the Component associated with this DropTarget.

returns: the current Component - java.awt.Component

get-default-actions clj

(get-default-actions this)

Gets an int representing the current action(s) supported by this DropTarget.

returns: the current default actions - int

get-drop-target-context clj

(get-drop-target-context this)

Gets the DropTargetContext associated with this DropTarget.

returns: the DropTargetContext associated with this DropTarget. - java.awt.dnd.DropTargetContext

get-flavor-map clj

(get-flavor-map this)

Gets the FlavorMap associated with this DropTarget. If no FlavorMap has been set for this DropTarget, it is associated with the default FlavorMap.

returns: the FlavorMap for this DropTarget - java.awt.datatransfer.FlavorMap

remove-drop-target-listener clj

(remove-drop-target-listener this dtl)

Removes the current DropTargetListener (UNICAST SOURCE).

dtl - the DropTargetListener to deregister. - java.awt.dnd.DropTargetListener

remove-notify clj

(remove-notify this peer)

Notify the DropTarget that it has been disassociated from a Component

This method is usually called from java.awt.Component.removeNotify() of the Component associated with this DropTarget to notify the DropTarget that a ComponentPeer has been disassociated with that Component.

Calling this method, other than to notify this DropTarget of the disassociation of the ComponentPeer from the Component may result in a malfunction of the DnD system.

peer - The Peer of the Component we are being disassociated from! - java.awt.peer.ComponentPeer

set-active clj

(set-active this is-active)

Sets the DropTarget active if true, inactive if false.

is-active - sets the DropTarget (in)active. - boolean

set-component clj

(set-component this c)

Note: this interface is required to permit the safe association of a DropTarget with a Component in one of two ways, either: component.setDropTarget(droptarget); or droptarget.setComponent(component);

The Component will receive drops only if it is enabled.

c - The new Component this DropTarget is to be associated with. - java.awt.Component

set-default-actions clj

(set-default-actions this ops)

Sets the default acceptable actions for this DropTarget

ops - the default actions - int

set-flavor-map clj

(set-flavor-map this fm)

Sets the FlavorMap associated with this DropTarget.

fm - the new FlavorMap, or null to associate the default FlavorMap with this DropTarget. - java.awt.datatransfer.FlavorMap