No cache version.

Caching disabled. Default setting for this page:enabled (code LNG204)
If the display is too slow, you can disable the user mode to view the cached version.
java.awt.dnd

Class DragSourceContext

    • Field Summary

      Fields 
      Modifier and Type Field and Description
      protected static int CHANGED
      An int used by updateCurrentCursor() indicating that the user operation has changed.
      protected static int DEFAULT
      An int used by updateCurrentCursor() indicating that the Cursor should change to the default (no drop) Cursor.
      protected static int ENTER
      An int used by updateCurrentCursor() indicating that the Cursor has entered a DropTarget.
      protected static int OVER
      An int used by updateCurrentCursor() indicating that the Cursor is over a DropTarget.

      DragSourceContext (Java Platform SE 7 ) Home of API Java Contents Haut

    • Constructor Summary

      Constructors 
      Constructor and Description
      DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp, DragGestureEvent trigger, Cursor dragCursor, Image dragImage, Point offset, Transferable t, DragSourceListener dsl)
      Called from DragSource, this constructor creates a new DragSourceContext given the DragSourceContextPeer for this Drag, the DragGestureEvent that triggered the Drag, the initial Cursor to use for the Drag, an (optional) Image to display while the Drag is taking place, the offset of the Image origin from the hotspot at the instant of the triggering event, the Transferable subject data, and the DragSourceListener to use during the Drag and Drop operation.

      DragSourceContext (Java Platform SE 7 ) Home of API Java Contents Haut

    • Field Detail

      • DEFAULT

        protected static final int DEFAULT
        An int used by updateCurrentCursor() indicating that the Cursor should change to the default (no drop) Cursor.
        See Also:
        Constant Field Values
      • ENTER

        protected static final int ENTER
        An int used by updateCurrentCursor() indicating that the Cursor has entered a DropTarget.
        See Also:
        Constant Field Values
      • OVER

        protected static final int OVER
        An int used by updateCurrentCursor() indicating that the Cursor is over a DropTarget.
        See Also:
        Constant Field Values
      • CHANGED

        protected static final int CHANGED
        An int used by updateCurrentCursor() indicating that the user operation has changed.
        See Also:
        Constant Field Values
    • Constructor Detail

      • DragSourceContext

        public DragSourceContext(java.awt.dnd.peer.DragSourceContextPeer dscp,
                         DragGestureEvent trigger,
                         Cursor dragCursor,
                         Image dragImage,
                         Point offset,
                         Transferable t,
                         DragSourceListener dsl)
        Called from DragSource, this constructor creates a new DragSourceContext given the DragSourceContextPeer for this Drag, the DragGestureEvent that triggered the Drag, the initial Cursor to use for the Drag, an (optional) Image to display while the Drag is taking place, the offset of the Image origin from the hotspot at the instant of the triggering event, the Transferable subject data, and the DragSourceListener to use during the Drag and Drop operation.
        If DragSourceContextPeer is null NullPointerException is thrown.
        If DragGestureEvent is null NullPointerException is thrown.
        If Cursor is null no exception is thrown and the default drag cursor behavior is activated for this drag operation.
        If Image is null no exception is thrown.
        If Image is not null and the offset is null NullPointerException is thrown.
        If Transferable is null NullPointerException is thrown.
        If DragSourceListener is null no exception is thrown.
        Parameters:
        dscp - the DragSourceContextPeer for this drag
        trigger - the triggering event
        dragCursor - the initial Cursor for this drag operation or null for the default cursor handling; see class level documentation for more details on the cursor handling mechanism during drag and drop
        dragImage - the Image to drag (or null)
        offset - the offset of the image origin from the hotspot at the instant of the triggering event
        t - the Transferable
        dsl - the DragSourceListener
        Throws:
        IllegalArgumentException - if the Component associated with the trigger event is null.
        IllegalArgumentException - if the DragSource for the trigger event is null.
        IllegalArgumentException - if the drag action for the trigger event is DnDConstants.ACTION_NONE.
        IllegalArgumentException - if the source actions for the DragGestureRecognizer associated with the trigger event are equal to DnDConstants.ACTION_NONE.
        NullPointerException - if dscp, trigger, or t are null, or if dragImage is non-null and offset is null
    • Method Detail

      • getDragSource

        public DragSource getDragSource()
        Returns the DragSource that instantiated this DragSourceContext.
        Returns:
        the DragSource that instantiated this DragSourceContext
      • getComponent

        public Component getComponent()
        Returns the Component associated with this DragSourceContext.
        Returns:
        the Component that started the drag
      • getTrigger

        public DragGestureEvent getTrigger()
        Returns the DragGestureEvent that initially triggered the drag.
        Returns:
        the Event that triggered the drag
      • getSourceActions

        public int getSourceActions()
        Returns a bitwise mask of DnDConstants that represent the set of drop actions supported by the drag source for the drag operation associated with this DragSourceContext.
        Returns:
        the drop actions supported by the drag source
      • setCursor

        public void setCursor(Cursor c)
        Sets the cursor for this drag operation to the specified Cursor. If the specified Cursor is null, the default drag cursor behavior is activated for this drag operation, otherwise it is deactivated.
        Parameters:
        c - the initial Cursor for this drag operation, or null for the default cursor handling; see class level documentation for more details on the cursor handling during drag and drop
      • getCursor

        public Cursor getCursor()
        Returns the current drag Cursor.

        Returns:
        the current drag Cursor
      • addDragSourceListener

        public void addDragSourceListener(DragSourceListener dsl)
                                   throws TooManyListenersException
        Add a DragSourceListener to this DragSourceContext if one has not already been added. If a DragSourceListener already exists, this method throws a TooManyListenersException.

        Parameters:
        dsl - the DragSourceListener to add. Note that while null is not prohibited, it is not acceptable as a parameter.

        Throws:
        TooManyListenersException - if a DragSourceListener has already been added
      • removeDragSourceListener

        public void removeDragSourceListener(DragSourceListener dsl)
        Removes the specified DragSourceListener from this DragSourceContext.
        Parameters:
        dsl - the DragSourceListener to remove; note that while null is not prohibited, it is not acceptable as a parameter
      • transferablesFlavorsChanged

        public void transferablesFlavorsChanged()
        Notifies the peer that the Transferable's DataFlavors have changed.
      • dragEnter

        public void dragEnter(DragSourceDragEvent dsde)
        Calls dragEnter on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceDragEvent.
        Specified by:
        dragEnter in interface DragSourceListener
        Parameters:
        dsde - the DragSourceDragEvent
      • dragOver

        public void dragOver(DragSourceDragEvent dsde)
        Calls dragOver on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceDragEvent.
        Specified by:
        dragOver in interface DragSourceListener
        Parameters:
        dsde - the DragSourceDragEvent
      • dragExit

        public void dragExit(DragSourceEvent dse)
        Calls dragExit on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceEvent.
        Specified by:
        dragExit in interface DragSourceListener
        Parameters:
        dse - the DragSourceEvent
      • dropActionChanged

        public void dropActionChanged(DragSourceDragEvent dsde)
        Calls dropActionChanged on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceDragEvent.
        Specified by:
        dropActionChanged in interface DragSourceListener
        Parameters:
        dsde - the DragSourceDragEvent
      • dragDropEnd

        public void dragDropEnd(DragSourceDropEvent dsde)
        Calls dragDropEnd on the DragSourceListeners registered with this DragSourceContext and with the associated DragSource, and passes them the specified DragSourceDropEvent.
        Specified by:
        dragDropEnd in interface DragSourceListener
        Parameters:
        dsde - the DragSourceDropEvent
      • dragMouseMoved

        public void dragMouseMoved(DragSourceDragEvent dsde)
        Calls dragMouseMoved on the DragSourceMotionListeners registered with the DragSource associated with this DragSourceContext, and them passes the specified DragSourceDragEvent.
        Specified by:
        dragMouseMoved in interface DragSourceMotionListener
        Parameters:
        dsde - the DragSourceDragEvent
        Since:
        1.4
      • getTransferable

        public Transferable getTransferable()
        Returns the Transferable associated with this DragSourceContext.
        Returns:
        the Transferable
      • updateCurrentCursor

        protected void updateCurrentCursor(int sourceAct,
                               int targetAct,
                               int status)
        If the default drag cursor behavior is active, this method sets the default drag cursor for the specified actions supported by the drag source, the drop target action, and status, otherwise this method does nothing.
        Parameters:
        sourceAct - the actions supported by the drag source
        targetAct - the drop target action
        status - one of the fields DEFAULT, ENTER, OVER, CHANGED
Error Infobrol

Can not display this page of the Infobrol website

Type of error (18-01)

Unknown format specifier "&"

Please try again in a few minutes…

Return to the home page




Steph