- 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 intALT_DOWN_MASKAlt键扩展修饰符常量。static intALT_GRAPH_DOWN_MASKAltGraph键扩展修饰符常量。static intALT_GRAPH_MASK已过时。建议改用ALT_GRAPH_DOWN_MASK和getModifiersEx()static intALT_MASK已过时。建议改用ALT_DOWN_MASK和getModifiersEx()static intBUTTON1_DOWN_MASKMouse Button1扩展修饰符常量。static intBUTTON1_MASK已过时。建议改用BUTTON1_DOWN_MASK和getModifiersEx()static intBUTTON2_DOWN_MASK鼠标Button2扩展修饰符常量。static intBUTTON2_MASK已过时。建议改用 BUTTON2_DOWN_MASK和getModifiersEx()。static intBUTTON3_DOWN_MASK鼠标Button3扩展修饰符常量。static intBUTTON3_MASK已过时。建议改用BUTTON3_DOWN_MASK和getModifiersEx()。static intCTRL_DOWN_MASKControl键扩展修饰符常量。static intCTRL_MASK已过时。建议改用CTRL_DOWN_MASK和getModifiersEx()static intMETA_DOWN_MASKMeta键扩展修饰符常量。static intMETA_MASK已过时。建议改用META_DOWN_MASK和getModifiersEx()static intSHIFT_DOWN_MASKShift键扩展修饰符常量。static intSHIFT_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
-
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 弃用的方法 变量和类型 方法 描述 voidconsume()使用此事件,以便由发起它的源以默认方式处理它。static intgetMaskForButton(int button)一种获取任何现有鼠标按钮的掩码的方法。intgetModifiers()已过时。建议使用扩展修饰键和getModifiersEx()intgetModifiersEx()返回此事件的扩展修饰符掩码。static StringgetModifiersExText(int modifiers)返回描述扩展修饰键和鼠标按钮的String,例如“Shift”,“Button1”或“Ctrl + Shift”。longgetWhen()返回此事件发生的时间戳与UTC时间1970年1月1日午夜之间的差异(以毫秒为单位)。booleanisAltDown()返回Alt修饰符是否在此事件中失效。booleanisAltGraphDown()返回AltGraph修饰符是否在此事件上失效。booleanisConsumed()返回是否已使用此事件。booleanisControlDown()返回Control修饰符是否在此事件中失效。booleanisMetaDown()返回Meta修饰符是否在此事件中失效。booleanisShiftDown()返回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等)。 这些扩展按钮没有指定的常量。 此方法返回的额外按钮的按钮蒙版没有指定名称,如前三个按钮蒙版。BUTTON1BUTTON1_DOWN_MASKBUTTON2BUTTON2_DOWN_MASKBUTTON3BUTTON3_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_MASKMOUSE_PRESSED:BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASKMOUSE_RELEASED:BUTTON2_DOWN_MASKMOUSE_CLICKED:BUTTON2_DOWN_MASKMOUSE_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
-
-