    All Packages  Class Hierarchy  This Package  Previous  Next  Index

# Class 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

public class KeyEvent
extends InputEvent

The component-level keyboard event.

##

CHAR_UNDEFINED
  KEY_PRESSED and KEY_RELEASED events which do not map to a valid Unicode character do not have a defined keyChar.
KEY_FIRST
  Marks the first integer id for the range of key event ids.
KEY_LAST
  Marks the last integer id for the range of key event ids.
KEY_PRESSED
  The key pressed event type.
KEY_RELEASED
  The key released event type.
KEY_TYPED
  The key typed event type.
VK_0
  VK_0 thru VK_9 are the same as ASCII '0' thru '9' (0x30 - 0x39)
VK_1
VK_2
VK_3
VK_4
VK_5
VK_6
VK_7
VK_8
VK_9
VK_A
  VK_A thru VK_Z are the same as ASCII 'A' thru 'Z' (0x41 - 0x5A)
VK_ACCEPT
VK_ADD
VK_ALT
VK_B
VK_BACK_QUOTE
VK_BACK_SLASH
VK_BACK_SPACE
VK_C
VK_CANCEL
VK_CAPS_LOCK
VK_CLEAR
VK_CLOSE_BRACKET
VK_COMMA
VK_CONTROL
VK_CONVERT
VK_D
VK_DECIMAL
VK_DELETE
VK_DIVIDE
VK_DOWN
VK_E
VK_END
VK_ENTER
  Virtual key codes.
VK_EQUALS
VK_ESCAPE
VK_F
VK_F1
VK_F10
VK_F11
VK_F12
VK_F2
VK_F3
VK_F4
VK_F5
VK_F6
VK_F7
VK_F8
VK_F9
VK_FINAL
  for Asian Keyboard
VK_G
VK_H
VK_HELP
VK_HOME
VK_I
VK_INSERT
VK_J
VK_K
VK_KANA
VK_KANJI
VK_L
VK_LEFT
VK_M
VK_META
VK_MODECHANGE
VK_MULTIPLY
VK_N
VK_NONCONVERT
VK_NUM_LOCK
VK_NUMPAD0
VK_NUMPAD1
VK_NUMPAD2
VK_NUMPAD3
VK_NUMPAD4
VK_NUMPAD5
VK_NUMPAD6
VK_NUMPAD7
VK_NUMPAD8
VK_NUMPAD9
VK_O
VK_OPEN_BRACKET
VK_P
VK_PAGE_DOWN
VK_PAGE_UP
VK_PAUSE
VK_PERIOD
VK_PRINTSCREEN
VK_Q
VK_QUOTE
VK_R
VK_RIGHT
VK_S
VK_SCROLL_LOCK
VK_SEMICOLON
VK_SEPARATER
VK_SHIFT
VK_SLASH
VK_SPACE
VK_SUBTRACT
VK_T
VK_TAB
VK_U
VK_UNDEFINED
  KEY_TYPED events do not have a defined keyCode.
VK_UP
VK_V
VK_W
VK_X
VK_Y
VK_Z

##

KeyEvent(Component, int, long, int, int)
KeyEvent(Component, int, long, int, int, char)
  Constructs a KeyEvent object with the specified source component, type, modifiers, and key.

##

getKeyChar()
  Returns the character associated with the key in this event.
getKeyCode()
  Returns the integer key-code associated with the key in this event.
getKeyModifiersText(int)
  Returns a String describing the modifier key(s), such as "Shift", or "Ctrl+Shift".
getKeyText(int)
  Returns a String describing the keyCode, such as "HOME", "F1" or "A".
isActionKey()
  Returns whether or not the key in this event is an "action" key, as defined in Event.java.
paramString()
setKeyChar(char)
setKeyCode(int)
setModifiers(int)
  Change the modifiers for a KeyEvent. Deprecated.

##

KEY_FIRST

     public static final int KEY_FIRST

  Marks the first integer id for the range of key event ids.

KEY_LAST

     public static final int KEY_LAST

  Marks the last integer id for the range of key event ids.

KEY_TYPED

     public static final int KEY_TYPED

  The key typed event type. This type is generated by a combination of a key press followed by a key release.

KEY_PRESSED

     public static final int KEY_PRESSED

  The key pressed event type.

