JavaTM 2 Platform
Standard Ed. 6

java.awt.event
類別 KeyEvent

java.lang.Object
  繼承者 java.util.EventObject
      繼承者 java.awt.AWTEvent
          繼承者 java.awt.event.ComponentEvent
              繼承者 java.awt.event.InputEvent
                  繼承者 java.awt.event.KeyEvent
所有已實作的介面:
Serializable
直接已知子類別:
MenuKeyEvent

public class KeyEvent
extends InputEvent

表示元件中發生鍵擊的事件。

當按下、釋放或鍵入某個鍵時,元件物件(如文本欄位)將產生此低層級別事件。該事件被傳遞給每一個 KeyListenerKeyAdapter 物件,這些物件使用元件的 addKeyListener 方法註冊,以接收此類別事件。(KeyAdapter 物件實作 KeyListener 介面。)發生事件時,所有此類別偵聽器對象都將獲得此 KeyEvent

“鍵入鍵”事件 是高層級別事件,通常不依賴於平臺或鍵盤佈局。輸入 Unicode 字元時產生此類別事件,它們被認為是發現字元輸入的最佳方式。最簡單的情況是,按下單個鍵(如 "a")將產生鍵入鍵事件。但是,字元經常是通過一系列按鍵(如‘shift’+‘a’)產生的,按下鍵事件和鍵入鍵事件的映射關係可能是多對一或多對多的。鍵釋放通常不需要產生鍵入鍵事件,但在某些情況下,只有釋放了某個鍵後才能產生鍵入鍵事件(如在 Windows 中通過 Alt-Numpad 方法來輸入 ASCII 序列)。對於不產生 Unicode 字元的鍵是不會產生鍵入鍵事件的(如動作鍵、修改鍵等等)。

getKeyChar 方法總是返回有效的 Unicode 字元或 CHAR_UNDEFINED。KEY_TYPED 事件報告字元輸入:KEY_PRESSED 和 KEY_RELEASED 事件不必與字元輸入關聯。因此,可以保證 getKeyChar 方法的結果只對 KEY_TYPED 事件有意義。

對於按下鍵和釋放鍵事件,getKeyCode 方法返回該事件的 keyCode。對於鍵入鍵事件,getKeyCode 方法總是返回 VK_UNDEFINED。

“按下鍵”和“釋放鍵”事件 是低層級別事件,依賴於平臺和鍵盤佈局。只要按下或釋放鍵就產生這些事件,它們是發現不產生字元輸入的鍵(如動作鍵、修改鍵等等)的惟一方式。通過 getKeyCode 方法可指出按下或釋放的鍵,該方法返回一個虛擬鍵碼。

虛擬鍵碼 用於報告按下了鍵盤上的哪個鍵,而不是一次或多次鍵擊組合產生的字元(如 "A" 是由 shift + "a" 產生的)。

例如,按下 Shift 鍵會產生 keyCode 為 VK_SHIFT 的 KEY_PRESSED 事件,而按下 'a' 鍵將產生 keyCode 為 VK_A 的 KEY_PRESSED 事件。釋放 'a' 鍵後,會觸發 keyCode 為 VK_A 的 KEY_RELEASED 事件。另外,還會產生一個 keyChar 值為 'A' 的 KEY_TYPED 事件。

按下和釋放鍵盤上的鍵會導致(依次)產生以下鍵事件:

    KEY_PRESSED
    KEY_TYPED(只在可產生有效 Unicode 字元時產生。)
    KEY_RELEASED
 
但在某些情況下(例如,在啟動自動重複或輸入方法時),該順序可能會有所不同(並且與平臺有關)。

註:

警告:除了 Java 語言定義的這些鍵之外(VK_ENTER、VK_BACK_SPACE 和 VK_TAB),不要依賴 VK_ 常數值。Sun 保留將來根據需要更改這些值的權利,以適應更大範圍的鍵盤。

從以下版本開始:
1.1
另請參見:
KeyAdapter, KeyListener, Tutorial: Writing a Key Listener, 序列化表格

欄位摘要
static char CHAR_UNDEFINED
          KEY_PRESSED 和 KEY_RELEASED 事件沒有映射到一個有效的 Unicode 字元時使用此值作為 keyChar 值。
static int KEY_FIRST
          用於鍵事件的 id 範圍的起始編號。
static int KEY_LAST
          用於鍵事件的 id 範圍的結束編號。
static int KEY_LOCATION_LEFT
          該常數指示按下或釋放的鍵位於左側(此鍵的位置有多種可能性)。
static int KEY_LOCATION_NUMPAD
          該常數指示按鍵事件發自於數字鍵盤或對應於數字鍵盤的虛擬鍵。
static int KEY_LOCATION_RIGHT
          該常數指示按下或釋放的鍵位於右側(此鍵的位置有多種可能性)。
static int KEY_LOCATION_STANDARD
          該常數指示按下或釋放的鍵不區分左右,並且不是發自數字鍵盤(或者不是發自對應於數字鍵盤的虛擬鍵)。
static int KEY_LOCATION_UNKNOWN
          指示 keyLocation 為不確定或不相關的常數。
static int KEY_PRESSED
          “按下鍵”事件。
static int KEY_RELEASED
          “釋放鍵”事件。
static int KEY_TYPED
          “鍵入鍵”事件。
static int VK_0
          VK_0 到 VK_9 與 ASCII 的‘0’到‘9’(0x30 - 0x39) 相同
static int VK_1
           
static int VK_2
           
static int VK_3
           
