java.awt
類別 Event

java.lang.Object
  java.awt.Event

所有已實作的介面：

Serializable

public class Event
extends Object
implements Serializable

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別及其子類別所取代。

Event 是一個與平臺無關的類別，它封裝了 Java 1.0 事件模型中來自平臺圖形使用者介面的事件。在 Java 1.1 和以後的版本中，Event 類別只針對向後相容進行維護。此類別描述中的資訊可以協助開發人員將 Java 1.0 程序轉換成新的事件模型。

在 Java 1.0 事件模型中，包含 id 欄位的事件指出它是什麼型別的事件，以及與該事件有關的其他 Event 變數。

對於鍵盤事件來說，key 所包含的值指出要啟動哪個鍵，modifiers 套件含該事件的修飾符。對於 KEY_PRESS 和 KEY_RELEASE 事件的 id，key 的值是該鍵的 unicode 字元程式碼。對於 KEY_ACTION 和 KEY_ACTION_RELEASE，key 的值是 Event 類別（PGUP、PGDN、F1、F2 等）中所定義的某個動作-鍵標識符。

從以下版本開始：

JDK1.0

另請參見：

序列化表格

欄位摘要

static int	ACTION_EVENT 此事件指示使用者想要某個事件發生。
static int	ALT_MASK 此標誌指示當事件發生時按下 Alt 鍵。
Object	arg 事件的任意參數。
static int	BACK_SPACE BackSpace 鍵。
static int	CAPS_LOCK Caps Lock 鍵，一個非 ASCII 操作鍵。
int	clickCount 對於 MOUSE_DOWN 事件來說，此欄位指示連續點擊的次數。
static int	CTRL_MASK 此標誌指示當事件發生時按下 Control 鍵。
static int	DELETE Delete 鍵。
static int	DOWN Down Arrow 鍵，一個非 ASCII 操作鍵。
static int	END End 鍵，一個非 ASCII 操作鍵。
static int	ENTER Enter 鍵。
static int	ESCAPE Escape 鍵。
Event	evt 下一事件。
static int	F1 F1 功能鍵，一個非 ASCII 操作鍵。
static int	F10 F10 功能鍵，一個非 ASCII 操作鍵。
static int	F11 F11 功能鍵，一個非 ASCII 操作鍵。
static int	F12 F12 功能鍵，一個非 ASCII 操作鍵。
static int	F2 F2 功能鍵，一個非 ASCII 操作鍵。
static int	F3 F3 功能鍵，一個非 ASCII 操作鍵。
static int	F4 F4 功能鍵，一個非 ASCII 操作鍵。
static int	F5 F5 功能鍵，一個非 ASCII 操作鍵。
static int	F6 F6 功能鍵，一個非 ASCII 操作鍵。
static int	F7 F7 功能鍵，一個非 ASCII 操作鍵。
static int	F8 F8 功能鍵，一個非 ASCII 操作鍵。
static int	F9 F9 功能鍵，一個非 ASCII 操作鍵。
static int	GOT_FOCUS 元件獲得焦點。
static int	HOME Home 鍵，一個非 ASCII 操作鍵。
int	id 指示事件是什麼型別的事件，其他哪個 Event 變數與該事件有關。
static int	INSERT Insert 鍵，一個非 ASCII 操作鍵。
int	key 在鍵盤事件中被按下的鍵的鍵程式碼。
static int	KEY_ACTION 使用者已經按下一個非 ASCII action 鍵。
static int	KEY_ACTION_RELEASE 使用者已經釋放一個非 ASCII action 鍵。
static int	KEY_PRESS 使用者已經按下一個常規鍵。
static int	KEY_RELEASE 使用者已經釋放一個常規鍵。
static int	LEFT Left Arrow 鍵，一個非 ASCII 操作鍵。
static int	LIST_DESELECT 已經取消選擇列表中的一項。
static int	LIST_SELECT 已經選擇了列表中的一項。
static int	LOAD_FILE 檔案載入事件。
static int	LOST_FOCUS 元件失去焦點。
static int	META_MASK 此標誌指示當事件發生時按下 Meta 鍵。
int	modifiers 修飾符鍵的狀態。
static int	MOUSE_DOWN 使用者已經按下鼠標按鈕。
static int	MOUSE_DRAG 鼠標已經移動，同時按鈕被按下。
static int	MOUSE_ENTER 鼠標已經進入了一個元件。
static int	MOUSE_EXIT 鼠標已經退出了一個元件。
static int	MOUSE_MOVE 鼠標已經移動，沒有按鈕被按下。
static int	MOUSE_UP 使用者已經釋放鼠標按鈕。
static int	NUM_LOCK Num Lock 鍵，一個非 ASCII 操作鍵。
static int	PAUSE Pause 鍵，一個非 ASCII 操作鍵。
static int	PGDN Page Down 鍵，一個非 ASCII 操作鍵。
static int	PGUP Page Up 鍵，一個非 ASCII 操作鍵。
static int	PRINT_SCREEN Print Screen 鍵，一個非 ASCII 操作鍵。
static int	RIGHT Right Arrow 鍵，一個非 ASCII 操作鍵。
static int	SAVE_FILE 檔案保存事件。
static int	SCROLL_ABSOLUTE 使用者已經將滾動條中的“氣泡”（即翻閱標誌）移到一個“絕對的”位置，而不是相對最後位置的偏移量。
static int	SCROLL_BEGIN 滾動開始事件。
static int	SCROLL_END 滾動結束事件。
static int	SCROLL_LINE_DOWN 使用者已經啟動了滾動條的 line down 區域。
static int	SCROLL_LINE_UP 使用者已經啟動了滾動條的 line up 區域。
static int	SCROLL_LOCK Scroll Lock 鍵，一個非 ASCII 操作鍵。
static int	SCROLL_PAGE_DOWN 使用者已經啟動了滾動條的 page down 區域。
static int	SCROLL_PAGE_UP 使用者已經啟動了滾動條的 page up 區域。
static int	SHIFT_MASK 此標誌指示當事件發生時按下 Shift 鍵。
static int	TAB Tab 鍵。
Object	target 目標元件。
static int	UP Up Arrow 鍵，一個非 ASCII 操作鍵。
long	when 時間戳。
static int	WINDOW_DEICONIFY 使用者要求視窗管理程序取消視窗圖標化。
static int	WINDOW_DESTROY 使用者要求視窗管理程序關掉視窗。
static int	WINDOW_EXPOSE 使用者要求視窗管理程序公開視窗。
static int	WINDOW_ICONIFY 使用者要求視窗管理程序圖標化視窗。
static int	WINDOW_MOVED 使用者要求視窗管理程序移動視窗。
int	x 事件的 x 坐標。
int	y 事件的 y 坐標。

