java.awt.dnd

Class DropTargetContext

  • All Implemented Interfaces:
    Serializable

    public class DropTargetContext
    extends Object
    implements Serializable
    A DropTargetContext is created whenever the logical cursor associated with a Drag and Drop operation coincides with the visible geometry of a Component associated with a DropTarget. The DropTargetContext provides the mechanism for a potential receiver of a drop operation to both provide the end user with the appropriate drag under feedback, but also to effect the subsequent data transfer if appropriate.
    Since:
    1.2
    See Also:
    Serialized Form
    • Method Detail

      • getDropTarget

        public DropTarget getDropTarget()
        This method returns the DropTarget associated with this DropTargetContext.

        Returns:
        the DropTarget associated with this DropTargetContext
      • getComponent

        public Component getComponent()
        This method returns the Component associated with this DropTargetContext.

        Returns:
        the Component associated with this Context
      • addNotify

        public void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)
        Called when associated with the DropTargetContextPeer.

        Parameters:
        dtcp - the DropTargetContextPeer
      • removeNotify

        public void removeNotify()
        Called when disassociated with the DropTargetContextPeer.
      • setTargetActions

        protected void setTargetActions(int actions)
        This method sets the current actions acceptable to this DropTarget.

        Parameters:
        actions - an int representing the supported action(s)
      • getTargetActions

        protected int getTargetActions()
        This method returns an int representing the current actions this DropTarget will accept.

        Returns:
        the current actions acceptable to this DropTarget
      • dropComplete

        public void dropComplete(boolean success)
                          throws InvalidDnDOperationException
        This method signals that the drop is completed and if it was successful or not.

        Parameters:
        success - true for success, false if not

        Throws:
        InvalidDnDOperationException - if a drop is not outstanding/extant
      • acceptDrag

        protected void acceptDrag(int dragOperation)
        accept the Drag.

        Parameters:
        dragOperation - the supported action(s)
      • rejectDrag

        protected void rejectDrag()
        reject the Drag.
      • acceptDrop

        protected void acceptDrop(int dropOperation)
        called to signal that the drop is acceptable using the specified operation. must be called during DropTargetListener.drop method invocation.

        Parameters:
        dropOperation - the supported action(s)
      • rejectDrop

        protected void rejectDrop()
        called to signal that the drop is unacceptable. must be called during DropTargetListener.drop method invocation.
      • getCurrentDataFlavors

        protected DataFlavor[] getCurrentDataFlavors()
        get the available DataFlavors of the Transferable operand of this operation.

        Returns:
        a DataFlavor[] containing the supported DataFlavors of the Transferable operand.
      • getCurrentDataFlavorsAsList

        protected List<DataFlavor> getCurrentDataFlavorsAsList()
        This method returns a the currently available DataFlavors of the Transferable operand as a java.util.List.

        Returns:
        the currently available DataFlavors as a java.util.List
      • isDataFlavorSupported

        protected boolean isDataFlavorSupported(DataFlavor df)
        This method returns a boolean indicating if the given DataFlavor is supported by this DropTargetContext.

        Parameters:
        df - the DataFlavor

        Returns:
        if the DataFlavor specified is supported
      • createTransferableProxy

        protected Transferable createTransferableProxy(Transferable t,
                                           boolean local)
        Creates a TransferableProxy to proxy for the specified Transferable.
        Parameters:
        t - the Transferable to be proxied
        local - true if t represents the result of a local drag-n-drop operation.
        Returns:
        the new TransferableProxy instance.

Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/awt/dnd/DropTargetContext.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut