Module java.desktop

Package java.awt.dnd

Class MouseDragGestureRecognizer

java.lang.Object

java.awt.dnd.DragGestureRecognizer

java.awt.dnd.MouseDragGestureRecognizer

所有已实现的接口:

MouseListener, MouseMotionListener, Serializable, EventListener

       public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer implements MouseListener, MouseMotionListener
      

这个抽象的DragGestureRecognizer子类定义了一个基于鼠标手势的DragGestureRecognizer。每个平台都实现了自己的这个类的具体子类，可以通过Toolkit.createDragGestureRecognizer()方法获得，以封装识别启动拖放操作的平台相关鼠标手势。

鼠标拖动手势识别器应该遵守拖动手势运动阈值，可以通过DragSource.getDragThreshold()获得。只有当最新的鼠标拖动事件的位置与相应的鼠标按下事件的位置之间的水平或垂直方向距离大于拖动手势运动阈值时，才应该识别拖动手势。

使用DragSource.createDefaultDragGestureRecognizer(java.awt.Component, int, java.awt.dnd.DragGestureListener)创建的拖动手势识别器遵循这个约定。

参见:

• DragGestureListener
• DragGestureEvent
• DragSource
• 序列化形式

Field Summary

Fields declared in class java.awt.dnd.DragGestureRecognizer

component, dragGestureListener, dragSource, events, sourceActions

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MouseDragGestureRecognizer(DragSource ds)	给定Component的DragSource，构造一个新的MouseDragGestureRecognizer。
protected	MouseDragGestureRecognizer(DragSource ds, Component c)	给定Component c的DragSource，以及要观察的Component，构造一个新的MouseDragGestureRecognizer。
protected	MouseDragGestureRecognizer(DragSource ds, Component c, int act)	给定Component c的DragSource，要观察的Component，以及允许此拖动操作的操作，构造一个新的MouseDragGestureRecognizer。
protected	MouseDragGestureRecognizer(DragSource ds, Component c, int act, DragGestureListener dgl)	给定Component c的DragSource，要观察的Component，允许此拖动操作的操作，以及在检测到拖动手势时通知的DragGestureListener，构造一个新的MouseDragGestureRecognizer。

Method Summary

Modifier and Type	Method	Description
void	mouseClicked(MouseEvent e)	当鼠标在组件上单击时调用。
void	mouseDragged(MouseEvent e)	当鼠标在组件上按下鼠标按钮时调用。
void	mouseEntered(MouseEvent e)	当鼠标进入组件时调用。
void	mouseExited(MouseEvent e)	当鼠标退出组件时调用。
void	mouseMoved(MouseEvent e)	当鼠标在组件上移动鼠标按钮（没有按下任何按钮）时调用。
void	mousePressed(MouseEvent e)	当鼠标在Component上按下鼠标按钮时调用。
void	mouseReleased(MouseEvent e)	当鼠标在组件上释放鼠标按钮时调用。
protected void	registerListeners()	使用组件注册此DragGestureRecognizer的监听器
protected void	unregisterListeners()	使用组件取消注册此DragGestureRecognizer的监听器，子类必须重写此方法

Methods declared in class java.awt.dnd.DragGestureRecognizer

addDragGestureListener, appendEvent, fireDragGestureRecognized, getComponent, getDragSource, getSourceActions, getTriggerEvent, removeDragGestureListener, resetRecognizer, setComponent, setSourceActions

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MouseDragGestureRecognizer

             protected MouseDragGestureRecognizer(DragSource ds, Component c, int act, DragGestureListener dgl)
            

给定Component c的DragSource，要观察的Component，允许此拖动操作的操作，以及在检测到拖动手势时通知的DragGestureListener，构造一个新的MouseDragGestureRecognizer。

参数:

ds - 组件c的DragSource

c - 要观察的组件

act - 允许此拖动的操作

dgl - 当检测到手势时通知的DragGestureListener

MouseDragGestureRecognizer

             protected MouseDragGestureRecognizer(DragSource ds, Component c, int act)
            

给定Component c的DragSource，要观察的Component，以及允许此拖动操作的操作，构造一个新的MouseDragGestureRecognizer。

参数:

ds - 组件c的DragSource

c - 要观察的组件

act - 允许此拖动的操作

MouseDragGestureRecognizer

             protected MouseDragGestureRecognizer(DragSource ds, Component c)
            

给定Component c的DragSource，以及要观察的Component，构造一个新的MouseDragGestureRecognizer。

参数:

ds - 组件c的DragSource

c - 要观察的组件

MouseDragGestureRecognizer

             protected MouseDragGestureRecognizer(DragSource ds)
            

给定Component的DragSource，构造一个新的MouseDragGestureRecognizer。

参数:

ds - 组件的DragSource

Method Details

registerListeners

             protected void registerListeners()
            

使用组件注册此DragGestureRecognizer的监听器

指定者:

registerListeners 在类 DragGestureRecognizer中

unregisterListeners

             protected void unregisterListeners()
            

使用组件取消注册此DragGestureRecognizer的监听器，子类必须重写此方法

指定者:

unregisterListeners 在类 DragGestureRecognizer中

mouseClicked

             public void mouseClicked(MouseEvent e)
            

当鼠标在组件上单击时调用。

指定者:

mouseClicked 在接口 MouseListener中

参数:

e - MouseEvent

mousePressed

             public void mousePressed(MouseEvent e)
            

当鼠标在Component上按下鼠标按钮时调用。

指定者:

mousePressed 在接口 MouseListener中

参数:

e - MouseEvent

mouseReleased

             public void mouseReleased(MouseEvent e)
            

当鼠标在组件上释放鼠标按钮时调用。

指定者:

mouseReleased 在接口 MouseListener中

参数:

e - MouseEvent

mouseEntered

             public void mouseEntered(MouseEvent e)
            

当鼠标进入组件时调用。

指定者:

mouseEntered 在接口 MouseListener中

参数:

e - MouseEvent

mouseExited

             public void mouseExited(MouseEvent e)
            

当鼠标退出组件时调用。

指定者:

mouseExited 在接口 MouseListener中

参数:

e - MouseEvent

mouseDragged

             public void mouseDragged(MouseEvent e)
            

当鼠标在组件上按下鼠标按钮时调用。

指定者:

mouseDragged 在接口 MouseMotionListener中

参数:

e - MouseEvent

mouseMoved

             public void mouseMoved(MouseEvent e)
            

当鼠标在组件上移动鼠标按钮（没有按下任何按钮）时调用。

指定者:

mouseMoved 在接口 MouseMotionListener中

参数:

e - MouseEvent