JavaTM 2 Platform
Std. Ed. v1.3.1

com.apple.mrj.dnd
Class DragInitiatorEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.awt.AWTEvent
              |
              +--java.awt.event.ComponentEvent
                    |
                    +--java.awt.event.InputEvent
                          |
                          +--java.awt.event.MouseEvent
                                |
                                +--com.apple.mrj.dnd.DragInitiatorEvent
All Implemented Interfaces:
Serializable

Deprecated. As of MacOSX 10.2, replaced by Java2 DnD.

public class DragInitiatorEvent
extends MouseEvent

An event sent to a registered DragInitiatorListener when the user begins a dragging gesture (i.e. after the mouse has been pressed and moved 4 pixels) and after a drag-n-drop operation initiated by such a gesture completes.

See Also:
DragInitiatorListener, Serialized Form

Field Summary
static int DRAG_COMPLETED
          Deprecated.  
static int DRAG_FAILED
          Deprecated.  
static int DRAG_GESTURE
          Deprecated.  
static int DRAG_INITIATOR_FIRST
          Deprecated.  
static int DRAG_INITIATOR_LAST
          Deprecated.  
 
Fields inherited from class java.awt.event.MouseEvent
MOUSE_CLICKED, MOUSE_DRAGGED, MOUSE_ENTERED, MOUSE_EXITED, MOUSE_FIRST, MOUSE_LAST, MOUSE_MOVED, MOUSE_PRESSED, MOUSE_RELEASED
 
Fields inherited from class java.awt.event.InputEvent
ALT_GRAPH_MASK, ALT_MASK, BUTTON1_MASK, BUTTON2_MASK, BUTTON3_MASK, CTRL_MASK, META_MASK, SHIFT_MASK
 
Fields inherited from class java.awt.event.ComponentEvent
COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN
 
Fields inherited from class java.awt.AWTEvent
ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
DragInitiatorEvent(Component source, int id, long when, int modifiers, int x, int y, OutgoingDrag drag)
          Deprecated.  
 
Method Summary
 OutgoingDrag getDrag()
          Deprecated. Returns the OutgoingDrag to be used in a drag-n-drop operation.
 Image getDragImage()
          Deprecated. Returns the Image that should be used for visual feedback during drag tracking, or null if there is none.
 Point getDragImageOffset()
          Deprecated. Returns the offset of the image in component coordinates, or null if there is no image.
 Shape getDragShape()
          Deprecated. Returns the shape of the outline that will be visually dragged.
 boolean isDragInitiated()
          Deprecated. Returns true if an OutgoingDrag has been initiated.
 String paramString()
          Deprecated. Returns a parameter string identifying this event.
 void setDragImage(Image image, int x, int y)
          Deprecated. Sets the image that should be used for visual feedback during drag tracking, and the point in the Component's coordinate system at which the top left corner of the image originally appears.
 void setDragRect(int x, int y, int width, int height)
          Deprecated. Sets the bounds of the rectangular outline that will be visually dragged.
 void setDragShape(Shape s)
          Deprecated. Sets the shape of the outline that will be visually dragged.
 
Methods inherited from class java.awt.event.MouseEvent
getClickCount, getPoint, getX, getY, isPopupTrigger, translatePoint
 
Methods inherited from class java.awt.event.InputEvent
consume, getModifiers, getWhen, isAltDown, isAltGraphDown, isConsumed, isControlDown, isMetaDown, isShiftDown
 
Methods inherited from class java.awt.event.ComponentEvent
getComponent
 
Methods inherited from class java.awt.AWTEvent
getID, toString
 
Methods inherited from class java.util.EventObject
getSource
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

DRAG_INITIATOR_FIRST

public static final int DRAG_INITIATOR_FIRST
Deprecated. 

DRAG_INITIATOR_LAST

public static final int DRAG_INITIATOR_LAST
Deprecated. 

DRAG_GESTURE

public static final int DRAG_GESTURE
Deprecated. 

DRAG_COMPLETED

public static final int DRAG_COMPLETED
Deprecated. 

DRAG_FAILED

public static final int DRAG_FAILED
Deprecated. 
Constructor Detail

DragInitiatorEvent

public DragInitiatorEvent(Component source,
                          int id,
                          long when,
                          int modifiers,
                          int x,
                          int y,
                          OutgoingDrag drag)
Deprecated. 
Method Detail

getDrag

public OutgoingDrag getDrag()
Deprecated. 
Returns the OutgoingDrag to be used in a drag-n-drop operation.

isDragInitiated

public boolean isDragInitiated()
Deprecated. 
Returns true if an OutgoingDrag has been initiated.

getDragShape

public Shape getDragShape()
Deprecated. 
Returns the shape of the outline that will be visually dragged. This shape is in the source Component's coordinate system. By default, it is the entire [rectangular] bounds of the Component.

setDragShape

public void setDragShape(Shape s)
Deprecated. 
Sets the shape of the outline that will be visually dragged. This shape is in the source Component's coordinate system. By default, it is the entire [rectangular] bounds of the Component. Setting it to null will return it to this default.

setDragRect

public void setDragRect(int x,
                        int y,
                        int width,
                        int height)
Deprecated. 
Sets the bounds of the rectangular outline that will be visually dragged. This rectangle is in the source Component's coordinate system.

getDragImage

public Image getDragImage()
Deprecated. 
Returns the Image that should be used for visual feedback during drag tracking, or null if there is none.

getDragImageOffset

public Point getDragImageOffset()
Deprecated. 
Returns the offset of the image in component coordinates, or null if there is no image.

setDragImage

public void setDragImage(Image image,
                         int x,
                         int y)
Deprecated. 
Sets the image that should be used for visual feedback during drag tracking, and the point in the Component's coordinate system at which the top left corner of the image originally appears.

paramString

public String paramString()
Deprecated. 
Description copied from class: MouseEvent
Returns a parameter string identifying this event. This method is useful for event-logging and for debugging.
Overrides:
paramString in class MouseEvent
Following copied from class: java.awt.event.MouseEvent
Returns:
a string identifying the event and its attributes

JavaTM 2 Platform
Std. Ed. v1.3.1

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2001 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.