建構子摘要

Event(Object target, int id, Object arg)
註：Event 類別已廢棄，只可用於向後相容。

Event(Object target, long when, int id, int x, int y, int key, int modifiers)
註：Event 類別已廢棄，只可用於向後相容。

Event(Object target, long when, int id, int x, int y, int key, int modifiers, Object arg)
註：Event 類別已廢棄，只可用於向後相容。

方法摘要

boolean	controlDown() 註：Event 類別已廢棄，只可用於向後相容。
boolean	metaDown() 註：Event 類別已廢棄，只可用於向後相容。
protected String	paramString() 註：Event 類別已廢棄，只可用於向後相容。
boolean	shiftDown() 註：Event 類別已廢棄，只可用於向後相容。
String	toString() 註：Event 類別已廢棄，只可用於向後相容。
void	translate(int dx, int dy) 註：Event 類別已廢棄，只可用於向後相容。

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

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

欄位詳細資訊

SHIFT_MASK

public static final int SHIFT_MASK

此標誌指示當事件發生時按下 Shift 鍵。

另請參見：

常數欄位值

CTRL_MASK

public static final int CTRL_MASK

此標誌指示當事件發生時按下 Control 鍵。

另請參見：

常數欄位值

META_MASK

public static final int META_MASK

此標誌指示當事件發生時按下 Meta 鍵。對於鼠標事件，此標誌指示按下或釋放右邊按鈕。

