javatm platform
standard ed. 6

java.awt.event
类 mouseevent

java.lang.object 继承者 java.util.eventobject 继承者 java.awt.awtevent   继承者 java.awt.event.componentevent   继承者 java.awt.event.inputevent   继承者 java.awt.event.mouseevent
所有《suǒ yǒu》已实现的接口:
serializable
直接已知子类:
menudragmouseevent, mousewheelevent

public class mouseevent
extends inputevent

指示组件中发生《occasionally occurred》鼠标动作的事件。当且仅当动作发生《occasionally occurred》时鼠标光标处于特定组件边界未被遮掩的部分上,才认为在该组件上发生了鼠标动作。对于轻量级组件,比如 swing 的组件,当在某个组件上启用某个鼠标事件类型之后,此类鼠标事件仅被指派给该组件。通过将适当的基于鼠标的 eventlistener 添加到组件(mouselistenermousemotionlistener),或者通过调用带有适当掩码参数(awtevent.mouse_event_maskawtevent.mouse_motion_event_mask)的 component.enableevents(long),可以《 kě yǐ》启用鼠标事件类型。如果没有对组件启用鼠标事件类型,则相应的鼠标事件将被指派给启用了鼠标事件类型的第一个祖先组件。

例如,如果已经《have been》将 mouselistener 添加到某一组件,或者已经《have been》调用 enableevents(awtevent.mouse_event_mask),则由 mouselistener 定义的所有事件都将指派给该组件。另一方面,如果没有添加 mousemotionlistener 并且没有调用带 awtevent.mouse_motion_event_mask 参数的 enableevents,则鼠标移动事件不会被指派到该组件。这些鼠标移动事件将被指派给启用了鼠标移动事件的第一个祖先组件。

对于以下动作,组件对象将生成此低级别事件:

mouseevent 对象被传递给每一个 mouselistenermouseadapter 对象,这些对象使用组件的 addmouselistener 方法注册,以接收“感《sense》兴趣的”鼠标事件。(mouseadapter 对象实现 mouselistener 接口。)每个此类侦听器对象都获得包含鼠标事件的 mouseevent

mouseevent 对象还传递给每一个 mousemotionlistenermousemotionadapter 对象,这些对象使用组件的 addmousemotionlistener 方法注册,以接收鼠标移动事件。(mousemotionadapter 对象实现 mousemotionlistener 接口。)每个此类侦听器对象都获得包含鼠标移动事件的 mouseevent

当单击鼠标按键时,将生成事件并发送给已注册的 mouselistener。可以《 kě yǐ》使用 inputevent.getmodifiers()inputevent.getmodifiersex() 方法检索模式键的状态。inputevent.getmodifiers() 返回的按键掩码只反映改变了状态的按键,没有反映所有按键的当前状态。(注:由于《yóu yú》 alt_mask/button2_mask 和 meta_mask/button3_mask 的值是重叠的,所以对于涉及修改键的鼠标事件并不总是正确的。)要获得所有按键和修改键的状态,请使用 inputevent.getmodifiersex()getbutton() 返回改变了状态的鼠标按键。

例如,如果按下了第一个鼠标按键,则以下列顺序发送事件:

  id   修饰符    按键   mouse_pressed: button1_mask button1  mouse_released: button1_mask button1  mouse_clicked: button1_mask button1 
按下多个鼠标按键时,每次按下、释放和单击按键都会生成一个独立的事件。

例如,如果用户按下按键 1 后按下按键 2,然后以相同的顺序释放它们,则将生成下列事件序列:

  id   修饰符    按键   mouse_pressed: button1_mask button1  mouse_pressed: button2_mask button2  mouse_released: button1_mask button1  mouse_clicked: button1_mask button1  mouse_released: button2_mask button2  mouse_clicked: button2_mask button2 
如果先释放按键 2,则先出现《chū xiàn》 button2_maskmouse_released/mouse_clicked 对,然后是 button1_mask 对。

在释放鼠标按键前,mouse_dragged 事件将被传递到鼠标按键按下时所在的 component(无论鼠标位置《wèi zhi》当前是否处于 component 的边界内)。由于《yóu yú》拖放实现与平台有关,所以在本机拖放操作期间可能《would》不传递 mouse_dragged 事件。在多屏幕环境中,即使鼠标位置《wèi zhi》在与 component 关联的 graphicsconfiguration 边界之外,也会将鼠标拖动事件传递给该 component。但是《But》,在这种情况下报告的鼠标拖动事件位置可能《would》与实际的鼠标位置不同:

