Module  java.desktop
软件包  java.awt.event

Class InputEvent

  • All Implemented Interfaces:
    Serializable
    已知直接子类：
    KeyEvent ， MouseEvent 

    public abstract class InputEvent
extends ComponentEvent
    所有组件级输入事件的根事件类。 输入事件在它们发起的源正常处理之前传递给收听者。 这允许侦听器和组件子类“消耗”事件，以便源将不会以其默认方式处理它们。 例如，在Button组件上使用mousePressed事件将阻止Button被激活。
    从以下版本开始：
    1.1
    另请参见：
    KeyEvent ， KeyAdapter ， MouseEvent ， MouseAdapter ， MouseMotionAdapter ， Serialized Form

    • 方法详细信息

      • isShiftDown

        public boolean isShiftDown​()
        返回此事件的Shift修饰符是否关闭。
        结果
        Shift修饰符是否关闭此事件

      • isControlDown

        public boolean isControlDown​()
        返回此修改器是否关闭此事件。
        结果
        此修改器是否关闭此事件

      • isMetaDown

        public boolean isMetaDown​()
        返回Meta修饰符在此事件上是否关闭。
        结果
        Meta修饰符是否关闭此事件

      • isAltDown

        public boolean isAltDown​()
        返回此事件的Alt修饰符是否关闭。
        结果
        此修改器是否关闭此事件

      • isAltGraphDown

        public boolean isAltGraphDown​()
        返回此事件的AltGraph修饰符是否关闭。
        结果
        AltGraph修饰符是否关闭此事件

      • getWhen

        public long getWhen​()
        返回此事件发生的时间戳与1970年1月1日UTC之间的毫秒之间的差异。
        结果
        1970年1月1日UTC时间戳与午夜之间的毫秒数之间的差异

      • getModifiers

        @Deprecated(since="9")
public int getModifiers​()
        已过时。 建议使用扩展修饰键和getModifiersEx()
        返回此事件的修饰符掩码。
        结果
        此事件的修饰符掩码

      • 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

      • consume

        public void consume​()
        消耗此事件，使其不会以源自源的默认方式处理。
        重写：
        consume在 AWTEvent

      • isConsumed

        public boolean isConsumed​()
        返回此事件是否已被使用。
        重写：
        isConsumed在 AWTEvent
        结果
        这个事件是否被消耗了
        另请参见：
        consume()

      • getModifiersExText

        public static String getModifiersExText​(int modifiers)
        返回一个描述扩展修饰符键和鼠标按钮的字符串，例如“Shift”，“Button1”或“Ctrl + Shift”。 这些字符串可以通过更改awt.properties文件进行本地化。

        请注意，传递负参数不正确，将返回未指定的字符串。 零参数意味着没有修改器被传递并且将导致返回一个空字符串。

        参数
        modifiers - 描述事件的扩展修饰符键和鼠标按钮的修饰符掩码
        结果
        一个描述扩展修饰键和鼠标按钮的字符串
        从以下版本开始：
        1.4