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

Class InputEvent

  • All Implemented Interfaces:
    Serializable
    已知直接子类:
    KeyEventMouseEvent


    public abstract class InputEvent
    extends ComponentEvent
    所有组件级输入事件的根事件类。 输入事件在它们发起的源正常处理之前传递给收听者。 这允许侦听器和组件子类“消耗”事件,以便源将不会以其默认方式处理它们。 例如,在Button组件上使用mousePressed事件将阻止Button被激活。
    从以下版本开始:
    1.1
    另请参见:
    KeyEventKeyAdapterMouseEventMouseAdapterMouseMotionAdapterSerialized 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​()
        消耗此事件,使其不会以源自源的默认方式处理。
        重写:
        consumeAWTEvent
      • isConsumed

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

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

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

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