从以下版本开始《appeared》:
1.1
另请参见:
mouseadapter,mouselistener,mousemotionadapter,mousemotionlistener,mousewheellistener,tutorial: writing a mouse listener,tutorial: writing a mouse motion listener,序列化表格

字段摘要
static intbutton1
          指示鼠标按键 #1;由 getbutton() 使用。
static intbutton2
          指示鼠标按键 #2;由 getbutton() 使用。
static intbutton3
          指示鼠标按键 #3;由 getbutton() 使用。
static intmouse_clicked
          “鼠标单击”事件。
static intmouse_dragged
          “鼠标拖动”事件。
static intmouse_entered
          “鼠标进入”事件。
static intmouse_exited
          “鼠标离开《absence》”事件。
static intmouse_firstjs随机数
          用于鼠标事件的 id 范围的起始编号。
static intmouse_last
          用于鼠标事件的 id 范围的结束《jié shù》编号。
static intmouse_moved
          “鼠标移动”事件。
static intmouse_pressed
          “鼠标按下”事件。
static intmouse_released
          “鼠标释放”事件。
static intmouse_wheel
          “鼠标滚轮”事件。
static intnobutton
          指示没有鼠标按键,由 getbutton() 使用。
 
从类 java.awt.event.inputevent 继承的字段
alt_down_mask, alt_graph_down_mask, alt_graph_mask, alt_mask, button1_down_mask, button1_mask, button2_down_mask, button2_mask, button3_down_mask, button3_mask, ctrl_down_mask, ctrl_mask, meta_down_mask, meta_mask, shift_down_mask, shift_mask
 
从类 java.awt.event.componentevent 继承的字段
component_first, component_hidden, component_last, component_moved, component_resized, component_shown
 
从类 java.awt.awtevent 继承的字段
action_event_mask, adjustment_event_mask, component_event_mask, consumed, container_event_mask, focus_event_mask, hierarchy_bounds_event_mask, hierarchy_event_mask, id, input_method_event_mask, invocation_event_mask, item_event_mask, key_event_mask, mouse_event_mask, mouse_motion_event_mask, mouse_wheel_event_mask, paint_event_mask, reserved_id_max, text_event_mask, window_event_mask, window_focus_event_mask, window_state_event_mask
 
从类 java.util.eventobject 继承的字段
source
 
构造方法摘要
mouseevent(component source,int id,long when,int modifiers,int x,int y,int clickcount,boolean popuptrigger)
          构造一个具有指定源组件、类型、修饰符、坐标和单击计数的 mouseevent 对象。
mouseevent(component source,int id,long when,int modifiers,int x,int y,int clickcount,boolean popuptrigger,int button)
          构造一个具有指定源组件、类型、修饰符、坐标和单击计数的 mouseevent 对象。
mouseevent(component source,int id,long when,int modifiers,int x,int y,int xabs,int yabs,int clickcount,boolean popuptrigger,int button)
          构造一个具有指定源组件、类型、修饰符、相对坐标、绝对坐标和单击计数的 mouseevent 对象。
 
方法摘要
 intgetbutton()
          返回更改了状态的鼠标按键(如果有)。
 intgetclickcount()
          返回与此事件关联的鼠标单击次数。
 pointgetlocationonscreen()
          返回事件的绝对 x, y 坐标。
static stringgetmousemodifierstext(int modifiers)
          返回一个描述事件期间所按下的修改键和鼠标按键(如“shift”或“ctrl+shift”)的 string
 pointgetpoint()
          返回事件相对于源组件的 x, y 坐标。
 intgetx()
          返回事件相对于源组件的水平 x 坐标。
 intgetxonscreen()
          返回事件的绝对水平 x 坐标。
 intgety()
          返回事件相对于源组件的垂直 y 坐标。
 intgetyonscreen()
          返回事件的绝对垂直 y 坐标。
 booleanispopuptrigger()
          返回此鼠标事件是否为该平台的弹出菜单触发事件。
 stringparamstring()
          返回标识此事件的参数字符串。
 voidtranslatepoint(int x,int y)
          通过将事件坐标加上指定的 x(水平)和 y(垂直)偏移量,将事件的坐标平移到新位置。
 