static int VK_4
           
static int VK_5
           
static int VK_6
           
static int VK_7
           
static int VK_8
           
static int VK_9
           
static int VK_A
          VK_A 到 VK_Z 與 ASCII 的‘A’到‘Z’(0x41 - 0x5A) 相同
static int VK_ACCEPT
          用於 Accept 或 Commit 功能鍵的常數。
static int VK_ADD
           
static int VK_AGAIN
           
static int VK_ALL_CANDIDATES
          用於 All Candidates 功能鍵的常數。
static int VK_ALPHANUMERIC
          用於 Alphanumeric 功能鍵的常數。
static int VK_ALT
           
static int VK_ALT_GRAPH
          用於 AltGraph 功能鍵的常數。
static int VK_AMPERSAND
           
static int VK_ASTERISK
           
static int VK_AT
          用於 "@" 鍵的常數。
static int VK_B
           
static int VK_BACK_QUOTE
           
static int VK_BACK_SLASH
          用於反斜槓鍵 "\" 的常數。
static int VK_BACK_SPACE
           
static int VK_BEGIN
          用於 Begin 鍵的常數。
static int VK_BRACELEFT
           
static int VK_BRACERIGHT
           
static int VK_C
           
static int VK_CANCEL
           
static int VK_CAPS_LOCK
           
static int VK_CIRCUMFLEX
          用於 "^" 鍵的常數。
static int VK_CLEAR
           
static int VK_CLOSE_BRACKET
          用於右方括號鍵 "]" 的常數。
static int VK_CODE_INPUT
          用於 Code Input 功能鍵的常數。
static int VK_COLON
          用於 ":" 鍵的常數。
static int VK_COMMA
          用於逗號鍵 "," 的常數。
static int VK_COMPOSE
          用於 Compose 功能鍵的常數。
static int VK_CONTEXT_MENU
          用於 Microsoft Windows 上下文選單鍵的常數。
static int VK_CONTROL
           
static int VK_CONVERT
          用於 Convert 功能鍵的常數。
static int VK_COPY
           
static int VK_CUT
           
static int VK_D
           
static int VK_DEAD_ABOVEDOT
           
static int VK_DEAD_ABOVERING
           
static int VK_DEAD_ACUTE
           
static int VK_DEAD_BREVE
           
static int VK_DEAD_CARON
           
static int VK_DEAD_CEDILLA
           
static int VK_DEAD_CIRCUMFLEX
           
static int VK_DEAD_DIAERESIS
           
static int VK_DEAD_DOUBLEACUTE
           
static int VK_DEAD_GRAVE
           
static int VK_DEAD_IOTA
           
static int VK_DEAD_MACRON
           
static int VK_DEAD_OGONEK
           
static int VK_DEAD_SEMIVOICED_SOUND
           
static int VK_DEAD_TILDE
           
static int VK_DEAD_VOICED_SOUND
           
static int VK_DECIMAL
           
static int VK_DELETE
           
static int VK_DIVIDE
           
static int VK_DOLLAR
          用於 "$" 鍵的常數。
static int VK_DOWN
          用於非數字鍵盤向下方向鍵的常數。
static int VK_E
           
static int VK_END
           
static int VK_ENTER
           
static int VK_EQUALS
          用於等號鍵 "=" 的常數。
static int VK_ESCAPE
           
static int VK_EURO_SIGN
          用於歐洲貨幣符號鍵的常數。
static int VK_EXCLAMATION_MARK
          用於 "!" 鍵的常數。
static int VK_F
           
static int VK_F1
          用於 F1 功能鍵的常數。
static int VK_F10
          用於 F10 功能鍵的常數。
static int VK_F11
          用於 F11 功能鍵的常數。
static int VK_F12
          用於 F12 功能鍵的常數。
static int VK_F13
          用於 F13 功能鍵的常數。
static int VK_F14
          用於 F14 功能鍵的常數。
static int VK_F15
          用於 F15 功能鍵的常數。
static int VK_F16
          用於 F16 功能鍵的常數。
static int VK_F17
          用於 F17 功能鍵的常數。
static int VK_F18
          用於 F18 功能鍵的常數。
static int VK_F19
          用於 F19 功能鍵的常數。
static int VK_F2
          用於 F2 功能鍵的常數。
static int VK_F20
          用於 F20 功能鍵的常數。
static int VK_F21
          用於 F21 功能鍵的常數。
static int VK_F22
          用於 F22 功能鍵的常數。
static int VK_F23
          用於 F23 功能鍵的常數。
static int VK_F24
          用於 F24 功能鍵的常數。
static int VK_F3
          用於 F3 功能鍵的常數。
static int VK_F4
          用於 F4 功能鍵的常數。
static int VK_F5
          用於 F5 功能鍵的常數。
static int VK_F6
          用於 F6 功能鍵的常數。
static int VK_F7
          用於 F7 功能鍵的常數。
static int VK_F8
          用於 F8 功能鍵的常數。
static int VK_F9
          用於 F9 功能鍵的常數。
static int VK_FINAL
           
static int VK_FIND
           
static int VK_FULL_WIDTH
          用於 Full-Width Characters 功能鍵的常數。
static int VK_G
           
static int VK_GREATER
           
static int VK_H
           
static int VK_HALF_WIDTH
          用於 Half-Width Characters 功能鍵的常數。
static int VK_HELP
           
static int VK_HIRAGANA
          用於 Hiragana 功能鍵的常數。
static int VK_HOME
           
static int VK_I
           