另請參見：

常數欄位值

ALT_MASK

public static final int ALT_MASK

此標誌指示當事件發生時按下 Alt 鍵。對於鼠標事件，此標誌指示按下或釋放中間鼠標按鈕。

另請參見：

常數欄位值

HOME

public static final int HOME

Home 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

END

public static final int END

End 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

PGUP

public static final int PGUP

Page Up 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

PGDN

public static final int PGDN

Page Down 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

UP

public static final int UP

Up Arrow 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

DOWN

public static final int DOWN

Down Arrow 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

LEFT

public static final int LEFT

Left Arrow 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

RIGHT

public static final int RIGHT

Right Arrow 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F1

public static final int F1

F1 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F2

public static final int F2

F2 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F3

public static final int F3

F3 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F4

public static final int F4

F4 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F5

public static final int F5

F5 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F6

public static final int F6

F6 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F7

public static final int F7

F7 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F8

public static final int F8

F8 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F9

public static final int F9

F9 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F10

public static final int F10

F10 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F11

public static final int F11

F11 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

F12

public static final int F12

F12 功能鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

PRINT_SCREEN

public static final int PRINT_SCREEN

Print Screen 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

SCROLL_LOCK

public static final int SCROLL_LOCK

Scroll Lock 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

CAPS_LOCK

public static final int CAPS_LOCK

Caps Lock 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

NUM_LOCK

public static final int NUM_LOCK

Num Lock 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

PAUSE

public static final int PAUSE

Pause 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

INSERT

public static final int INSERT

Insert 鍵，一個非 ASCII 操作鍵。

另請參見：

常數欄位值

ENTER

public static final int ENTER

Enter 鍵。

另請參見：

常數欄位值

BACK_SPACE

public static final int BACK_SPACE

BackSpace 鍵。

另請參見：

常數欄位值

TAB

public static final int TAB

Tab 鍵。

另請參見：

常數欄位值

ESCAPE

public static final int ESCAPE

Escape 鍵。

另請參見：

常數欄位值

DELETE

public static final int DELETE

Delete 鍵。

另請參見：

常數欄位值

WINDOW_DESTROY

public static final int WINDOW_DESTROY

使用者要求視窗管理程序關掉視窗。

另請參見：

常數欄位值

WINDOW_EXPOSE

public static final int WINDOW_EXPOSE

使用者要求視窗管理程序公開視窗。

另請參見：

常數欄位值

WINDOW_ICONIFY

public static final int WINDOW_ICONIFY

使用者要求視窗管理程序圖標化視窗。

另請參見：

常數欄位值

WINDOW_DEICONIFY

public static final int WINDOW_DEICONIFY

使用者要求視窗管理程序取消視窗圖標化。

另請參見：

常數欄位值

WINDOW_MOVED

public static final int WINDOW_MOVED

使用者要求視窗管理程序移動視窗。

另請參見：

常數欄位值

KEY_PRESS

public static final int KEY_PRESS

使用者已經按下一個常規鍵。

另請參見：

常數欄位值

KEY_RELEASE

public static final int KEY_RELEASE

使用者已經釋放一個常規鍵。

另請參見：

常數欄位值

KEY_ACTION

public static final int KEY_ACTION

使用者已經按下一個非 ASCII action 鍵。key 欄位包含一個值，指示發生在某個操作鍵上的事件，操作鍵包括 12 個功能鍵、箭頭（鼠標）鍵、Page Up、Page Down、Home、End、Print Screen、Scroll Lock、Caps Lock、Num Lock、Pause 和 Insert。

另請參見：

常數欄位值

KEY_ACTION_RELEASE

public static final int KEY_ACTION_RELEASE

使用者已經釋放一個非 ASCII action 鍵。key 欄位包含一個值，指示發生在某個操作鍵中的事件，操作鍵包括 12 個功能鍵、箭頭（鼠標）鍵、Page Up、Page Down、Home、End、Print Screen、Scroll Lock、Caps Lock、Num Lock、Pause 和 Insert。

另請參見：

常數欄位值

MOUSE_DOWN

public static final int MOUSE_DOWN