从类 java.awt.event.inputevent 继承的方法
consume, getmodifiers, getmodifiersex, getmodifiersextext, getwhen, isaltdown
政大地政系教授徐世荣在脸书分享日本《rì běn》东京附近的农田照片,他说,农田间看不见
,大家的想像力太丰富;而未来悠游卡公司股权如果?癜牍朊裼?绞剑?欠窕岢鑫侍狻秄oul-ups》?柯则说?苯荻?鲁ず爻碌?⒂朴慰?毓晒?径林向恺两位大老都表示,这需要时间研究,之后再思考这个问题《foul-ups》
中央造币厂指出,此次招募的雕塑设计人员须国内外公私立大学(含)以上学校《xué xiào》艺术相关院、系、组、所、学位学程毕业,具有学士以上学位证书者
蔡英文《yīng wén》表示,马英九八年前开的募兵制政策支票《piào》,如今确定跳票《piào》,多年来造成战力流失,民众对国军失去信心,身为三军统率却如此轻率,她庆幸国防部在募兵制上紧急煞车,民进党方面,提出改良募兵制度《attitudes》,对人才《牛B人物》要珍惜跟善用,人才《牛B人物》在军中要有所培养,未来生涯可以跟社会接轨,此外也有助于投身军旅的诱因
据了解,与尹衍?潘赜薪磺榈牧⒎ㄔ撼ね踅鹌降弥在北京送医时相当惊讶,并立刻《gogo》询问旁人病情;他也证实,尹衍5月间曾经受伤
经济《jīng jì》部长邓振中指出,此次对海外招商锁定4G通讯、离岸风力发电、电动客货车辆、半导体设备、电子材料、观光休闲、零售、生技医药、资讯服务《services》等产业,是因为盘点后发现,相关投资商机在未来5年内将高达1
就经济《jīng jì》、工业科技及服务《services》业的发展而言,日本《rì běn》应该《yīng gāi》是比台湾《tái wān》还先进,但是《But》,他们更是努力想把农业保留下来,至今其粮食自给率约是40%,约比台湾《tái wān》多出10%左右
入口是意外淡却迷人的花生香,这让蛋和土司的甜香能有发挥的空间,外微黏、里软化的口感也够水?剩?钆漭果酱一酸一甜倒也合宜
, isaltgraphdown, isconsumed, iscontroldown, ismetadown, isshiftdown
 
从类 java.awt.event.componentevent 继承的方法
getcomponent
 
从类 java.awt.awtevent 继承的方法
getid, setsource, tostring
 
从类 java.util.eventobject 继承的方法
getsource
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait
 

字段详细信息

mouse_first

public static final int mouse_first
用于鼠标事件的 id 范围的起始编号。

另请参见:
常量字段值

mouse_last

public static final int mouse_last
用于鼠标事件的 id 范围的结束《jié shù》编号。

另请参见:
常量字段值

mouse_clicked

public static final int mouse_clicked
“鼠标单击”事件。按下并释放鼠标按键时产生此 mouseevent

另请参见:
常量字段值

mouse_pressed

public static final int mouse_pressed
“鼠标按下”事件。按下鼠标按键时产生此 mouseevent

另请参见:
常量字段值

mouse_released

public static final int mouse_released
“鼠标释放”事件。松开鼠标按键时产生此 mouseevent

另请参见:
常量字段值

mouse_moved

public static final int mouse_moved
“鼠标移动”事件。鼠标位置改变时产生此 mouseevent

另请参见:
常量字段值

mouse_entered

public static final int mouse_entered
“鼠标进入”事件。鼠标光标进入组件几何形状的未遮掩部分时产生此 mouseevent

另请参见:
常量字段值

mouse_exited

public static final int mouse_exited
“鼠标离开”事件。鼠标光标离开组件几何形状的未遮掩部分时产生此 mouseevent

另请参见:
常量字段值

mouse_dragged

public static final int mouse_dragged
“鼠标拖动”事件。鼠标按键处于被按下状态中更改鼠标位置时产生此 mouseevent

另请参见:
常量字段值

mouse_wheel

public static final int mouse_wheel
“鼠标滚轮”事件。这是惟一的 mousewheelevent。带有滚轮的鼠标在滚轮旋转时产生此事件。

从以下版本开始《appeared》:
1.4
另请参见:
常量字段值

nobutton

public static final int nobutton
指示没有鼠标按键,由 getbutton() 使用。

从以下版本开始:
1.4
另请参见:
常量字段值

button1

public static final int button1
指示鼠标按键 #1;由 getbutton() 使用。

从以下版本开始:
1.4
另请参见:
常量字段值

button2

public static final int button2
指示鼠标按键 #2;由 getbutton() 使用。

从以下版本开始:
1.4
另请参见:
常量字段值

button3

public static final int button3
指示鼠标按键 #3;由 getbutton() 使用。

从以下版本开始:
1.4
另请参见:
常量字段值
构造方法详细信息