static int VK_INPUT_METHOD_ON_OFF
          用於輸入法開/關鍵的常數。
static int VK_INSERT
           
static int VK_INVERTED_EXCLAMATION_MARK
          用於反向感歎號鍵的常數。
static int VK_J
           
static int VK_JAPANESE_HIRAGANA
          用於 Japanese-Hiragana 功能鍵的常數。
static int VK_JAPANESE_KATAKANA
          用於 Japanese-Katakana 功能鍵的常數。
static int VK_JAPANESE_ROMAN
          用於 Japanese-Roman 功能鍵的常數。
static int VK_K
           
static int VK_KANA
           
static int VK_KANA_LOCK
          用於鎖定 Kana 功能鍵的常數。
static int VK_KANJI
           
static int VK_KATAKANA
          用於 Katakana 功能鍵的常數。
static int VK_KP_DOWN
          用於數字鍵盤向下方向鍵的常數。
static int VK_KP_LEFT
          用於數字鍵盤向左方向鍵的常數。
static int VK_KP_RIGHT
          用於數字鍵盤向右方向鍵的常數。
static int VK_KP_UP
          用於數字鍵盤向上方向鍵的常數。
static int VK_L
           
static int VK_LEFT
          用於非數字鍵盤向左方向鍵的常數。
static int VK_LEFT_PARENTHESIS
          用於 "(" 鍵的常數。
static int VK_LESS
           
static int VK_M
           
static int VK_META
           
static int VK_MINUS
          用於減號鍵 "-" 的常數
static int VK_MODECHANGE
           
static int VK_MULTIPLY
           
static int VK_N
           
static int VK_NONCONVERT
          用於 Don't Convert 功能鍵的常數。
static int VK_NUM_LOCK
           
static int VK_NUMBER_SIGN
          用於 "#" 鍵的常數。
static int VK_NUMPAD0
           
static int VK_NUMPAD1
           
static int VK_NUMPAD2
           
static int VK_NUMPAD3
           
static int VK_NUMPAD4
           
static int VK_NUMPAD5
           
static int VK_NUMPAD6
           
static int VK_NUMPAD7
           
static int VK_NUMPAD8
           
static int VK_NUMPAD9
           
static int VK_O
           
static int VK_OPEN_BRACKET
          用於左方括號鍵 "[" 的常數。
static int VK_P
           
static int VK_PAGE_DOWN
           
static int VK_PAGE_UP
           
static int VK_PASTE
           
static int VK_PAUSE
           
static int VK_PERIOD
          用於句點鍵 "." 的常數。
static int VK_PLUS
          用於 "+" 鍵的常數。
static int VK_PREVIOUS_CANDIDATE
          用於 Previous Candidate 功能鍵的常數。
static int VK_PRINTSCREEN
           
static int VK_PROPS
           
static int VK_Q
           
static int VK_QUOTE
           
static int VK_QUOTEDBL
           
static int VK_R
           
static int VK_RIGHT
          用於非數字鍵盤向右方向鍵的常數。
static int VK_RIGHT_PARENTHESIS
          用於 ")" 鍵的常數。
static int VK_ROMAN_CHARACTERS
          用於 Roman Characters 功能鍵的常數。
static int VK_S
           
static int VK_SCROLL_LOCK
           
static int VK_SEMICOLON
          用於分號鍵 ";" 的常數。
static int VK_SEPARATER
          此常數已廢棄,包括它僅為了向後相容。
static int VK_SEPARATOR
          用於數字鍵盤分隔符鍵的常數。
static int VK_SHIFT
           
static int VK_SLASH
          用於正斜槓鍵 "/" 的常數。
static int VK_SPACE
           
static int VK_STOP
           
static int VK_SUBTRACT
           
static int VK_T
           
static int VK_TAB
           
static int VK_U
           
static int VK_UNDEFINED
          此值用於指出 keyCode 是未知的。
static int VK_UNDERSCORE
          用於 "_" 鍵的常數。
static int VK_UNDO
           
static int VK_UP
          用於非數字鍵盤向上方向鍵的常數。
static int VK_V
           
static int VK_W
           
static int VK_WINDOWS
          用於 Microsoft Windows 的 "Windows" 鍵的常數。
static int VK_X
           
static int VK_Y
           
static int VK_Z
           
 
從類別 java.awt.event.InputEvent 繼承的欄位
ALT_DOWN_MASK, ALT_GRAPH_DOWN_MASK, ALT_GRAPH_MASK, ALT_MASK, BUTTON1_DOWN_MASK, BUTTON1_MASK, BUTTON2_DOWN_MASK, BUTTON2_MASK, BUTTON3_DOWN_MASK, BUTTON3_MASK, CTRL_DOWN_MASK, CTRL_MASK, META_DOWN_MASK, META_MASK, SHIFT_DOWN_MASK, SHIFT_MASK
 
從類別 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
 
建構子摘要
KeyEvent(Component source, int id, long when, int modifiers, int keyCode)
          已過時。 從 JDK1.1 開始
KeyEvent(Component source, int id, long when, int modifiers, int keyCode, char keyChar)
          建構一個 KeyEvent 物件。
KeyEvent(Component source, int id, long when, int modifiers, int keyCode, char keyChar, int keyLocation)
           
 
方法摘要
 char getKeyChar()
          返回與此事件中的鍵關聯的字元。
 int getKeyCode()
          返回與此事件中的鍵關聯的整數 keyCode。
 int getKeyLocation()
          返回產生此按鍵事件的鍵位置。
