java.awt.event
類別 InputEvent

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, 序列化表格

欄位摘要

static int	ALT_DOWN_MASK Alt 鍵的擴展修飾符常數。
static int	ALT_GRAPH_DOWN_MASK AltGraph 鍵的擴展修飾符常數。
static int	ALT_GRAPH_MASK AltGraph 鍵修飾符常數。
static int	ALT_MASK Alt 鍵修飾符常數。
static int	BUTTON1_DOWN_MASK Mouse Button1 的擴展修飾符常數。
static int	BUTTON1_MASK Mouse Button1 修飾符常數。
static int	BUTTON2_DOWN_MASK Mouse Button2 的擴展修飾符常數。
static int	BUTTON2_MASK Mouse Button2 修飾符常數。
static int	BUTTON3_DOWN_MASK Mouse Button3 的擴展修飾符常數。
static int	BUTTON3_MASK Mouse Button3 修飾符常數。
static int	CTRL_DOWN_MASK Control 鍵的擴展修飾符常數。
static int	CTRL_MASK Ctrl 鍵修飾符常數。
static int	META_DOWN_MASK Meta 鍵的擴展修飾符常數。
static int	META_MASK Meta 鍵修飾符常數。
static int	SHIFT_DOWN_MASK Shift 鍵的擴展修飾符常數。
static int	SHIFT_MASK Shift 鍵修飾符常數。

從類別 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() 使用此事件，以便不會按照預設的方式由產生此事件的源程式碼來處理此事件。
int	getModifiers() 返回此事件的修飾符遮罩碼。
int	getModifiersEx() 返回此事件的擴展修飾符遮罩碼。
static String	getModifiersExText(int modifiers) 返回描述擴展修改鍵和鼠標按鈕（例如 "Shift"、"Button1" 或 "Ctrl+Shift"）的 String。
long	getWhen() 返回此事件發生時的時間戳。
boolean	isAltDown() 返回 Alt 修飾符在此事件上是否為 down。
boolean	isAltGraphDown() 返回 AltGraph 修飾符在此事件上是否為 down。
boolean	isConsumed() 返回是否已經使用此事件。
boolean	isControlDown() 返回 Control 修飾符在此事件上是為 down。
boolean	isMetaDown() 返回 Meta 修飾符在此事件上是否為 down。
boolean	isShiftDown() 返回 Shift 修飾符在此事件上是否為 down。

從類別 java.awt.event.ComponentEvent 繼承的方法

getComponent, paramString

從類別 java.awt.AWTEvent 繼承的方法

getID, setSource, toString

從類別 java.util.EventObject 繼承的方法

getSource

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

欄位詳細資訊

SHIFT_MASK

public static final int SHIFT_MASK

Shift 鍵修飾符常數。建議使用 SHIFT_DOWN_MASK。

另請參見：

常數欄位值

CTRL_MASK

public static final int CTRL_MASK

Ctrl 鍵修飾符常數。建議使用 CTRL_DOWN_MASK。

另請參見：

常數欄位值

META_MASK

public static final int META_MASK

Meta 鍵修飾符常數。建議使用 META_DOWN_MASK。

另請參見：

常數欄位值

ALT_MASK

public static final int ALT_MASK

Alt 鍵修飾符常數。建議使用 ALT_DOWN_MASK。

另請參見：

常數欄位值

ALT_GRAPH_MASK

public static final int ALT_GRAPH_MASK

AltGraph 鍵修飾符常數。

另請參見：

常數欄位值

BUTTON1_MASK

public static final int BUTTON1_MASK

Mouse Button1 修飾符常數。建議使用 BUTTON1_DOWN_MASK。

另請參見：

常數欄位值

BUTTON2_MASK

public static final int BUTTON2_MASK

Mouse Button2 修飾符常數。建議使用 BUTTON2_DOWN_MASK。注意，BUTTON2_MASK 和 ALT_MASK 具有相同的值。

另請參見：

常數欄位值

BUTTON3_MASK

public static final int BUTTON3_MASK

Mouse Button3 修飾符常數。建議使用 BUTTON3_DOWN_MASK。注意：BUTTON3_MASK 和 META_MASK 具有相同的值。

另請參見：

常數欄位值

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

Mouse Button2 的擴展修飾符常數。

從以下版本開始：

1.4

另請參見：

常數欄位值

BUTTON3_DOWN_MASK

public static final int BUTTON3_DOWN_MASK

Mouse Button3 的擴展修飾符常數。

從以下版本開始：

1.4

另請參見：

常數欄位值

ALT_GRAPH_DOWN_MASK

public static final int ALT_GRAPH_DOWN_MASK

AltGraph 鍵的擴展修飾符常數。

從以下版本開始：

1.4

另請參見：

常數欄位值

方法詳細資訊

isShiftDown

public boolean isShiftDown()

返回 Shift 修飾符在此事件上是否為 down。

isControlDown

public boolean isControlDown()

返回 Control 修飾符在此事件上是為 down。

isMetaDown

public boolean isMetaDown()

返回 Meta 修飾符在此事件上是否為 down。

isAltDown

public boolean isAltDown()

返回 Alt 修飾符在此事件上是否為 down。

isAltGraphDown

public boolean isAltGraphDown()

返回 AltGraph 修飾符在此事件上是否為 down。

getWhen

public long getWhen()

返回此事件發生時的時間戳。

getModifiers

public int getModifiers()

返回此事件的修飾符遮罩碼。

getModifiersEx

public int getModifiersEx()

返回此事件的擴展修飾符遮罩碼。擴展修飾符表示所有網要鍵的狀態，例如 ALT、CTRL、META 和事件發生後那一刻的鼠標按鈕

例如，如果使用者在按下 button 1 後又按下 button 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()

使用此事件，以便不會按照預設的方式由產生此事件的源程式碼來處理此事件。

覆寫：

類別 AWTEvent 中的 consume

isConsumed

public boolean isConsumed()

返回是否已經使用此事件。

覆寫：

類別 AWTEvent 中的 isConsumed

另請參見：

consume()

getModifiersExText

public static String getModifiersExText(int modifiers)

返回描述擴展修改鍵和鼠標按鈕（例如 "Shift"、"Button1" 或 "Ctrl+Shift"）的 String。這些字元串的本地化可以通過修改 awt.properties 檔案來完成。

參數：

modifiers - 描述事件的擴展修飾符和鼠標按鈕的修飾符遮罩碼

返回：

事件期間保存按下的擴展修改鍵和鼠標按鈕集合的文本描述。

從以下版本開始：

1.4