使用者已經按下鼠標按鈕。ALT_MASK 標誌指示中間按鈕已經被按下。META_MASK 標誌指示右按鈕已經被按下。

另請參見：

ALT_MASK, META_MASK, 常數欄位值

MOUSE_UP

public static final int MOUSE_UP

使用者已經釋放鼠標按鈕。ALT_MASK 標誌指示中間按鈕已經被釋放。META_MASK 標誌指示右邊按鈕已經被釋放。

另請參見：

ALT_MASK, META_MASK, 常數欄位值

MOUSE_MOVE

public static final int MOUSE_MOVE

鼠標已經移動，沒有按鈕被按下。

另請參見：

常數欄位值

MOUSE_ENTER

public static final int MOUSE_ENTER

鼠標已經進入了一個元件。

另請參見：

常數欄位值

MOUSE_EXIT

public static final int MOUSE_EXIT

鼠標已經退出了一個元件。

另請參見：

常數欄位值

MOUSE_DRAG

public static final int MOUSE_DRAG

鼠標已經移動，同時按鈕被按下。ALT_MASK 標誌指示中間按鈕正在被按下。META_MASK 標誌指示右邊按鈕正在被按下。

另請參見：

ALT_MASK, META_MASK, 常數欄位值

SCROLL_LINE_UP

public static final int SCROLL_LINE_UP

使用者已經啟動了滾動條的 line up 區域。

另請參見：

常數欄位值

SCROLL_LINE_DOWN

public static final int SCROLL_LINE_DOWN

使用者已經啟動了滾動條的 line down 區域。

另請參見：

常數欄位值

SCROLL_PAGE_UP

public static final int SCROLL_PAGE_UP

使用者已經啟動了滾動條的 page up 區域。

另請參見：

常數欄位值

SCROLL_PAGE_DOWN

public static final int SCROLL_PAGE_DOWN

使用者已經啟動了滾動條的 page down 區域。

另請參見：

常數欄位值

SCROLL_ABSOLUTE

public static final int SCROLL_ABSOLUTE

使用者已經將滾動條中的“氣泡”（即翻閱標誌）移到一個“絕對的”位置，而不是相對最後位置的偏移量。

另請參見：

常數欄位值

SCROLL_BEGIN

public static final int SCROLL_BEGIN

滾動開始事件。

另請參見：

常數欄位值

SCROLL_END

public static final int SCROLL_END

滾動結束事件。

另請參見：

常數欄位值

LIST_SELECT

public static final int LIST_SELECT

已經選擇了列表中的一項。

另請參見：

常數欄位值

LIST_DESELECT

public static final int LIST_DESELECT

已經取消選擇列表中的一項。

另請參見：

常數欄位值

ACTION_EVENT

public static final int ACTION_EVENT

此事件指示使用者想要某個事件發生。

另請參見：

常數欄位值

LOAD_FILE

public static final int LOAD_FILE

檔案載入事件。

另請參見：

常數欄位值

SAVE_FILE

public static final int SAVE_FILE

檔案保存事件。

另請參見：

常數欄位值

GOT_FOCUS

public static final int GOT_FOCUS

元件獲得焦點。

另請參見：

常數欄位值

LOST_FOCUS

public static final int LOST_FOCUS

元件失去焦點。

另請參見：

常數欄位值

target

public Object target

目標元件。這指示事件針對該元件發生，或事件與該元件關聯。此物件已經由 AWTEvent.getSource() 取代。

另請參見：

EventObject.getSource()

when

public long when

時間戳。由 InputEvent.getWhen() 取代。

另請參見：

InputEvent.getWhen()

id

public int id

指示事件是什麼型別的事件，其他哪個 Event 變數與該事件有關。它已經由 AWTEvent.getID() 取代。

另請參見：

AWTEvent.getID()

x

public int x

事件的 x 坐標。由 MouseEvent.getX() 取代。

另請參見：

MouseEvent.getX()

y

public int y

事件的 y 坐標。由 MouseEvent.getY() 取代。

另請參見：

MouseEvent.getY()

key

public int key