static String getKeyModifiersText(int modifiers)
          返回描述修改鍵的 String,如 "Shift" 或 "Ctrl+Shift"。
static String getKeyText(int keyCode)
          返回描述 keyCode 的 String,如 "HOME"、"F1" 或 "A"。
 boolean isActionKey()
          返回此事件中的鍵是否為「動作」鍵。
 String paramString()
          返回標識此事件的參數字元串。
 void setKeyChar(char keyChar)
          設置 keyCode 值,以表示某個邏輯字元。
 void setKeyCode(int keyCode)
          設置 keyCode 值,以表示某個物理鍵。
 void setModifiers(int modifiers)
          已過時。 從 JDK1.1.4 開始
 
從類別 java.awt.event.InputEvent 繼承的方法
consume, getModifiers, getModifiersEx, getModifiersExText, getWhen, isAltDown, isAltGraphDown, isConsumed, isControlDown, isMetaDown, isShiftDown
 
從類別 java.awt.event.ComponentEvent 繼承的方法
getComponent
 
從類別 java.awt.AWTEvent 繼承的方法
getID, setSource, toString
 
從類別 java.util.EventObject 繼承的方法
getSource
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

欄位詳細資訊

KEY_FIRST

public static final int KEY_FIRST
用於鍵事件的 id 範圍的起始編號。

另請參見:
常數欄位值

KEY_LAST

public static final int KEY_LAST
用於鍵事件的 id 範圍的結束編號。

另請參見:
常數欄位值

KEY_TYPED

public static final int KEY_TYPED
“鍵入鍵”事件。輸入字元時產生此事件。最簡單的情況是,按下單個鍵產生該事件。但是,經常是通過一系列按鍵來產生字元,按下鍵事件和鍵入鍵事件的映射關係可能是多對一或多對多的。

另請參見:
常數欄位值

KEY_PRESSED

public static final int KEY_PRESSED
“按下鍵”事件。鍵被按下時產生此事件。

另請參見:
常數欄位值

KEY_RELEASED

public static final int KEY_RELEASED
“釋放鍵”事件。鬆開鍵時產生此事件。

另請參見:
常數欄位值

VK_ENTER

public static final int VK_ENTER
另請參見:
常數欄位值

VK_BACK_SPACE

public static final int VK_BACK_SPACE
另請參見:
常數欄位值

VK_TAB

public static final int VK_TAB
另請參見:
常數欄位值

VK_CANCEL

public static final int VK_CANCEL
另請參見:
常數欄位值

VK_CLEAR

public static final int VK_CLEAR
另請參見:
常數欄位值

VK_SHIFT

public static final int VK_SHIFT
另請參見:
常數欄位值

VK_CONTROL

public static final int VK_CONTROL
另請參見:
常數欄位值

VK_ALT

public static final int VK_ALT
另請參見:
常數欄位值

VK_PAUSE

public static final int VK_PAUSE
另請參見:
常數欄位值

VK_CAPS_LOCK

public static final int VK_CAPS_LOCK
另請參見:
常數欄位值

VK_ESCAPE

public static final int VK_ESCAPE
另請參見:
常數欄位值

VK_SPACE

public static final int VK_SPACE
另請參見:
常數欄位值

VK_PAGE_UP

public static final int VK_PAGE_UP
另請參見:
常數欄位值

VK_PAGE_DOWN

public static final int VK_PAGE_DOWN
另請參見:
常數欄位值

VK_END

public static final int VK_END
另請參見:
常數欄位值

VK_HOME

public static final int VK_HOME
另請參見:
常數欄位值

VK_LEFT

public static final int VK_LEFT
用於非數字鍵盤向左方向鍵的常數。

另請參見:
VK_KP_LEFT, 常數欄位值

VK_UP

public static final int VK_UP
用於非數字鍵盤向上方向鍵的常數。

另請參見:
VK_KP_UP, 常數欄位值

VK_RIGHT

public static final int VK_RIGHT
用於非數字鍵盤向右方向鍵的常數。

另請參見:
VK_KP_RIGHT, 常數欄位值

VK_DOWN

public static final int VK_DOWN
用於非數字鍵盤向下方向鍵的常數。

另請參見:
VK_KP_DOWN, 常數欄位值

VK_COMMA

public static final int VK_COMMA
用於逗號鍵 "," 的常數。

另請參見:
常數欄位值

VK_MINUS

public static final int VK_MINUS
用於減號鍵 "-" 的常數

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_PERIOD

public static final int VK_PERIOD
用於句點鍵 "." 的常數。

另請參見:
常數欄位值

VK_SLASH

public static final int VK_SLASH
用於正斜槓鍵 "/" 的常數。

另請參見:
常數欄位值

VK_0

public static final int VK_0
VK_0 到 VK_9 與 ASCII 的‘0’到‘9’(0x30 - 0x39) 相同

另請參見:
常數欄位值

VK_1

public static final int VK_1
另請參見:
常數欄位值

VK_2

public static final int VK_2
另請參見:
常數欄位值

VK_3

public static final int VK_3
另請參見:
常數欄位值

VK_4

public static final int VK_4
另請參見:
常數欄位值

VK_5

public static final int VK_5
另請參見:
常數欄位值

VK_6

public static final int VK_6
另請參見:
常數欄位值

VK_7

public static final int VK_7
另請參見:
常數欄位值

VK_8

public static final int VK_8
另請參見:
常數欄位值

VK_9

public static final int VK_9
另請參見:
常數欄位值

