字段详细信息

• SHIFT_MASK

  @Deprecated(since="9")
  public static final int SHIFT_MASK

  Deprecated.

  It is recommended that SHIFT_DOWN_MASK and getModifiersEx() be used instead
  Shift键修饰符常量。

  另请参见：

  常数字段值

• CTRL_MASK

  @Deprecated(since="9")
  public static final int CTRL_MASK

  Deprecated.

  It is recommended that CTRL_DOWN_MASK and getModifiersEx() be used instead
  Control键修饰符常量。

  另请参见：

  常数字段值

• META_MASK

  @Deprecated(since="9")
  public static final int META_MASK

  Deprecated.

  It is recommended that META_DOWN_MASK and getModifiersEx() be used instead
  Meta键修饰符常量。

  另请参见：

  常数字段值

• ALT_MASK

  @Deprecated(since="9")
  public static final int ALT_MASK

  Deprecated.

  It is recommended that ALT_DOWN_MASK and getModifiersEx() be used instead
  Alt键修饰符常量。

  另请参见：

  常数字段值

• ALT_GRAPH_MASK

  @Deprecated(since="9")
  public static final int ALT_GRAPH_MASK

  Deprecated.

  It is recommended that ALT_GRAPH_DOWN_MASK and getModifiersEx() be used instead
  AltGraph键修饰符常量。

  另请参见：

  常数字段值

• BUTTON1_MASK

  @Deprecated(since="9")
  public static final int BUTTON1_MASK

  Deprecated.

  It is recommended that BUTTON1_DOWN_MASK and getModifiersEx() be used instead
  Mouse Button1修饰符常量。

  另请参见：

  常数字段值

• BUTTON2_MASK

  @Deprecated(since="9")
  public static final int BUTTON2_MASK

  Deprecated.

  It is recommended that BUTTON2_DOWN_MASK and getModifiersEx() 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 and getModifiersEx() 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
      BUTTON1  BUTTON1_DOWN_MASK
      BUTTON2  BUTTON2_DOWN_MASK
      BUTTON3  BUTTON3_DOWN_MASK 

  如果鼠标具有三个以上的启用按钮，则允许更多值（4,5等）。 这些扩展按钮没有指定的常量。 此方法返回的额外按钮的按钮蒙版没有指定名称，如前三个按钮蒙版。

  该方法具有以下实现限制。 它仅返回有限数量按钮的掩码。 最大数量取决于实现，可能会有所不同。 此限制由鼠标可能假设存在的相关按钮数量定义，但大于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 and getModifiersEx() 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

• consume

  public void consume()

  使用此事件，以便由发起它的源以默认方式处理它。

  重写：

  consume在课程 AWTEvent

• 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