mouseevent

public mouseevent(component source,   int id,   long when,   int modifiers,   int x,   int y,   int clickcount,   boolean popuptrigger,   int button)
构造一个具有指定源组件、类型、修饰符、坐标和单击计数的 mouseevent 对象。

注意《危险信号》,传入无效 id 将导致不确定的行为。创建无效事件(例如使用多个旧的 _mask,或者使用不匹配的修饰符/按键值)将导致不确定的行为。调用形式为 mouseevent(source, id, when, modifiers, x, y, clickcount, popuptrigger, button) 的方法与调用 mouseevent(source, id, when, modifiers,x, y, xabs, yabs, clickcount, popuptrigger, button) 完全《wán quán》相同,其中 xabs 和 yabs 定义为屏幕上源组件的位置加上相对坐标 x 和 y。如果没有显示源组件,则 xabs 和 yabs 被设置为 0。如果 sourcenull,则此方法抛出 illegalargumentexception

参数:
source - 产生该事件的 component
id - 标识事件的整数
when - 给出事件发生时间的 long int 值
modifiers - 事件期间按下的修改键(如 shift、ctrl、alt、meta)。应该《yīng gāi》使用扩展的 _down_mask 修饰符或旧的 _mask 修饰符,但是在一个事件中不应混用两种模型。首选扩展的修饰符。
x - 鼠标位置的水平 x 坐标
y - 鼠标位置的垂直 y 坐标
clickcount - 与事件关联的鼠标单击次数
popuptrigger - 一个 boolean 值,如果此事件是某个弹出菜单的触发器,则为 true
button - 改变了状态的鼠标按键。为 nobuttonbutton1button2button3
抛出:
illegalargumentexception - 如果传入无效的 button
illegalargumentexception - 如果 source 为 null
从以下版本开始:
1.4

mouseevent

public mouseevent(component source,   int id,   long when,   int modifiers,   int x,   int y,   int clickcount,   boolean popuptrigger)
构造一个具有指定源组件、类型、修饰符、坐标和单击计数的 mouseevent 对象。

注意《危险信号》,传入无效 id 将导致不确定的行为。调用形式为 mouseevent(source, id, when, modifiers, x, y, clickcount, popuptrigger) 的方法所产生的效果与调用 mouseevent(source, id, when, modifiers,x, y, xabs, yabs, clickcount, popuptrigger, mouseevent.nobutton) 完全《wán quán》相同,其中 xabs 和 yabs 定义为屏幕上原点的位置加上相对坐标 x 和 y。如果没有显示原点,则 xabs 和 yabs 被设置为零。如果 sourcenull,则此方法将抛出 illegalargumentexception

参数:
source - 产生该事件的 component
id - 标识事件的整数
when - 给出事件发生时间的 long int 值
modifiers - 发生事件期间按下的修改键(例如 shift、ctrl、alt 和 meta),应该使用扩展的 _down_mask 修饰符或旧的 _mask 修饰符,但是在一个事件中不应混用两种模型。首选扩展的修饰符。
x - 鼠标位置的水平 x 坐标
y - 鼠标位置的垂直 y 坐标
clickcount - 与该事件有关的鼠标单击次数
popuptrigger - 一个 boolean 值,如此事件是某个弹出菜单的触发器,则该参数为 true
抛出:
illegalargumentexceptionjs随机数 - 如果 source 为 null

mouseevent

public mouseevent(component source,   int id,   long when,   int modifiers,   int x,   int y,   int xabs,   int yabs,   int clickcount,   boolean popuptrigger,   int button)
构造一个具有指定源组件、类型、修饰符、相对坐标、绝对坐标和单击计数的 mouseevent 对象。

注意,传入无效 id 将导致不确定的行为。创建无效事件(比如使用多个旧的 _mask,或者使用不匹配的修饰符/按钮值)将导致不确定的行为。即使将不一致的相对坐标值和绝对坐标值传递给构造方法,仍然会创建鼠标事件实例,并且不抛出任何异常。如果 sourcenull,则此方法抛出 illegalargumentexception

参数:
source - 产生该事件的 component
id - 标识事件的整数
when - 给出事件发生时间的 long int 值
modifiers - 事件期间按下的修改键(如 shift、ctrl、alt、meta)。应该使用扩展的 _down_mask 修饰符或旧的 _mask 修饰符,但是在一个事件中不应混用两种模型。首选扩展的修饰符。
x - 鼠标位置的水平 x 坐标
y - 鼠标位置的垂直 y 坐标
xabs - 鼠标位置的绝对水平 x 坐标
yabs - 鼠标位置的绝对垂直 y 坐标
clickcount - 与事件关联的鼠标单击次数
popuptrigger - 一个 boolean 值,如果此事件是某个弹出菜单的触发器,则为 true
button - 更改了状态的鼠标按键。该参数为 nobuttonbutton1button2button3
抛出:
illegalargumentexception - 如果传入无效的 button
illegalargumentexception - 如果 source 为 null
从以下版本开始:
1.6
方法详细信息