VK_SEMICOLON

public static final int VK_SEMICOLON
用於分號鍵 ";" 的常數。

另請參見:
常數欄位值

VK_EQUALS

public static final int VK_EQUALS
用於等號鍵 "=" 的常數。

另請參見:
常數欄位值

VK_A

public static final int VK_A
VK_A 到 VK_Z 與 ASCII 的‘A’到‘Z’(0x41 - 0x5A) 相同

另請參見:
常數欄位值

VK_B

public static final int VK_B
另請參見:
常數欄位值

VK_C

public static final int VK_C
另請參見:
常數欄位值

VK_D

public static final int VK_D
另請參見:
常數欄位值

VK_E

public static final int VK_E
另請參見:
常數欄位值

VK_F

public static final int VK_F
另請參見:
常數欄位值

VK_G

public static final int VK_G
另請參見:
常數欄位值

VK_H

public static final int VK_H
另請參見:
常數欄位值

VK_I

public static final int VK_I
另請參見:
常數欄位值

VK_J

public static final int VK_J
另請參見:
常數欄位值

VK_K

public static final int VK_K
另請參見:
常數欄位值

VK_L

public static final int VK_L
另請參見:
常數欄位值

VK_M

public static final int VK_M
另請參見:
常數欄位值

VK_N

public static final int VK_N
另請參見:
常數欄位值

VK_O

public static final int VK_O
另請參見:
常數欄位值

VK_P

public static final int VK_P
另請參見:
常數欄位值

VK_Q

public static final int VK_Q
另請參見:
常數欄位值

VK_R

public static final int VK_R
另請參見:
常數欄位值

VK_S

public static final int VK_S
另請參見:
常數欄位值

VK_T

public static final int VK_T
另請參見:
常數欄位值

VK_U

public static final int VK_U
另請參見:
常數欄位值

VK_V

public static final int VK_V
另請參見:
常數欄位值

VK_W

public static final int VK_W
另請參見:
常數欄位值

VK_X

public static final int VK_X
另請參見:
常數欄位值

VK_Y

public static final int VK_Y
另請參見:
常數欄位值

VK_Z

public static final int VK_Z
另請參見:
常數欄位值

VK_OPEN_BRACKET

public static final int VK_OPEN_BRACKET
用於左方括號鍵 "[" 的常數。

另請參見:
常數欄位值

VK_BACK_SLASH

public static final int VK_BACK_SLASH
用於反斜槓鍵 "\" 的常數。

另請參見:
常數欄位值

VK_CLOSE_BRACKET

public static final int VK_CLOSE_BRACKET
用於右方括號鍵 "]" 的常數。

另請參見:
常數欄位值

VK_NUMPAD0

public static final int VK_NUMPAD0
另請參見:
常數欄位值

VK_NUMPAD1

public static final int VK_NUMPAD1
另請參見:
常數欄位值

VK_NUMPAD2

public static final int VK_NUMPAD2
另請參見:
常數欄位值

VK_NUMPAD3

public static final int VK_NUMPAD3
另請參見:
常數欄位值

VK_NUMPAD4

public static final int VK_NUMPAD4
另請參見:
常數欄位值

VK_NUMPAD5

public static final int VK_NUMPAD5
另請參見:
常數欄位值

VK_NUMPAD6

public static final int VK_NUMPAD6
另請參見:
常數欄位值

VK_NUMPAD7

public static final int VK_NUMPAD7
另請參見:
常數欄位值

VK_NUMPAD8

public static final int VK_NUMPAD8
另請參見:
常數欄位值

VK_NUMPAD9

public static final int VK_NUMPAD9
另請參見:
常數欄位值

VK_MULTIPLY

public static final int VK_MULTIPLY
另請參見:
常數欄位值

VK_ADD

public static final int VK_ADD
另請參見:
常數欄位值

VK_SEPARATER

public static final int VK_SEPARATER
此常數已廢棄,包括它僅為了向後相容。

另請參見:
VK_SEPARATOR, 常數欄位值

VK_SEPARATOR

public static final int VK_SEPARATOR
用於數字鍵盤分隔符鍵的常數。

從以下版本開始:
1.4
另請參見:
常數欄位值

VK_SUBTRACT

public static final int VK_SUBTRACT
另請參見:
常數欄位值

VK_DECIMAL

public static final int VK_DECIMAL
另請參見:
常數欄位值

VK_DIVIDE

public static final int VK_DIVIDE
另請參見:
常數欄位值

VK_DELETE

public static final int VK_DELETE
另請參見:
常數欄位值

VK_NUM_LOCK

public static final int VK_NUM_LOCK
另請參見:
常數欄位值

VK_SCROLL_LOCK

public static final int VK_SCROLL_LOCK
另請參見:
常數欄位值

VK_F1

public static final int VK_F1
用於 F1 功能鍵的常數。

另請參見:
常數欄位值

VK_F2

public static final int VK_F2
用於 F2 功能鍵的常數。

另請參見:
常數欄位值

VK_F3

public static final int VK_F3
用於 F3 功能鍵的常數。

另請參見:
常數欄位值

VK_F4

public static final int VK_F4
用於 F4 功能鍵的常數。

另請參見:
常數欄位值

VK_F5

public static final int VK_F5
用於 F5 功能鍵的常數。

另請參見:
常數欄位值

VK_F6

public static final int VK_F6
用於 F6 功能鍵的常數。

另請參見:
常數欄位值

VK_F7

public static final int VK_F7
用於 F7 功能鍵的常數。

