- java.lang.Object
-
- java.util.EventObject
-
- java.awt.AWTEvent
-
- java.awt.event.ComponentEvent
-
- java.awt.event.InputEvent
-
- 实现的所有接口
-
Serializable
- 已知直接子类:
-
KeyEvent
,MouseEvent
public abstract class InputEvent extends ComponentEvent
所有组件级输入事件的根事件类。 输入事件在它们发起的源正常处理之前传递给侦听器。 这允许侦听器和组件子类“使用”事件,以便源不会以默认方式处理它们。 例如,在Button组件上使用mousePressed事件将阻止Button被激活。- 从以下版本开始:
- 1.1
- 另请参见:
-
KeyEvent
,KeyAdapter
,MouseEvent
,MouseAdapter
,MouseMotionAdapter
, Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 static int
ALT_DOWN_MASK
Alt键扩展修饰符常量。static int
ALT_GRAPH_DOWN_MASK
AltGraph键扩展修饰符常量。static int
ALT_GRAPH_MASK
已过时。建议改用ALT_GRAPH_DOWN_MASK和getModifiersEx()
static int
ALT_MASK
已过时。建议改用ALT_DOWN_MASK和getModifiersEx()
static int
BUTTON1_DOWN_MASK
Mouse Button1扩展修饰符常量。static int
BUTTON1_MASK
已过时。建议改用BUTTON1_DOWN_MASK和getModifiersEx()
static int
BUTTON2_DOWN_MASK
鼠标Button2扩展修饰符常量。static int
BUTTON2_MASK
已过时。建议改用 BUTTON2_DOWN_MASK和getModifiersEx()
。static int
BUTTON3_DOWN_MASK
鼠标Button3扩展修饰符常量。static int
BUTTON3_MASK
已过时。建议改用BUTTON3_DOWN_MASK和getModifiersEx()
。static int
CTRL_DOWN_MASK
Control键扩展修饰符常量。static int
CTRL_MASK
已过时。建议改用CTRL_DOWN_MASK和getModifiersEx()
static int
META_DOWN_MASK
Meta键扩展修饰符常量。static int
META_MASK
已过时。建议改用META_DOWN_MASK和getModifiersEx()
static int
SHIFT_DOWN_MASK
Shift键扩展修饰符常量。static int
SHIFT_MASK
已过时。建议改用 SHIFT_DOWN_MASK和getModifiersEx()
-
声明的属性在类 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
-
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 弃用的方法 变量和类型 方法 描述 void
consume()
使用此事件,以便由发起它的源以默认方式处理它。static int
getMaskForButton(int button)
一种获取任何现有鼠标按钮的掩码的方法。int
getModifiers()
已过时。建议使用扩展修饰键和getModifiersEx()
int
getModifiersEx()
返回此事件的扩展修饰符掩码。static String
getModifiersExText(int modifiers)
返回描述扩展修饰键和鼠标按钮的String,例如“Shift”,“Button1”或“Ctrl + Shift”。long
getWhen()
返回此事件发生的时间戳与UTC时间1970年1月1日午夜之间的差异(以毫秒为单位)。boolean
isAltDown()
返回Alt修饰符是否在此事件中失效。boolean
isAltGraphDown()
返回AltGraph修饰符是否在此事件上失效。boolean
isConsumed()
返回是否已使用此事件。boolean
isControlDown()
返回Control修饰符是否在此事件中失效。boolean
isMetaDown()
返回Meta修饰符是否在此事件中失效。boolean
isShiftDown()
返回Shift修改器是否在此事件中失效。-
声明方法的类 java.awt.event.ComponentEvent
getComponent, paramString
-
声明方法的类 java.util.EventObject
getSource
-
-
-
-
字段详细信息
-
SHIFT_MASK
@Deprecated(since="9") public static final int SHIFT_MASK
Deprecated.It is recommended that SHIFT_DOWN_MASK andgetModifiersEx()
be used insteadShift键修饰符常量。- 另请参见:
- 常数字段值
-
CTRL_MASK
@Deprecated(since="9") public static final int CTRL_MASK
Deprecated.It is recommended that CTRL_DOWN_MASK andgetModifiersEx()
be used insteadControl键修饰符常量。- 另请参见:
- 常数字段值
-
META_MASK
@Deprecated(since="9") public static final int META_MASK
Deprecated.It is recommended that META_DOWN_MASK andgetModifiersEx()
be used insteadMeta键修饰符常量。- 另请参见:
- 常数字段值
-
ALT_MASK
@Deprecated(since="9") public static final int ALT_MASK
Deprecated.It is recommended that ALT_DOWN_MASK andgetModifiersEx()
be used insteadAlt键修饰符常量。- 另请参见:
- 常数字段值
-
ALT_GRAPH_MASK
@Deprecated(since="9") public static final int ALT_GRAPH_MASK
Deprecated.It is recommended that ALT_GRAPH_DOWN_MASK andgetModifiersEx()
be used insteadAltGraph键修饰符常量。- 另请参见:
- 常数字段值
-
BUTTON1_MASK
@Deprecated(since="9") public static final int BUTTON1_MASK
Deprecated.It is recommended that BUTTON1_DOWN_MASK andgetModifiersEx()
be used insteadMouse Button1修饰符常量。- 另请参见:
- 常数字段值
-
BUTTON2_MASK
@Deprecated(since="9") public static final int BUTTON2_MASK
Deprecated.It is recommended that BUTTON2_DOWN_MASK andgetModifiersEx()
be used instead. Note that BUTTON2_MASK has the same value as ALT_MASK.Mouse Button2修饰符常量。- 另请参见:
- 常数字段值
-
BUTTON3_MASK
@Deprecated(since="9") public static final int BUTTON3_MASK
Deprecated.It is recommended that BUTTON3_DOWN_MASK andgetModifiersEx()
be used instead. Note that BUTTON3_MASK has the same value as META_MASK.Mouse Button3修饰符常量。- 另请参见:
- 常数字段值
-
SHIFT_DOWN_MASK
public static final int SHIFT_DOWN_MASK
Shift键扩展修饰符常量。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
CTRL_DOWN_MASK
public static final int CTRL_DOWN_MASK
Control键扩展修饰符常量。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
META_DOWN_MASK
public static final int META_DOWN_MASK
Meta键扩展修饰符常量。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
ALT_DOWN_MASK
public static final int ALT_DOWN_MASK
Alt键扩展修饰符常量。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
BUTTON1_DOWN_MASK
public static final int BUTTON1_DOWN_MASK
Mouse Button1扩展修饰符常量。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
BUTTON2_DOWN_MASK
public static final int BUTTON2_DOWN_MASK
鼠标Button2扩展修饰符常量。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
BUTTON3_DOWN_MASK
public static final int BUTTON3_DOWN_MASK
鼠标Button3扩展修饰符常量。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
ALT_GRAPH_DOWN_MASK
public static final int ALT_GRAPH_DOWN_MASK
AltGraph键扩展修饰符常量。- 从以下版本开始:
- 1.4
- 另请参见:
- 常数字段值
-
-
方法详细信息
-
getMaskForButton
public static int getMaskForButton(int button)
一种获取任何现有鼠标按钮的掩码的方法。 返回的掩码可用于不同目的。 以下是其中一些:-
mousePress(buttons)
和mouseRelease(buttons)
- 创建新的
MouseEvent
实例时作为modifiers
参数 - 查看
modifiersEx
的现有MouseEvent
- 参数
-
button
- 表示从1开始的按钮的数字。例如,int button = InputEvent.getMaskForButton(1);
将具有相同的含义int button = InputEvent.getMaskForButton(MouseEvent.BUTTON1);
因为MouseEvent.BUTTON1
等于1.如果鼠标有三个启用按钮(请参阅MouseInfo.getNumberOfButtons()
),则传递给方法的左列中的值将返回右列中的相应值:button returned mask
如果鼠标具有三个以上的启用按钮,则允许更多值(4,5等)。 这些扩展按钮没有指定的常量。 此方法返回的额外按钮的按钮蒙版没有指定名称,如前三个按钮蒙版。BUTTON1
BUTTON1_DOWN_MASK
BUTTON2
BUTTON2_DOWN_MASK
BUTTON3
BUTTON3_DOWN_MASK
该方法具有以下实现限制。 它仅返回有限数量按钮的掩码。 最大数量取决于实现,可能会有所不同。 此限制由鼠标可能假设存在的相关按钮数量定义,但大于
MouseInfo.getNumberOfButtons()
。 - 结果
- 现有鼠标按钮的掩码。
- 异常
-
IllegalArgumentException
- 如果button
小于零或大于为按钮保留的按钮掩码数 - 从以下版本开始:
- 1.7
- 另请参见:
-
MouseInfo.getNumberOfButtons()
,Toolkit.areExtraMouseButtonsEnabled()
,getModifiers()
,getModifiersEx()
-
-
isShiftDown
public boolean isShiftDown()
返回Shift修改器是否在此事件中失效。- 结果
- Shift修改器是否在此事件中失效
-
isControlDown
public boolean isControlDown()
返回Control修饰符是否在此事件中失效。- 结果
- 控件修改器是否在此事件中失效
-
isMetaDown
public boolean isMetaDown()
返回Meta修饰符是否在此事件中失效。- 结果
- Meta修饰符是否在此事件中失效
-
isAltDown
public boolean isAltDown()
返回Alt修饰符是否在此事件中失效。- 结果
- Alt修饰符是否在此事件中失效
-
isAltGraphDown
public boolean isAltGraphDown()
返回AltGraph修饰符是否在此事件上失效。- 结果
- AltGraph修改器是否在此事件中失效
-
getWhen
public long getWhen()
返回此事件发生的时间戳与UTC时间1970年1月1日午夜之间的差异(以毫秒为单位)。- 结果
- 时间戳与1970年1月1日午夜时间之间的毫秒差异
-
getModifiers
@Deprecated(since="9") public int getModifiers()
Deprecated.It is recommended that extended modifier keys andgetModifiersEx()
be used instead返回此事件的修饰符掩码。- 结果
- 此事件的修饰符掩码
-
getModifiersEx
public int getModifiersEx()
返回此事件的扩展修饰符掩码。扩展修饰符是以_DOWN_MASK后缀结尾的修饰符,例如ALT_DOWN_MASK,BUTTON1_DOWN_MASK等。
扩展修饰符表示事件发生后所有模态键的状态,例如ALT,CTRL,META和鼠标按钮。
例如,如果用户按下按钮1,然后按下按钮2 ,然后以相同的顺序释放它们,则会生成以下事件序列:
MOUSE_PRESSED
:BUTTON1_DOWN_MASK
MOUSE_PRESSED
:BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASK
MOUSE_RELEASED
:BUTTON2_DOWN_MASK
MOUSE_CLICKED
:BUTTON2_DOWN_MASK
MOUSE_RELEASED
:MOUSE_CLICKED
:建议不要使用
==
比较此方法的返回值,因为将来可以添加新修饰符。 例如,以下代码演示了检查SHIFT和BUTTON1是否已关闭但是CTRL已启动的适当方法:int onmask = SHIFT_DOWN_MASK | BUTTON1_DOWN_MASK; int offmask = CTRL_DOWN_MASK; if ((event.getModifiersEx() & (onmask | offmask)) == onmask) { ... }
即使添加了新的修饰符,上述代码也能正常工作。- 结果
- 此事件的扩展修饰符掩码
- 从以下版本开始:
- 1.4
-
isConsumed
public boolean isConsumed()
返回是否已使用此事件。- 重写:
-
isConsumed
在课程AWTEvent
- 结果
- 是否已消耗此事件
- 另请参见:
-
consume()
-
getModifiersExText
public static String getModifiersExText(int modifiers)
返回描述扩展修饰键和鼠标按钮的String,例如“Shift”,“Button1”或“Ctrl + Shift”。 可以通过更改awt.properties
文件来本地化这些字符串。请注意,传递否定参数不正确,将导致返回未指定的字符串。 零参数表示没有传递修饰符,将导致返回空字符串。
- 参数
-
modifiers
- 一个修饰符掩码,描述事件的扩展修饰键和鼠标按键 - 结果
- 描述扩展修饰键和鼠标按钮的String
- 从以下版本开始:
- 1.4
-
-