getlocationonscreen

public point getlocationonscreen()
返回事件的绝对 x, y 坐标。在虚拟设备多屏幕环境中,桌面区域《regional》可以跨越多个物理屏幕设备,这些坐标相对于虚拟坐标系。否则,这些坐标相对于与 component 的 graphicsconfiguration 关联的坐标系。

返回:
包含绝对 x 坐标和绝对 y 坐标的 point网站地图 手机端 对象。
从以下版本开始:
1.6
另请参见:
graphicsconfiguration

getxonscreen

public int getxonscreen()
返回事件的绝对水平 x 坐标。在虚拟设备多屏幕环境中,桌面区域《regional》可以跨越多个物理屏幕设备,这些坐标相对于虚拟坐标系。否则,这些坐标相对于与 component 的 graphicsconfiguration 关联的坐标系。

返回:
x 表示绝对水平位置的整数。
从以下版本开始:
1.6
另请参见:
graphicsconfiguration

getyonscreen

public int getyonscreen()
返回事件的绝对垂直 y 坐标。在虚拟设备多屏幕环境中,桌面区域可以跨越多个物理屏幕设备,这些坐标相对于虚拟坐标系。否则,这些坐标相对于与 component 的 graphicsconfiguration 关联的坐标系。

返回:
y 表示绝对垂直位置的整数。
从以下版本开始:
1.6
另请参见:
graphicsconfiguration

getx

public int getx()
返回事件相对于源组件的水平 x 坐标。

返回:
一个整数 x,指示相对于组件的水平位置

gety

public int gety()
返回事件相对于源组件的垂直 y 坐标。

返回:
一个整数 y,指示相对于组件的垂直位置

getpoint

public point getpoint()
返回事件相对于源组件的 x, y 坐标。

返回:
一个 point 对象,包含相对于源组件的 x 和 y 坐标

translatepoint

public void translatepoint(int x,      int y)
通过将事件坐标加上指定的 x(水平)和 y(垂直)偏移量,将事件的坐标平移到新位置。

参数:
x - 与当前 x 坐标位置相加的水平 x 值
y - 与当前 y 坐标位置相加的垂直 y 值

getclickcount

public int getclickcount()
返回与此事件关联的鼠标单击次数。

返回:
单击次数的整数值

getbutton

public int getbutton()
返回更改了状态的鼠标按键(如果有)。

返回:
以下常量之一:nobuttonbutton1button2button3
从以下版本开始:
1.4

ispopuptrigger

public boolean ispopuptrigger()
返回此鼠标事件是否为该平台的弹出菜单触发事件。

:在不同系统上弹出菜单的触发方式不同。因此《therefore》,为了正确实现跨平台功能,在 mousereleasedmousepressed 中都应检查 ispopuptrigger

返回:
一个 boolean 值,如果此事件是此平台的弹出菜单触发器,则为 true

getmousemodifierstext

public static string getmousemodifierstext(int modifiers)
返回一个描述事件期间所按下的修改键和鼠标按键(如“shift”或“ctrl+shift”)的 string。通过更改 awt.properties 文件可以本地化这些字符串。

注意,inputevent.alt_maskinputevent.button2_mask 具有相同的值,所以这两个修饰符都返回字符串“alt”。同样,inputevent.meta_maskinputevent.button3_mask 具有相同的值,所以这两个修饰符都返回字符串“meta”。

参数:
modifiers - 描述事件期间所按下的修改键和鼠标按键的修饰符掩码
返回:
一个 string,描述事件期间所按下的修改键和鼠标按钮的文本描述
从以下版本开始:
1.4
另请参见:
inputevent.getmodifiersextext(int)

paramstring

public string paramstring()
返回标识此事件的参数字符串。此方法对于事件记录《jì lù》和调试很有用。

覆盖:
componentevent 中的 paramstring
返回:
标识事件及其属性的字符串

javatm platform
standard ed. 6

提交错误或意见《yì jian》
有关更多的 api 参考资料和开发《kāi fā》人员文档,请参阅 java se 开发《kāi fā》人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作《gōng zuò》代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策