另請參見:
常數欄位值

VK_F8

public static final int VK_F8
用於 F8 功能鍵的常數。

另請參見:
常數欄位值

VK_F9

public static final int VK_F9
用於 F9 功能鍵的常數。

另請參見:
常數欄位值

VK_F10

public static final int VK_F10
用於 F10 功能鍵的常數。

另請參見:
常數欄位值

VK_F11

public static final int VK_F11
用於 F11 功能鍵的常數。

另請參見:
常數欄位值

VK_F12

public static final int VK_F12
用於 F12 功能鍵的常數。

另請參見:
常數欄位值

VK_F13

public static final int VK_F13
用於 F13 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F14

public static final int VK_F14
用於 F14 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F15

public static final int VK_F15
用於 F15 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F16

public static final int VK_F16
用於 F16 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F17

public static final int VK_F17
用於 F17 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F18

public static final int VK_F18
用於 F18 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F19

public static final int VK_F19
用於 F19 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F20

public static final int VK_F20
用於 F20 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F21

public static final int VK_F21
用於 F21 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F22

public static final int VK_F22
用於 F22 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F23

public static final int VK_F23
用於 F23 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_F24

public static final int VK_F24
用於 F24 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_PRINTSCREEN

public static final int VK_PRINTSCREEN
另請參見:
常數欄位值

VK_INSERT

public static final int VK_INSERT
另請參見:
常數欄位值

VK_HELP

public static final int VK_HELP
另請參見:
常數欄位值

VK_META

public static final int VK_META
另請參見:
常數欄位值

VK_BACK_QUOTE

public static final int VK_BACK_QUOTE
另請參見:
常數欄位值

VK_QUOTE

public static final int VK_QUOTE
另請參見:
常數欄位值

VK_KP_UP

public static final int VK_KP_UP
用於數字鍵盤向上方向鍵的常數。

從以下版本開始:
1.2
另請參見:
VK_UP, 常數欄位值

VK_KP_DOWN

public static final int VK_KP_DOWN
用於數字鍵盤向下方向鍵的常數。

從以下版本開始:
1.2
另請參見:
VK_DOWN, 常數欄位值

VK_KP_LEFT

public static final int VK_KP_LEFT
用於數字鍵盤向左方向鍵的常數。

從以下版本開始:
1.2
另請參見:
VK_LEFT, 常數欄位值

VK_KP_RIGHT

public static final int VK_KP_RIGHT
用於數字鍵盤向右方向鍵的常數。

從以下版本開始:
1.2
另請參見:
VK_RIGHT, 常數欄位值

VK_DEAD_GRAVE

public static final int VK_DEAD_GRAVE
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_ACUTE

public static final int VK_DEAD_ACUTE
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_CIRCUMFLEX

public static final int VK_DEAD_CIRCUMFLEX
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_TILDE

public static final int VK_DEAD_TILDE
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_MACRON

public static final int VK_DEAD_MACRON
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_BREVE

public static final int VK_DEAD_BREVE
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_ABOVEDOT

public static final int VK_DEAD_ABOVEDOT
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_DIAERESIS

public static final int VK_DEAD_DIAERESIS
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_ABOVERING

public static final int VK_DEAD_ABOVERING
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_DOUBLEACUTE

public static final int VK_DEAD_DOUBLEACUTE
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_CARON

public static final int VK_DEAD_CARON
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_CEDILLA

public static final int VK_DEAD_CEDILLA
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_OGONEK

public static final int VK_DEAD_OGONEK
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_IOTA

public static final int VK_DEAD_IOTA
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_VOICED_SOUND

public static final int VK_DEAD_VOICED_SOUND
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DEAD_SEMIVOICED_SOUND

public static final int VK_DEAD_SEMIVOICED_SOUND
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_AMPERSAND

public static final int VK_AMPERSAND
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_ASTERISK

public static final int VK_ASTERISK
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_QUOTEDBL

public static final int VK_QUOTEDBL
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_LESS

public static final int VK_LESS
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_GREATER

public static final int VK_GREATER
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_BRACELEFT

public static final int VK_BRACELEFT
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_BRACERIGHT

public static final int VK_BRACERIGHT
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_AT

public static final int VK_AT
用於 "@" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_COLON

public static final int VK_COLON
用於 ":" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_CIRCUMFLEX

public static final int VK_CIRCUMFLEX
用於 "^" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_DOLLAR

public static final int VK_DOLLAR
用於 "$" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_EURO_SIGN

public static final int VK_EURO_SIGN
用於歐洲貨幣符號鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_EXCLAMATION_MARK

public static final int VK_EXCLAMATION_MARK
用於 "!" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_INVERTED_EXCLAMATION_MARK

public static final int VK_INVERTED_EXCLAMATION_MARK
用於反向感歎號鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_LEFT_PARENTHESIS

public static final int VK_LEFT_PARENTHESIS
用於 "(" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_NUMBER_SIGN

public static final int VK_NUMBER_SIGN
用於 "#" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_PLUS

public static final int VK_PLUS
用於 "+" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_RIGHT_PARENTHESIS

public static final int VK_RIGHT_PARENTHESIS
用於 ")" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_UNDERSCORE

public static final int VK_UNDERSCORE
用於 "_" 鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_WINDOWS

public static final int VK_WINDOWS
用於 Microsoft Windows 的 "Windows" 鍵的常數。此常數同時用於左右兩個這種鍵。

從以下版本開始:
1.5
另請參見:
getKeyLocation(), 常數欄位值

