java.awt.dnd

Class DragGestureEvent

Inhoudsopgave
  • All Implemented Interfaces:
    Serializable

    public class DragGestureEvent
extends EventObject
    A DragGestureEvent is passed to DragGestureListener's dragGestureRecognized() method when a particular DragGestureRecognizer detects that a platform dependent drag initiating gesture has occurred on the Component that it is tracking. The action field of any DragGestureEvent instance should take one of the following values:
    • DnDConstants.ACTION_COPY
    • DnDConstants.ACTION_MOVE
    • DnDConstants.ACTION_LINK
    Assigning the value different from listed above will cause an unspecified behavior.
    See Also:
    DragGestureRecognizer, DragGestureListener, DragSource, DnDConstants, Serialized Form

    • Constructor Detail

      • DragGestureEvent

        public DragGestureEvent(DragGestureRecognizer dgr,
                int act,
                Point ori,
                List<? extends InputEvent> evs)
        Constructs a DragGestureEvent object given by the DragGestureRecognizer instance firing this event, an act parameter representing the user's preferred action, an ori parameter indicating the origin of the drag, and a List of events that comprise the gesture(evs parameter).

        Parameters:
        dgr - The DragGestureRecognizer firing this event
        act - The user's preferred action. For information on allowable values, see the class description for DragGestureEvent
        ori - The origin of the drag
        evs - The List of events that comprise the gesture

        Throws:
        IllegalArgumentException - if any parameter equals null
        IllegalArgumentException - if the act parameter does not comply with the values given in the class description for DragGestureEvent
        See Also:
        DnDConstants

    • Method Detail

      • getSourceAsDragGestureRecognizer

        public DragGestureRecognizer getSourceAsDragGestureRecognizer()
        Returns the source as a DragGestureRecognizer.

        Returns:
        the source as a DragGestureRecognizer

      • getComponent

        public Component getComponent()
        Returns the Component associated with this DragGestureEvent.

        Returns:
        the Component

      • getDragSource

        public DragSource getDragSource()
        Returns the DragSource.

        Returns:
        the DragSource

      • getDragOrigin

        public Point getDragOrigin()
        Returns a Point in the coordinates of the Component over which the drag originated.

        Returns:
        the Point where the drag originated in Component coords.

      • iterator

        public Iterator<InputEvent> iterator()
        Returns an Iterator for the events comprising the gesture.

        Returns:
        an Iterator for the events comprising the gesture

      • toArray

        public Object[] toArray()
        Returns an Object array of the events comprising the drag gesture.

        Returns:
        an array of the events comprising the gesture

      • toArray

        public Object[] toArray(Object[] array)
        Returns an array of the events comprising the drag gesture.

        Parameters:
        array - the array of EventObject sub(types)

        Returns:
        an array of the events comprising the gesture

      • getDragAction

        public int getDragAction()
        Returns an int representing the action selected by the user.

        Returns:
        the action selected by the user

      • getTriggerEvent

        public InputEvent getTriggerEvent()
        Returns the initial event that triggered the gesture.

        Returns:
        the first "triggering" event in the sequence of the gesture

      • startDrag

        public void startDrag(Cursor dragCursor,
             Transferable transferable)
               throws InvalidDnDOperationException
        Starts the drag operation given the Cursor for this drag operation and the Transferable representing the source data for this drag operation.
        If a null Cursor is specified no exception will be thrown and default drag cursors will be used instead.
        If a null Transferable is specified NullPointerException will be thrown.
        Parameters:
        dragCursor - The initial Cursor for this drag operation or null for the default cursor handling; see DragSourceContext for more details on the cursor handling mechanism during drag and drop
        transferable - The Transferable representing the source data for this drag operation.
        Throws:
        InvalidDnDOperationException - if the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.
        NullPointerException - if the Transferable is null
        Since:
        1.4

      • startDrag

        public void startDrag(Cursor dragCursor,
             Transferable transferable,
             DragSourceListener dsl)
               throws InvalidDnDOperationException
        Starts the drag given the initial Cursor to display, the Transferable object, and the DragSourceListener to use.

        Parameters:
        dragCursor - The initial Cursor for this drag operation or null for the default cursor handling; see DragSourceContext for more details on the cursor handling mechanism during drag and drop
        transferable - The source's Transferable
        dsl - The source's DragSourceListener

        Throws:
        InvalidDnDOperationException - if the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.

      • startDrag

        public void startDrag(Cursor dragCursor,
             Image dragImage,
             Point imageOffset,
             Transferable transferable,
             DragSourceListener dsl)
               throws InvalidDnDOperationException
        Start the drag given the initial Cursor to display, a drag Image, the offset of the Image, the Transferable object, and the DragSourceListener to use.

        Parameters:
        dragCursor - The initial Cursor for this drag operation or null for the default cursor handling; see DragSourceContext for more details on the cursor handling mechanism during drag and drop
        dragImage - The source's dragImage
        imageOffset - The dragImage's offset
        transferable - The source's Transferable
        dsl - The source's DragSourceListener

        Throws:
        InvalidDnDOperationException - if the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/awt/dnd/DragGestureEvent.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.

Inhoudsopgave Haut