|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.util.EventObject | +--java.awt.AWTEvent | +--java.awt.event.ComponentEvent | +--java.awt.event.InputEvent | +--java.awt.event.KeyEvent
このイベントは、コンポーネントにおいてキーストロークが発生したことを示します。
この低レベルのイベントは、キーを押したり(キープレス)、離したり(キーリリース)、押してから離した (キータイプ) ときに、コンポーネントオブジェクト (テキストフィールドなど) によって生成されます。発生したイベントは、コンポーネントの addKeyListner
メソッドを使って、そのようなイベントを受け取るように登録されているすべての KeyListener
オブジェクトまたは KeyAdapter
オブジェクトに渡されます。KeyAdapter
オブジェクトは、 KeyListener
インタフェースを実装しています。各リスナーオブジェクトは、イベントが発生したときに KeyEvent
を取得します。
「キータイプ」イベントは、ほかの 2 つのイベントと比べてレベルの高いイベントであり、プラットフォームやキーボードの配置には依存しません。キータイプイベントは、文字が入力されたときに生成され、文字入力の検出において優先される方法です。もっとも単純な例としては、キープレスに続いてキーリリースが起こったときにキータイプイベントが発生します。しかし、一連のキープレスとキーリリースの組み合わせによって文字を作ることがよくあります。また、キープレス/キーリリースイベントからキータイプイベントへのマッピングは n:1 または n:m になる場合があります。アクションキー、修飾キーなど文字を生成しないキーでは、キータイプイベントは発生しません。getKeyChar メソッドは常に有効な Unicode 文字または CHAR_UNDEFINED を返します。キープレスおよびキーリリースイベントに対しては、getKeyCode メソッドがイベントの keyCode を返します。キータイプイベントに対しては、getKeyCode メソッドが常に VK_UNDEFINED を返します。
「キープレス」および「キーリリース」イベントは、「キータイプ」イベントより低レベルのイベントであり、プラットフォームおよびキーボードの配置に依存します。これらのイベントは、キーを押したとき、または離したときに発生します。文字入力が発生しないキー (アクションキー、修飾キーなど) についての状態を知るには、これらのイベントに依存するしか方法はありません。押されたキーや離されたキーは、getKeyCode メソッドによって取得できます。このメソッドは、仮想キーコードを返します。
「仮想キーコード」は、1 つ以上のキーストロークの組み合わせによって生成された文字 (たとえば、Shift キーと 「a」キーで「A」が生成される) ではなく、キーボード上のどのキーが押されたまたは離されたのかを報告するために使用されます。
たとえば、Shift キーを押すと VK_SHIFT キーコードを伴う KEY_PRESSED イベントが発生します。一方、「a」キーを押した結果は、VK_A という keyCode になります。そして、「a」キーを離すと VK_A を伴う KEY_RELEASED イベントが発生します。さらに、これとは別に keyChar 値「A」を伴う KEY_TYPED イベントが発生します。
注:
警告: Java 言語で定義されているキー (VK_ENTER、VK_BACK_SPACE、VK_TAB) を除き、仮想キーの定数の値に頼らないでください。 Sun は、将来広範囲のキーボードに適応させるため、必要に応じてこれらの値を変更する権利を留保します。
KeyAdapter
,
KeyListener
,
Tutorial: Writing a Key Listener,
Reference: The Java Class Libraries (update file), 直列化された形式フィールドの概要 | |
static char |
CHAR_UNDEFINED
有効な Unicode 文字にマッピングしない KEY_PRESSED イベントおよび KEY_RELEASED イベントは、keyChar の値としてこの定数を使います。 |
static int |
KEY_FIRST
キーイベント識別子に使う整数の範囲にある、最初の番号です。 |
static int |
KEY_LAST
キーイベント識別子に使う整数の範囲にある、最後の番号です。 |
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
|
static int |
VK_ADD
|
static int |
VK_AGAIN
|
static int |
VK_ALL_CANDIDATES
「全候補」ファンクションキー用の定数です。 |
static int |
VK_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_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
「コード入力」ファンクションキー用の定数です。 |
static int |
VK_COLON
「:」キー用の定数です。 |
static int |
VK_COMMA
|
static int |
VK_COMPOSE
「変換」ファンクションキー用の定数です。 |
static int |
VK_CONTROL
|
static int |
VK_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
「全角」ファンクションキー用の定数です。 |
static int |
VK_G
|
static int |
VK_GREATER
|
static int |
VK_H
|
static int |
VK_HALF_WIDTH
「半角」ファンクションキー用の定数です。 |
static int |
VK_HELP
|
static int |
VK_HIRAGANA
「ひらがな」ファンクションキー用の定数です。 |
static int |
VK_HOME
|
static int |
VK_I
|
static int |
VK_INSERT
|
static int |
VK_INVERTED_EXCLAMATION_MARK
逆向きの感嘆符キー用の定数です。 |
static int |
VK_J
|
static int |
VK_JAPANESE_HIRAGANA
「日本語-ひらがな」ファンクションキー用の定数です。 |
static int |
VK_JAPANESE_KATAKANA
「日本語-カタカナ」ファンクションキー用の定数です。 |
static int |
VK_JAPANESE_ROMAN
「日本語-ローマ字」ファンクションキー用の定数です。 |
static int |
VK_K
|
static int |
VK_KANA
|
static int |
VK_KANJI
|
static int |
VK_KATAKANA
「カタカナ」ファンクションキー用の定数です。 |
static int |
VK_KP_DOWN
|
static int |
VK_KP_LEFT
|
static int |
VK_KP_RIGHT
|
static int |
VK_KP_UP
KeyPad カーソルの矢印キー用の定数です。 |
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
|
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
「前候補」ファンクションキー用の定数です。 |
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
「ローマ字」ファンクションキー用の定数です。 |
static int |
VK_S
|
static int |
VK_SCROLL_LOCK
|
static int |
VK_SEMICOLON
|
static int |
VK_SEPARATER
|
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
KEY_TYPED イベントには、keyCode 値はありません。 |
static int |
VK_UNDERSCORE
「_」キー用の定数です。 |
static int |
VK_UNDO
|
static int |
VK_UP
|
static int |
VK_V
|
static int |
VK_W
|
static int |
VK_X
|
static int |
VK_Y
|
static int |
VK_Z
|
クラス java.awt.event.InputEvent から継承したフィールド |
ALT_GRAPH_MASK,
ALT_MASK,
BUTTON1_MASK,
BUTTON2_MASK,
BUTTON3_MASK,
CTRL_MASK,
META_MASK,
SHIFT_MASK |
クラス java.awt.event.ComponentEvent から継承したフィールド |
COMPONENT_FIRST,
COMPONENT_HIDDEN,
COMPONENT_LAST,
COMPONENT_MOVED,
COMPONENT_RESIZED,
COMPONENT_SHOWN |
クラス java.util.EventObject から継承したフィールド |
source |
コンストラクタの概要 | |
KeyEvent(Component source,
int id,
long when,
int modifiers,
int keyCode)
|
|
KeyEvent(Component source,
int id,
long when,
int modifiers,
int keyCode,
char keyChar)
KeyEvent オブジェクトを構築します。 |
メソッドの概要 | |
char |
getKeyChar()
このイベントのキーに関連付けられた文字を返します。 |
int |
getKeyCode()
このイベントのキーに関連付けられた整数型のキーコードを返します。 |
static String |
getKeyModifiersText(int modifiers)
Shift や Ctrl+Shift などの修飾キーを記述する String を返します。 |
static String |
getKeyText(int keyCode)
HOME、 F1、A などの keyCode を記述する String を返します。 |
boolean |
isActionKey()
Event.java での定義に基づいて、このイベントのキーがアクションキーであるかどうかを返します。 |
String |
paramString()
このイベントを特定するパラメータの文字列を返します。 |
void |
setKeyChar(char keyChar)
論理的な文字を示す keyChar 値を設定します。 |
void |
setKeyCode(int keyCode)
物理的なキーを示す keyCode 値を設定します。 |
void |
setModifiers(int modifiers)
推奨されません。 JDK1.1.4 以降 |
クラス java.awt.event.InputEvent から継承したメソッド |
consume,
getModifiers,
getWhen,
isAltDown,
isAltGraphDown,
isConsumed,
isControlDown,
isMetaDown,
isShiftDown |
クラス java.awt.event.ComponentEvent から継承したメソッド |
getComponent |
クラス java.awt.AWTEvent から継承したメソッド |
finalize,
getID,
toString |
クラス java.util.EventObject から継承したメソッド |
getSource |
クラス java.lang.Object から継承したメソッド |
clone,
equals,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
フィールドの詳細 |
public static final int KEY_FIRST
public static final int KEY_LAST
public static final int KEY_TYPED
public static final int KEY_PRESSED
public static final int KEY_RELEASED
public static final int VK_ENTER
public static final int VK_BACK_SPACE
public static final int VK_TAB
public static final int VK_CANCEL
public static final int VK_CLEAR
public static final int VK_SHIFT
public static final int VK_CONTROL
public static final int VK_ALT
public static final int VK_PAUSE
public static final int VK_CAPS_LOCK
public static final int VK_ESCAPE
public static final int VK_SPACE
public static final int VK_PAGE_UP
public static final int VK_PAGE_DOWN
public static final int VK_END
public static final int VK_HOME
public static final int VK_LEFT
public static final int VK_UP
public static final int VK_RIGHT
public static final int VK_DOWN
public static final int VK_COMMA
public static final int VK_MINUS
public static final int VK_PERIOD
public static final int VK_SLASH
public static final int VK_0
public static final int VK_1
public static final int VK_2
public static final int VK_3
public static final int VK_4
public static final int VK_5
public static final int VK_6
public static final int VK_7
public static final int VK_8
public static final int VK_9
public static final int VK_SEMICOLON
public static final int VK_EQUALS
public static final int VK_A
public static final int VK_B
public static final int VK_C
public static final int VK_D
public static final int VK_E
public static final int VK_F
public static final int VK_G
public static final int VK_H
public static final int VK_I
public static final int VK_J
public static final int VK_K
public static final int VK_L
public static final int VK_M
public static final int VK_N
public static final int VK_O
public static final int VK_P
public static final int VK_Q
public static final int VK_R
public static final int VK_S
public static final int VK_T
public static final int VK_U
public static final int VK_V
public static final int VK_W
public static final int VK_X
public static final int VK_Y
public static final int VK_Z
public static final int VK_OPEN_BRACKET
public static final int VK_BACK_SLASH
public static final int VK_CLOSE_BRACKET
public static final int VK_NUMPAD0
public static final int VK_NUMPAD1
public static final int VK_NUMPAD2
public static final int VK_NUMPAD3
public static final int VK_NUMPAD4
public static final int VK_NUMPAD5
public static final int VK_NUMPAD6
public static final int VK_NUMPAD7
public static final int VK_NUMPAD8
public static final int VK_NUMPAD9
public static final int VK_MULTIPLY
public static final int VK_ADD
public static final int VK_SEPARATER
public static final int VK_SUBTRACT
public static final int VK_DECIMAL
public static final int VK_DIVIDE
public static final int VK_DELETE
public static final int VK_NUM_LOCK
public static final int VK_SCROLL_LOCK
public static final int VK_F1
public static final int VK_F2
public static final int VK_F3
public static final int VK_F4
public static final int VK_F5
public static final int VK_F6
public static final int VK_F7
public static final int VK_F8
public static final int VK_F9
public static final int VK_F10
public static final int VK_F11
public static final int VK_F12
public static final int VK_F13
public static final int VK_F14
public static final int VK_F15
public static final int VK_F16
public static final int VK_F17
public static final int VK_F18
public static final int VK_F19
public static final int VK_F20
public static final int VK_F21
public static final int VK_F22
public static final int VK_F23
public static final int VK_F24
public static final int VK_PRINTSCREEN
public static final int VK_INSERT
public static final int VK_HELP
public static final int VK_META
public static final int VK_BACK_QUOTE
public static final int VK_QUOTE
public static final int VK_KP_UP
public static final int VK_KP_DOWN
public static final int VK_KP_LEFT
public static final int VK_KP_RIGHT
public static final int VK_DEAD_GRAVE
public static final int VK_DEAD_ACUTE
public static final int VK_DEAD_CIRCUMFLEX
public static final int VK_DEAD_TILDE
public static final int VK_DEAD_MACRON
public static final int VK_DEAD_BREVE
public static final int VK_DEAD_ABOVEDOT
public static final int VK_DEAD_DIAERESIS
public static final int VK_DEAD_ABOVERING
public static final int VK_DEAD_DOUBLEACUTE
public static final int VK_DEAD_CARON
public static final int VK_DEAD_CEDILLA
public static final int VK_DEAD_OGONEK
public static final int VK_DEAD_IOTA
public static final int VK_DEAD_VOICED_SOUND
public static final int VK_DEAD_SEMIVOICED_SOUND
public static final int VK_AMPERSAND
public static final int VK_ASTERISK
public static final int VK_QUOTEDBL
public static final int VK_LESS
public static final int VK_GREATER
public static final int VK_BRACELEFT
public static final int VK_BRACERIGHT
public static final int VK_AT
public static final int VK_COLON
public static final int VK_CIRCUMFLEX
public static final int VK_DOLLAR
public static final int VK_EURO_SIGN
public static final int VK_EXCLAMATION_MARK
public static final int VK_INVERTED_EXCLAMATION_MARK
public static final int VK_LEFT_PARENTHESIS
public static final int VK_NUMBER_SIGN
public static final int VK_PLUS
public static final int VK_RIGHT_PARENTHESIS
public static final int VK_UNDERSCORE
public static final int VK_FINAL
public static final int VK_CONVERT
public static final int VK_NONCONVERT
public static final int VK_ACCEPT
public static final int VK_MODECHANGE
public static final int VK_KANA
public static final int VK_KANJI
public static final int VK_ALPHANUMERIC
public static final int VK_KATAKANA
public static final int VK_HIRAGANA
public static final int VK_FULL_WIDTH
public static final int VK_HALF_WIDTH
public static final int VK_ROMAN_CHARACTERS
public static final int VK_ALL_CANDIDATES
public static final int VK_PREVIOUS_CANDIDATE
public static final int VK_CODE_INPUT
public static final int VK_JAPANESE_KATAKANA
public static final int VK_JAPANESE_HIRAGANA
public static final int VK_JAPANESE_ROMAN
public static final int VK_CUT
public static final int VK_COPY
public static final int VK_PASTE
public static final int VK_UNDO
public static final int VK_AGAIN
public static final int VK_FIND
public static final int VK_PROPS
public static final int VK_STOP
public static final int VK_COMPOSE
public static final int VK_ALT_GRAPH
public static final int VK_UNDEFINED
public static final char CHAR_UNDEFINED
コンストラクタの詳細 |
public KeyEvent(Component source, int id, long when, int modifiers, int keyCode, char keyChar)
source
- イベントの発生元の Componentid
- イベントのタイプを特定する整数when
- イベントが発生した時間を指定する long 整数modifiers
- イベントが発生しているときに押された修飾キー (Shift、Ctrl、Alt、メタ)keyCode
- 実際のキーに対応するコードの int または VK_UNDEFINED (キータイプイベントの場合)keyChar
- イベントによって生成された Unicode 文字、または CHAR_UNDEFINED (有効な Unicode 文字にマッピングしないキープレスイベントおよびキーリリースイベントの場合)public KeyEvent(Component source, int id, long when, int modifiers, int keyCode)
メソッドの詳細 |
public int getKeyCode()
public void setKeyCode(int keyCode)
keyCode
- キーボード上の実際のキーに対応する整数public void setKeyChar(char keyChar)
keyChar
- このイベントを発生したキーストロークの組み合わせに対応する charpublic void setModifiers(int modifiers)
注: このメソッドの使用は推奨されません。これは、AWT 実装の多くが修飾子の変更を認識しないためです。シフト修飾子が変更されたときの KEY_TYPED イベントの使用は、特に推奨できません。
modifiers
- 修飾子定数を組み合わせた整数InputEvent
public char getKeyChar()
public static String getKeyText(int keyCode)
public static String getKeyModifiersText(int modifiers)
public boolean isActionKey()
Event
public String paramString()
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |