JavaTM 2 Platform
Standard Ed. 5.0

java.awt.dnd
类 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, 序列化表格

字段摘要
 
从类 java.awt.dnd.DragGestureRecognizer 继承的字段
component, dragGestureListener, dragSource, events, sourceActions
 
构造方法摘要
protected MouseDragGestureRecognizer(DragSource ds)
          给出 ComponentDragSource,构造一个新的 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
 
方法摘要
 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 的 Listener 和 Component
protected  void unregisterListeners()
          取消注册此 DragGestureRecognizer 的 Listener 和 Component 子类必须重写此方法:
 
从类 java.awt.dnd.DragGestureRecognizer 继承的方法
addDragGestureListener, appendEvent, fireDragGestureRecognized, getComponent, getDragSource, getSourceActions, getTriggerEvent, removeDragGestureListener, resetRecognizer, setComponent, setSourceActions
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

MouseDragGestureRecognizer

protected MouseDragGestureRecognizer(DragSource ds,
                                     Component c,
                                     int act,
                                     DragGestureListener dgl)
给出 Component c 的 DragSource、要观察的 Component、此拖动操作允许的操作,以及检测到拖动动作时发出通知的 DragGestureListener,构造一个新的 MouseDragGestureRecognizer

参数:
ds - Component c 的 DragSource
c - 要观察的 Component
act - 此拖动操作允许的操作
dgl - 检测到拖动时发出通知的 DragGestureListener

MouseDragGestureRecognizer

protected MouseDragGestureRecognizer(DragSource ds,
                                     Component c,
                                     int act)
给出 Component c 的 DragSource、要观察的 Component,以及此拖动操作允许的操作,构造一个新的 MouseDragGestureRecognizer

参数:
ds - Component c 的 DragSource
c - 要观察的 Component
act - 此拖动操作允许的操作

MouseDragGestureRecognizer

protected MouseDragGestureRecognizer(DragSource ds,
                                     Component c)
给出 Component c 的 DragSource、要观察的 Component,构造一个新的 MouseDragGestureRecognizer

参数:
ds - Component c 的 DragSource
c - 要观察的 Component

MouseDragGestureRecognizer

protected MouseDragGestureRecognizer(DragSource ds)
给出 ComponentDragSource,构造一个新的 MouseDragGestureRecognizer

参数:
ds - Component 的 DragSource
方法详细信息

registerListeners

protected void registerListeners()
注册此 DragGestureRecognizer 的 Listener 和 Component

指定者:
DragGestureRecognizer 中的 registerListeners

unregisterListeners

protected void unregisterListeners()
取消注册此 DragGestureRecognizer 的 Listener 和 Component 子类必须重写此方法:

指定者:
DragGestureRecognizer 中的 unregisterListeners

mouseClicked

public void mouseClicked(MouseEvent e)
鼠标在组件上单击时调用。

指定者:
接口 MouseListener 中的 mouseClicked
参数:
e - MouseEvent

mousePressed

public void mousePressed(MouseEvent e)
鼠标按钮在 Component 上按下时调用。

指定者:
接口 MouseListener 中的 mousePressed
参数:
e - MouseEvent

mouseReleased

public void mouseReleased(MouseEvent e)
鼠标按钮在组件上释放时调用。

指定者:
接口 MouseListener 中的 mouseReleased
参数:
e - MouseEvent

mouseEntered

public void mouseEntered(MouseEvent e)
鼠标移动到组件上时调用。

指定者:
接口 MouseListener 中的 mouseEntered
参数:
e - MouseEvent

mouseExited

public void mouseExited(MouseEvent e)
鼠标离开组件时调用。

指定者:
接口 MouseListener 中的 mouseExited
参数:
e - MouseEvent

mouseDragged

public void mouseDragged(MouseEvent e)
鼠标按钮在组件上按下时调用。

指定者:
接口 MouseMotionListener 中的 mouseDragged
参数:
e - MouseEvent

mouseMoved

public void mouseMoved(MouseEvent e)
鼠标按钮在组件上移动(无按钮按下)时调用。

指定者:
接口 MouseMotionListener 中的 mouseMoved
参数:
e - MouseEvent

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策