VK_CONTEXT_MENU

public static final int VK_CONTEXT_MENU
用於 Microsoft Windows 上下文選單鍵的常數。

從以下版本開始:
1.5
另請參見:
常數欄位值

VK_FINAL

public static final int VK_FINAL
另請參見:
常數欄位值

VK_CONVERT

public static final int VK_CONVERT
用於 Convert 功能鍵的常數。

另請參見:
常數欄位值

VK_NONCONVERT

public static final int VK_NONCONVERT
用於 Don't Convert 功能鍵的常數。

另請參見:
常數欄位值

VK_ACCEPT

public static final int VK_ACCEPT
用於 Accept 或 Commit 功能鍵的常數。

另請參見:
常數欄位值

VK_MODECHANGE

public static final int VK_MODECHANGE
另請參見:
常數欄位值

VK_KANA

public static final int VK_KANA
另請參見:
常數欄位值

VK_KANJI

public static final int VK_KANJI
另請參見:
常數欄位值

VK_ALPHANUMERIC

public static final int VK_ALPHANUMERIC
用於 Alphanumeric 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_KATAKANA

public static final int VK_KATAKANA
用於 Katakana 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_HIRAGANA

public static final int VK_HIRAGANA
用於 Hiragana 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_FULL_WIDTH

public static final int VK_FULL_WIDTH
用於 Full-Width Characters 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_HALF_WIDTH

public static final int VK_HALF_WIDTH
用於 Half-Width Characters 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_ROMAN_CHARACTERS

public static final int VK_ROMAN_CHARACTERS
用於 Roman Characters 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_ALL_CANDIDATES

public static final int VK_ALL_CANDIDATES
用於 All Candidates 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_PREVIOUS_CANDIDATE

public static final int VK_PREVIOUS_CANDIDATE
用於 Previous Candidate 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_CODE_INPUT

public static final int VK_CODE_INPUT
用於 Code Input 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_JAPANESE_KATAKANA

public static final int VK_JAPANESE_KATAKANA
用於 Japanese-Katakana 功能鍵的常數。此鍵可切換到日文輸入法並選擇其 Katakana 輸入網要。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_JAPANESE_HIRAGANA

public static final int VK_JAPANESE_HIRAGANA
用於 Japanese-Hiragana 功能鍵的常數。此鍵可切換到日文輸入法並選擇其 Hiragana 輸入網要。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_JAPANESE_ROMAN

public static final int VK_JAPANESE_ROMAN
用於 Japanese-Roman 功能鍵的常數。此鍵可切換到日文輸入法並選擇其 Roman-Direct 輸入網要。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_KANA_LOCK

public static final int VK_KANA_LOCK
用於鎖定 Kana 功能鍵的常數。這將把鍵盤鎖定在 Kana 佈局。

從以下版本開始:
1.3
另請參見:
常數欄位值

VK_INPUT_METHOD_ON_OFF

public static final int VK_INPUT_METHOD_ON_OFF
用於輸入法開/關鍵的常數。

從以下版本開始:
1.3
另請參見:
常數欄位值

VK_CUT

public static final int VK_CUT
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_COPY

public static final int VK_COPY
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_PASTE

public static final int VK_PASTE
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_UNDO

public static final int VK_UNDO
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_AGAIN

public static final int VK_AGAIN
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_FIND

public static final int VK_FIND
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_PROPS

public static final int VK_PROPS
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_STOP

public static final int VK_STOP
從以下版本開始:
1.2
另請參見:
常數欄位值

VK_COMPOSE

public static final int VK_COMPOSE
用於 Compose 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_ALT_GRAPH

public static final int VK_ALT_GRAPH
用於 AltGraph 功能鍵的常數。

從以下版本開始:
1.2
另請參見:
常數欄位值

VK_BEGIN

public static final int VK_BEGIN
用於 Begin 鍵的常數。

從以下版本開始:
1.5
另請參見:
常數欄位值

VK_UNDEFINED

public static final int VK_UNDEFINED
此值用於指出 keyCode 是未知的。KEY_TYPED 事件沒有 keyCode 值,用此值代替。

另請參見:
常數欄位值

CHAR_UNDEFINED

public static final char CHAR_UNDEFINED
KEY_PRESSED 和 KEY_RELEASED 事件沒有映射到一個有效的 Unicode 字元時使用此值作為 keyChar 值。

另請參見:
常數欄位值

KEY_LOCATION_UNKNOWN

public static final int KEY_LOCATION_UNKNOWN
指示 keyLocation 為不確定或不相關的常數。KEY_TYPED 事件沒有 keyLocation,使用此值代替。

從以下版本開始:
1.4
另請參見:
常數欄位值

KEY_LOCATION_STANDARD

public static final int KEY_LOCATION_STANDARD
該常數指示按下或釋放的鍵不區分左右,並且不是發自數字鍵盤(或者不是發自對應於數字鍵盤的虛擬鍵)。

從以下版本開始:
1.4
另請參見:
常數欄位值

KEY_LOCATION_LEFT

public static final int KEY_LOCATION_LEFT
該常數指示按下或釋放的鍵位於左側(此鍵的位置有多種可能性)。範例:左側的 shift 鍵。

從以下版本開始:
1.4
另請參見:
常數欄位值

KEY_LOCATION_RIGHT

public static final int KEY_LOCATION_RIGHT
該常數指示按下或釋放的鍵位於右側(此鍵的位置有多種可能性)。範例:右側的 shift 鍵。