在鍵盤事件中被按下的鍵的鍵程式碼。這已經由 KeyEvent.getKeyCode() 取代。

另請參見：

KeyEvent.getKeyCode()

modifiers

public int modifiers

修飾符鍵的狀態。這已經由 InputEvent.getModifiers() 取代。在 java 1.1 中，MouseEvent 和 KeyEvent 是 InputEvent 的子類別。

另請參見：

InputEvent.getModifiers()

clickCount

public int clickCount

對於 MOUSE_DOWN 事件來說，此欄位指示連續點擊的次數。對於其他事件，其值為 0。此欄位由 MouseEvent.getClickCount() 取代。

另請參見：

MouseEvent.getClickCount().

arg

public Object arg

事件的任意參數。此欄位的值取決於事件的型別。arg 已經由事件指定的屬性取代。

evt

public Event evt

下一事件。將事件放入到連接列表時設置此欄位。這已經由 EventQueue 取代。

另請參見：

EventQueue

建構子詳細資訊

Event

public Event(Object target,
             long when,
             int id,
             int x,
             int y,
             int key,
             int modifiers,
             Object arg)

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別及其子類別所取代。

創建 Event 的一個實例，具有指定的目標元件、時間戳、事件型別、x 和 y 坐標、鍵盤鍵、修飾符鍵的狀態、參數。

參數：

target - 目標元件。

when - 時間戳。

id - 事件型別。

x - x 坐標。

y - y 坐標。

key - 在鍵盤事件中按下的鍵。

modifiers - 修飾符鍵的狀態。

arg - 指定參數。

Event

public Event(Object target,
             long when,
             int id,
             int x,
             int y,
             int key,
             int modifiers)

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別和其子類別所取代。

創建 Event 的一個實例，具有指定的目標元件、時間戳、事件型別、x 和 y 坐標、鍵盤鍵、修飾符鍵的狀態、一個設置為 null 的參數。

參數：

target - 目標元件。

when - 時間戳。

id - 事件型別。

x - x 坐標。

y - y 坐標。

key - 在鍵盤事件中按下的鍵。

modifiers - 修飾符鍵的狀態。

Event

public Event(Object target,
             int id,
             Object arg)

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別和其子類別所取代。

使用指定的目標元件、事件型別和參數創建 Event 的一個實例。

參數：

target - 目標元件。

id - 事件型別。

arg - 指定參數。

方法詳細資訊

translate

public void translate(int dx,
                      int dy)

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別和其子類別所取代。

轉換此事件，使其 x 和 y 坐標分別以 dx 和 dy 遞增。

此方法轉換與給定元件相關的事件。這至少涉及到將坐標轉換成給定元件的本地坐標系。它還可能涉及到在公開事件中轉換一個區域

參數：

dx - 要轉換 x 坐標的距離。

dy - 要轉換 y 坐標的距離。

shiftDown

public boolean shiftDown()

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別和其子類別所取代。

檢查 Shift 鍵是否被按下。

返回：

如果該鍵被按下，則返回 true；否則返回 false。

另請參見：

modifiers, controlDown(), metaDown()

controlDown

public boolean controlDown()

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別和其子類別所取代。

檢查 Control 鍵是否被按下。

返回：

如果該鍵被按下，則返回 true；否則返回 false。

另請參見：

modifiers, shiftDown(), metaDown()

metaDown

public boolean metaDown()

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別和其子類別所取代。

檢查 Meta 鍵是否被按下。

返回：

如果該鍵被按下，則返回 true；否則返回 false。

另請參見：

modifiers, shiftDown(), controlDown()

paramString

protected String paramString()

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別和其子類別所取代。

返回此 Event 狀態的字元串表示形式。此方法僅用於除錯目的，對於這兩種實作，返回字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

返回：

此事件的參數字元串

toString

public String toString()

註：Event 類別已廢棄，只可用於向後相容。它已經由 AWTEvent 類別和其子類別所取代。

返回此事件的值的字元串表示形式。

覆寫：

類別 Object 中的 toString

返回：

字元串，表示事件及其成員欄位的值。

從以下版本開始：

JDK1.1

另請參見：

paramString()