/* * Copyright (c) 1998, 2003, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */package java.awt.dnd;import java.awt.Component;import java.awt.event.MouseEvent;import java.awt.event.MouseListener;import java.awt.event.MouseMotionListener;/** * This abstract subclass of <code>DragGestureRecognizer</code> * defines a <code>DragGestureRecognizer</code> * for mouse-based gestures. * * Each platform implements its own concrete subclass of this class, * available via the Toolkit.createDragGestureRecognizer() method, * to encapsulate * the recognition of the platform dependent mouse gesture(s) that initiate * a Drag and Drop operation. * <p> * Mouse drag gesture recognizers should honor the * drag gesture motion threshold, available through * {@link DragSource#getDragThreshold}. * A drag gesture should be recognized only when the distance * in either the horizontal or vertical direction between * the location of the latest mouse dragged event and the * location of the corresponding mouse button pressed event * is greater than the drag gesture motion threshold. * <p> * Drag gesture recognizers created with * {@link DragSource#createDefaultDragGestureRecognizer} * follow this convention. * * @author Laurence P. G. Cable * * @see java.awt.dnd.DragGestureListener * @see java.awt.dnd.DragGestureEvent * @see java.awt.dnd.DragSource */public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer implements MouseListener, MouseMotionListener { private static final long serialVersionUID = 6220099344182281120L; /** * Construct a new <code>MouseDragGestureRecognizer</code> * given the <code>DragSource</code> for the * <code>Component</code> c, the <code>Component</code> * to observe, the action(s) * permitted for this drag operation, and * the <code>DragGestureListener</code> to * notify when a drag gesture is detected. * <P> * @param ds The DragSource for the Component c * @param c The Component to observe * @param act The actions permitted for this Drag * @param dgl The DragGestureListener to notify when a gesture is detected * */ protected MouseDragGestureRecognizer(DragSource ds, Component c, int act, DragGestureListener dgl) { super(ds, c, act, dgl); } /** * Construct a new <code>MouseDragGestureRecognizer</code> * given the <code>DragSource</code> for * the <code>Component</code> c, * the <code>Component</code> to observe, and the action(s) * permitted for this drag operation. * <P> * @param ds The DragSource for the Component c * @param c The Component to observe * @param act The actions permitted for this drag */ protected MouseDragGestureRecognizer(DragSource ds, Component c, int act) { this(ds, c, act, null); } /** * Construct a new <code>MouseDragGestureRecognizer</code> * given the <code>DragSource</code> for the * <code>Component</code> c, and the * <code>Component</code> to observe. * <P> * @param ds The DragSource for the Component c * @param c The Component to observe */ protected MouseDragGestureRecognizer(DragSource ds, Component c) { this(ds, c, DnDConstants.ACTION_NONE); } /** * Construct a new <code>MouseDragGestureRecognizer</code> * given the <code>DragSource</code> for the <code>Component</code>. * <P> * @param ds The DragSource for the Component */ protected MouseDragGestureRecognizer(DragSource ds) { this(ds, null); } /** * register this DragGestureRecognizer's Listeners with the Component */ protected void registerListeners() { component.addMouseListener(this); component.addMouseMotionListener(this); } /** * unregister this DragGestureRecognizer's Listeners with the Component * * subclasses must override this method */ protected void unregisterListeners() { component.removeMouseListener(this); component.removeMouseMotionListener(this); } /** * Invoked when the mouse has been clicked on a component. * <P> * @param e the <code>MouseEvent</code> */ public void mouseClicked(MouseEvent e) { } /** * Invoked when a mouse button has been * pressed on a <code>Component</code>. * <P> * @param e the <code>MouseEvent</code> */ public void mousePressed(MouseEvent e) { } /** * Invoked when a mouse button has been released on a component. * <P> * @param e the <code>MouseEvent</code> */ public void mouseReleased(MouseEvent e) { } /** * Invoked when the mouse enters a component. * <P> * @param e the <code>MouseEvent</code> */ public void mouseEntered(MouseEvent e) { } /** * Invoked when the mouse exits a component. * <P> * @param e the <code>MouseEvent</code> */ public void mouseExited(MouseEvent e) { } /** * Invoked when a mouse button is pressed on a component. * <P> * @param e the <code>MouseEvent</code> */ public void mouseDragged(MouseEvent e) { } /** * Invoked when the mouse button has been moved on a component * (with no buttons no down). * <P> * @param e the <code>MouseEvent</code> */ public void mouseMoved(MouseEvent e) { }}
/*
* Copyright (c) 1998, 2003, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package java.awt.dnd;
import java.awt.Component;
import java.awt.event.MouseEvent;
import java.awt.event.MouseListener;
import java.awt.event.MouseMotionListener;
/**
* This abstract subclass of <code>DragGestureRecognizer</code>
* defines a <code>DragGestureRecognizer</code>
* for mouse-based gestures.
*
* Each platform implements its own concrete subclass of this class,
* available via the Toolkit.createDragGestureRecognizer() method,
* to encapsulate
* the recognition of the platform dependent mouse gesture(s) that initiate
* a Drag and Drop operation.
* <p>
* Mouse drag gesture recognizers should honor the
* drag gesture motion threshold, available through
* {@link DragSource#getDragThreshold}.
* A drag gesture should be recognized only when the distance
* in either the horizontal or vertical direction between
* the location of the latest mouse dragged event and the
* location of the corresponding mouse button pressed event
* is greater than the drag gesture motion threshold.
* <p>
* Drag gesture recognizers created with
* {@link DragSource#createDefaultDragGestureRecognizer}
* follow this convention.
*
* @author Laurence P. G. Cable
*
* @see java.awt.dnd.DragGestureListener
* @see java.awt.dnd.DragGestureEvent
* @see java.awt.dnd.DragSource
*/
public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer implements MouseListener, MouseMotionListener {
private static final long serialVersionUID = 6220099344182281120L;
/**
* Construct a new <code>MouseDragGestureRecognizer</code>
* given the <code>DragSource</code> for the
* <code>Component</code> c, the <code>Component</code>
* to observe, the action(s)
* permitted for this drag operation, and
* the <code>DragGestureListener</code> to
* notify when a drag gesture is detected.
* <P>
* @param ds The DragSource for the Component c
* @param c The Component to observe
* @param act The actions permitted for this Drag
* @param dgl The DragGestureListener to notify when a gesture is detected
*
*/
protected MouseDragGestureRecognizer(DragSource ds, Component c, int act, DragGestureListener dgl) {
super(ds, c, act, dgl);
}
/**
* Construct a new <code>MouseDragGestureRecognizer</code>
* given the <code>DragSource</code> for
* the <code>Component</code> c,
* the <code>Component</code> to observe, and the action(s)
* permitted for this drag operation.
* <P>
* @param ds The DragSource for the Component c
* @param c The Component to observe
* @param act The actions permitted for this drag
*/
protected MouseDragGestureRecognizer(DragSource ds, Component c, int act) {
this(ds, c, act, null);
}
/**
* Construct a new <code>MouseDragGestureRecognizer</code>
* given the <code>DragSource</code> for the
* <code>Component</code> c, and the
* <code>Component</code> to observe.
* <P>
* @param ds The DragSource for the Component c
* @param c The Component to observe
*/
protected MouseDragGestureRecognizer(DragSource ds, Component c) {
this(ds, c, DnDConstants.ACTION_NONE);
}
/**
* Construct a new <code>MouseDragGestureRecognizer</code>
* given the <code>DragSource</code> for the <code>Component</code>.
* <P>
* @param ds The DragSource for the Component
*/
protected MouseDragGestureRecognizer(DragSource ds) {
this(ds, null);
}
/**
* register this DragGestureRecognizer's Listeners with the Component
*/
protected void registerListeners() {
component.addMouseListener(this);
component.addMouseMotionListener(this);
}
/**
* unregister this DragGestureRecognizer's Listeners with the Component
*
* subclasses must override this method
*/
protected void unregisterListeners() {
component.removeMouseListener(this);
component.removeMouseMotionListener(this);
}
/**
* Invoked when the mouse has been clicked on a component.
* <P>
* @param e the <code>MouseEvent</code>
*/
public void mouseClicked(MouseEvent e) { }
/**
* Invoked when a mouse button has been
* pressed on a <code>Component</code>.
* <P>
* @param e the <code>MouseEvent</code>
*/
public void mousePressed(MouseEvent e) { }
/**
* Invoked when a mouse button has been released on a component.
* <P>
* @param e the <code>MouseEvent</code>
*/
public void mouseReleased(MouseEvent e) { }
/**
* Invoked when the mouse enters a component.
* <P>
* @param e the <code>MouseEvent</code>
*/
public void mouseEntered(MouseEvent e) { }
/**
* Invoked when the mouse exits a component.
* <P>
* @param e the <code>MouseEvent</code>
*/
public void mouseExited(MouseEvent e) { }
/**
* Invoked when a mouse button is pressed on a component.
* <P>
* @param e the <code>MouseEvent</code>
*/
public void mouseDragged(MouseEvent e) { }
/**
* Invoked when the mouse button has been moved on a component
* (with no buttons no down).
* <P>
* @param e the <code>MouseEvent</code>
*/
public void mouseMoved(MouseEvent e) { }
}