從以下版本開始:
1.4
另請參見:
常數欄位值

KEY_LOCATION_NUMPAD

public static final int KEY_LOCATION_NUMPAD
該常數指示按鍵事件發自於數字鍵盤或對應於數字鍵盤的虛擬鍵。

從以下版本開始:
1.4
另請參見:
常數欄位值
建構子詳細資訊

KeyEvent

public KeyEvent(Component source,
                int id,
                long when,
                int modifiers,
                int keyCode,
                char keyChar,
                int keyLocation)

KeyEvent

public KeyEvent(Component source,
                int id,
                long when,
                int modifiers,
                int keyCode,
                char keyChar)
建構一個 KeyEvent 物件。

注意,傳入無效的 id 將導致不明確的行為。如果 sourcenull,則此方法拋出 IllegalArgumentException

參數:
source - 產生事件的 Component
id - 標識事件型別的整數
when - 指定事件發生時間的 long 型整數
modifiers - 事件期間按下的修改鍵(shift、ctrl、alt、meta)。應該使用擴展的 _DOWN_MASK 修飾符或舊的 _MASK 修飾符,但是在一個事件中不應混用兩種模型。首選擴展的修飾符。
keyCode - 實際鍵的整數程式碼,或者為 VK_UNDEFINED(對於鍵入鍵事件)
keyChar - 此事件所產生的 Unicode 字元,或者為 CHAR_UNDEFINED(對於未映射到有效 Unicode 字元的按下鍵和釋放鍵事件)
拋出:
IllegalArgumentException - 如果 idKEY_TYPEDkeyCharCHAR_UNDEFINED;或者 idKEY_TYPEDkeyCode 不為 VK_UNDEFINED
IllegalArgumentException - 如果 source 為 null

KeyEvent

@Deprecated
public KeyEvent(Component source,
                           int id,
                           long when,
                           int modifiers,
                           int keyCode)
已過時。 從 JDK1.1 開始

方法詳細資訊

getKeyCode

public int getKeyCode()
返回與此事件中的鍵關聯的整數 keyCode。

返回:
鍵盤上實際鍵的整數程式碼。(對於 KEY_TYPED 事件,該 keyCode 為 VK_UNDEFINED。)

setKeyCode

public void setKeyCode(int keyCode)
設置 keyCode 值,以表示某個物理鍵。

參數:
keyCode - 與鍵盤上實際鍵相對應的一個整數。

getKeyChar

public char getKeyChar()
返回與此事件中的鍵關聯的字元。例如,shift + "a" 的 KEY_TYPED 事件返回值 "A"。

KEY_PRESSEDKEY_RELEASED 事件不用於報告字元輸入。因此,可以保證此方法返回的值只對 KEY_TYPED 事件有意義。

返回:
為此按鍵事件定義的 Unicode 字元。如果對於此按鍵事件沒有有效的 Unicode 字元,則返回 CHAR_UNDEFINED

setKeyChar

public void setKeyChar(char keyChar)
設置 keyCode 值,以表示某個邏輯字元。

參數:
keyChar - 與構成此事件的鍵擊組合相對應的 char 值。

setModifiers

@Deprecated
public void setModifiers(int modifiers)
已過時。 從 JDK1.1.4 開始

設置修飾符,以指出所按住的修改鍵(例如 shift、ctrl、alt、meta),該動作被定義為 InputEvent 的一部分。

註:因為很多 AWT 實作不識別修飾符的改變,所以不推薦使用此方法。對於其中更改了 shift 修飾符的 KEY_TYPED 事件更是如此。

參數:
modifiers - 修飾符常數的整陣列合。
另請參見:
InputEvent

getKeyLocation

public int getKeyLocation()
返回產生此按鍵事件的鍵位置。 某些鍵在鍵盤上出現多次,如左右 shift 鍵。另外,某些鍵則出現在數字鍵盤上。此方法提供了一種區分這些鍵的方式。

返回:
被按下或釋放的鍵的位置。總是為 KEY_TYPED 事件返回 KEY_LOCATION_UNKNOWN
從以下版本開始:
1.4

getKeyText

public static String getKeyText(int keyCode)
返回描述 keyCode 的 String,如 "HOME"、"F1" 或 "A"。通過更改 awt.properties 檔案可以本地化這些字元串。

返回:
包含物理鍵文本描述的字元串,物理鍵通過其 keyCode 標識。

getKeyModifiersText

public static String getKeyModifiersText(int modifiers)
返回描述修改鍵的 String,如 "Shift" 或 "Ctrl+Shift"。通過更改 awt.properties 檔案可以本地化這些字元串。

注意,InputEvent.ALT_MASKInputEvent.BUTTON2_MASK 具有相同的值,所以對這兩個修飾符返回字元串 "Alt"。同樣,InputEvent.META_MASKInputEvent.BUTTON3_MASK 具有相同的值,所以對這兩個修飾符返回字元串 "Meta"。

返回:
一個字元串,它是在事件期間所按住的修改鍵組合的文本描述
另請參見:
InputEvent.getModifiersExText(int)

isActionKey

public boolean isActionKey()
返回此事件中的鍵是否為「動作」鍵。通常動作鍵不會觸發 unicode 字元並且不是修改鍵。

返回:
如果該鍵是「動作」鍵,則返回 true;否則返回 false

paramString

public String paramString()
返回標識此事件的參數字元串。此方法對於事件記錄和除錯很有用。

覆寫:
類別 ComponentEvent 中的 paramString
返回:
標識事件及其屬性的字元串

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only