KEY_RELEASED

     public static final int KEY_RELEASED

  The key released event type.

VK_ENTER

     public static final int VK_ENTER

  Virtual key codes. These codes report which keyboard key has been pressed, rather than any character generated by one or more keys being pressed. For example, pressing the Shift key will cause a KEY_PRESSED event with a VK_SHIFT keyCode, while pressing the 'a' key will result in a VK_A keyCode. After the 'a' key is released, a KEY_RELEASED event will be fired with VK_A, followed by a KEY_TYPED event with a keyChar value of 'A'. Key combinations which do not result in characters, such as action keys like F1, will not generate KEY_TYPED events. Note: not all keyboards or systems are capable of generating all virtual key codes. No attempt is made in Java to artificially generate these keys. WARNING: aside from those keys where are defined by the Java language (VK_ENTER, VK_BACK_SPACE, and VK_TAB), do not rely on the values of these constants. Sun reserves the right to change these values as needed to accomodate a wider range of keyboards in the future.

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_UP

     public static final int VK_UP

VK_RIGHT

     public static final int VK_RIGHT

VK_DOWN

     public static final int VK_DOWN

VK_COMMA

     public static final int VK_COMMA

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 thru VK_9 are the same as ASCII '0' thru '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 thru VK_Z are the same as ASCII 'A' thru '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_SUBTRACT

     public static final int VK_SUBTRACT

VK_DECIMAL

     public static final int VK_DECIMAL

VK_DIVIDE

     public static final int VK_DIVIDE

VK_F1

     public static final int VK_F1

VK_F2

     public static final int VK_F2

VK_F3

     public static final int VK_F3

VK_F4

     public static final int VK_F4

VK_F5

     public static final int VK_F5

VK_F6

     public static final int VK_F6

VK_F7

     public static final int VK_F7

VK_F8

     public static final int VK_F8

VK_F9

     public static final int VK_F9

VK_F10

     public static final int VK_F10

VK_F11

     public static final int VK_F11

VK_F12

     public static final int VK_F12

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_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_FINAL

     public static final int VK_FINAL

  for Asian Keyboard

VK_CONVERT

     public static final int VK_CONVERT

VK_NONCONVERT

     public static final int VK_NONCONVERT

VK_ACCEPT

     public static final int VK_ACCEPT

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_UNDEFINED

     public static final int VK_UNDEFINED

  KEY_TYPED events do not have a defined keyCode.

CHAR_UNDEFINED

     public static final char CHAR_UNDEFINED

  KEY_PRESSED and KEY_RELEASED events which do not map to a valid Unicode character do not have a defined keyChar.

##

KeyEvent

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

  Constructs a KeyEvent object with the specified source component, type, modifiers, and key.

  Parameters:
    source - the object where the event originated

KeyEvent

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

##

getKeyCode

     public int getKeyCode()

  Returns the integer key-code associated with the key in this event. For KEY_TYPED events, keyCode is VK_UNDEFINED.

setKeyCode

     public void setKeyCode(int keyCode)

setKeyChar

     public void setKeyChar(char keyChar)

setModifiers

     public void setModifiers(int modifiers)

  Note: setModifiers() is deprecated. , as of JDK1.1.4

  Change the modifiers for a KeyEvent.

  NOTE: use of this method is not recommended, because many AWT implementations do not recognize modifier changes. This is especially true for KEY_TYPED events where the shift modifier is changed.

getKeyChar

     public char getKeyChar()

  Returns the character associated with the key in this event. If no valid Unicode character exists for this key event, keyChar is CHAR_UNDEFINED.

getKeyText

     public static String getKeyText(int keyCode)

  Returns a String describing the keyCode, such as "HOME", "F1" or "A". These strings can be localized by changing the awt.properties file.

getKeyModifiersText

     public static String getKeyModifiersText(int modifiers)

  Returns a String describing the modifier key(s), such as "Shift", or "Ctrl+Shift". These strings can be localized by changing the awt.properties file.

isActionKey

     public boolean isActionKey()

  Returns whether or not the key in this event is an "action" key, as defined in Event.java.

paramString

     public String paramString()

  Overrides:
    paramString in class ComponentEvent

    All Packages  Class Hierarchy  This Package  Previous  Next  Index

Submit a bug or feature - Version 1.1.8 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1999 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.