Geen cache-versie.

Caching uitgeschakeld. Standaardinstelling voor deze pagina:ingeschakeld (code LNG204)
Als het scherm te langzaam is, kunt u de gebruikersmodus uitschakelen om de cacheversie te bekijken.
java.awt.dnd

Class DragGestureRecognizer

  • All Implemented Interfaces:
    Serializable
    Direct Known Subclasses:
    MouseDragGestureRecognizer

    public abstract class DragGestureRecognizer
    extends Object
    implements Serializable
    The DragGestureRecognizer is an abstract base class for the specification of a platform-dependent listener that can be associated with a particular Component in order to identify platform-dependent drag initiating gestures.

    The appropriate DragGestureRecognizer subclass instance is obtained from the DragSource asssociated with a particular Component, or from the Toolkit object via its createDragGestureRecognizer() method.

    Once the DragGestureRecognizer is associated with a particular Component it will register the appropriate listener interfaces on that Component in order to track the input events delivered to the Component.

    Once the DragGestureRecognizer identifies a sequence of events on the Component as a drag initiating gesture, it will notify its unicast DragGestureListener by invoking its gestureRecognized() method.

    When a concrete DragGestureRecognizer instance detects a drag initiating gesture on the Component it is associated with, it fires a DragGestureEvent to the DragGestureListener registered on its unicast event source for DragGestureListener events. This DragGestureListener is responsible for causing the associated DragSource to start the Drag and Drop operation (if appropriate).

    See Also:
    DragGestureListener, DragGestureEvent, DragSource, Serialized Form
    • Constructor Summary

      Constructors 
      Modifier Constructor and Description
      protected DragGestureRecognizer(DragSource ds)
      Construct a new DragGestureRecognizer given the DragSource to be used in this Drag and Drop operation.
      protected DragGestureRecognizer(DragSource ds, Component c)
      Construct a new DragGestureRecognizer given the DragSource to be used in this Drag and Drop operation, and the Component this DragGestureRecognizer should "observe" for drag initiating gestures.
      protected DragGestureRecognizer(DragSource ds, Component c, int sa)
      Construct a new DragGestureRecognizer given the DragSource to be used in this Drag and Drop operation, the Component this DragGestureRecognizer should "observe" for drag initiating gestures, and the action(s) supported for this Drag and Drop operation.
      protected DragGestureRecognizer(DragSource ds, Component c, int sa, DragGestureListener dgl)
      Construct a new DragGestureRecognizer given the DragSource to be used in this Drag and Drop operation, the Component this DragGestureRecognizer should "observe" for drag initiating gestures, the action(s) supported for this Drag and Drop operation, and the DragGestureListener to notify once a drag initiating gesture has been detected.

      Eerste pagina van API Java Inhoudsopgave Haut

    • Field Detail

      • dragSource

        protected DragSource dragSource
        The DragSource associated with this DragGestureRecognizer.
      • component

        protected Component component
        The Component associated with this DragGestureRecognizer.
      • dragGestureListener

        protected transient DragGestureListener dragGestureListener
        The DragGestureListener associated with this DragGestureRecognizer.
      • sourceActions

        protected int sourceActions
        An int representing the type(s) of action(s) used in this Drag and Drop operation.
      • events

        protected ArrayList<InputEvent> events
        The list of events (in order) that the DragGestureRecognizer "recognized" as a "gesture" that triggers a drag.
    • Constructor Detail

      • DragGestureRecognizer

        protected DragGestureRecognizer(DragSource ds,
                             Component c,
                             int sa,
                             DragGestureListener dgl)
        Construct a new DragGestureRecognizer given the DragSource to be used in this Drag and Drop operation, the Component this DragGestureRecognizer should "observe" for drag initiating gestures, the action(s) supported for this Drag and Drop operation, and the DragGestureListener to notify once a drag initiating gesture has been detected.

        Parameters:
        ds - the DragSource this DragGestureRecognizer will use to process the Drag and Drop operation
        c - the Component this DragGestureRecognizer should "observe" the event stream to, in order to detect a drag initiating gesture. If this value is null, the DragGestureRecognizer is not associated with any Component.
        sa - the set (logical OR) of the DnDConstants that this Drag and Drop operation will support
        dgl - the DragGestureRecognizer to notify when a drag gesture is detected

        Throws:
        IllegalArgumentException - if ds is null.
      • DragGestureRecognizer

        protected DragGestureRecognizer(DragSource ds,
                             Component c,
                             int sa)
        Construct a new DragGestureRecognizer given the DragSource to be used in this Drag and Drop operation, the Component this DragGestureRecognizer should "observe" for drag initiating gestures, and the action(s) supported for this Drag and Drop operation.

        Parameters:
        ds - the DragSource this DragGestureRecognizer will use to process the Drag and Drop operation
        c - the Component this DragGestureRecognizer should "observe" the event stream to, in order to detect a drag initiating gesture. If this value is null, the DragGestureRecognizer is not associated with any Component.
        sa - the set (logical OR) of the DnDConstants that this Drag and Drop operation will support

        Throws:
        IllegalArgumentException - if ds is null.
      • DragGestureRecognizer

        protected DragGestureRecognizer(DragSource ds,
                             Component c)
        Construct a new DragGestureRecognizer given the DragSource to be used in this Drag and Drop operation, and the Component this DragGestureRecognizer should "observe" for drag initiating gestures.

        Parameters:
        ds - the DragSource this DragGestureRecognizer will use to process the Drag and Drop operation
        c - the Component this DragGestureRecognizer should "observe" the event stream to, in order to detect a drag initiating gesture. If this value is null, the DragGestureRecognizer is not associated with any Component.

        Throws:
        IllegalArgumentException - if ds is null.
      • DragGestureRecognizer

        protected DragGestureRecognizer(DragSource ds)
        Construct a new DragGestureRecognizer given the DragSource to be used in this Drag and Drop operation.

        Parameters:
        ds - the DragSource this DragGestureRecognizer will use to process the Drag and Drop operation

        Throws:
        IllegalArgumentException - if ds is null.
    • Method Detail

      • registerListeners

        protected abstract void registerListeners()
        register this DragGestureRecognizer's Listeners with the Component subclasses must override this method
      • unregisterListeners

        protected abstract void unregisterListeners()
        unregister this DragGestureRecognizer's Listeners with the Component subclasses must override this method
      • getDragSource

        public DragSource getDragSource()
        This method returns the DragSource this DragGestureRecognizer will use in order to process the Drag and Drop operation.

        Returns:
        the DragSource
      • getComponent

        public Component getComponent()
        This method returns the Component that is to be "observed" by the DragGestureRecognizer for drag initiating gestures.

        Returns:
        The Component this DragGestureRecognizer is associated with
      • setComponent

        public void setComponent(Component c)
        set the Component that the DragGestureRecognizer is associated with registerListeners() and unregisterListeners() are called as a side effect as appropriate.

        Parameters:
        c - The Component or null
      • getSourceActions

        public int getSourceActions()
        This method returns an int representing the type of action(s) this Drag and Drop operation will support.

        Returns:
        the currently permitted source action(s)
      • setSourceActions

        public void setSourceActions(int actions)
        This method sets the permitted source drag action(s) for this Drag and Drop operation.

        Parameters:
        actions - the permitted source drag action(s)
      • getTriggerEvent

        public InputEvent getTriggerEvent()
        This method returns the first event in the series of events that initiated the Drag and Drop operation.

        Returns:
        the initial event that triggered the drag gesture
      • resetRecognizer

        public void resetRecognizer()
        Reset the Recognizer, if its currently recognizing a gesture, ignore it.
      • removeDragGestureListener

        public void removeDragGestureListener(DragGestureListener dgl)
        unregister the current DragGestureListener

        Parameters:
        dgl - the DragGestureListener to unregister from this DragGestureRecognizer

        Throws:
        IllegalArgumentException - if dgl is not (equal to) the currently registered DragGestureListener.
      • fireDragGestureRecognized

        protected void fireDragGestureRecognized(int dragAction,
                                     Point p)
        Notify the DragGestureListener that a Drag and Drop initiating gesture has occurred. Then reset the state of the Recognizer.

        Parameters:
        dragAction - The action initially selected by the users gesture
        p - The point (in Component coords) where the gesture originated
      • appendEvent

        protected void appendEvent(InputEvent awtie)
        Listeners registered on the Component by this Recognizer shall record all Events that are recognized as part of the series of Events that go to comprise a Drag and Drop initiating gesture via this API.

        This method is used by a DragGestureRecognizer implementation to add an InputEvent subclass (that it believes is one in a series of events that comprise a Drag and Drop operation) to the array of events that this DragGestureRecognizer maintains internally.

        Parameters:
        awtie - the InputEvent to add to this DragGestureRecognizer's internal array of events. Note that null is not a valid value, and will be ignored.

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/draggesturerecognizer.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