JavaTM 2
Platform
Std. Ed. v1.4.0

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
          Alt+Graph キーの拡張定数です。
static int ALT_GRAPH_MASK
          Alt+Graph キーの定数です。
static int ALT_MASK
          Alt キーの定数です。
static int BUTTON1_DOWN_MASK
          マウスボタン 1 の拡張定数です。
static int BUTTON1_MASK
          マウスボタン 1 の定数です。
static int BUTTON2_DOWN_MASK
          マウスボタン 2 の拡張定数です。
static int BUTTON2_MASK
          マウスボタン 2 の定数です。
static int BUTTON3_DOWN_MASK
          マウスボタン 3 の拡張定数です。
static int BUTTON3_MASK
          マウスボタン 3 の定数です。
static int CTRL_DOWN_MASK
          Ctrl キーの拡張定数です。
static int CTRL_MASK
          Ctrl キーの定数です。
static int META_DOWN_MASK
          メタキーの拡張定数です。
static int META_MASK
          メタキーの定数です。
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 キーが押されていたかどうかを返します。
 boolean isAltGraphDown()
          イベントで Alt+Graph キーが押されていたかどうかを返します。
 boolean isConsumed()
          このイベントが消費されたかどうかを返します。
 boolean isControlDown()
          イベントで Ctrl キーが押されていたかどうかを返します。
 boolean isMetaDown()
          イベントでメタキーが押されていたかどうかを返します。
 boolean isShiftDown()
          イベントで Shift キーが押されていたかどうかを返します。
 
クラス 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_DOWN_MASK を使用することをお勧めします。

関連項目:
定数フィールド値

ALT_MASK

public static final int ALT_MASK
Alt キーの定数です。代わりに、ALT_DOWN_MASK を使用することをお勧めします。

関連項目:
定数フィールド値

ALT_GRAPH_MASK

public static final int ALT_GRAPH_MASK
Alt+Graph キーの定数です。

関連項目:
定数フィールド値

BUTTON1_MASK

public static final int BUTTON1_MASK
マウスボタン 1 の定数です。代わりに、BUTTON1_DOWN_MASK を使用することをお勧めします。

関連項目:
定数フィールド値

BUTTON2_MASK

public static final int BUTTON2_MASK
マウスボタン 2 の定数です。代わりに、BUTTON2_DOWN_MASK を使用することをお勧めします。

関連項目:
定数フィールド値

BUTTON3_MASK

public static final int BUTTON3_MASK
マウスボタン 3 の定数です。代わりに、BUTTON3_DOWN_MASK を使用することをお勧めします。

関連項目:
定数フィールド値

SHIFT_DOWN_MASK

public static final int SHIFT_DOWN_MASK
Shift キーの拡張定数です。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

CTRL_DOWN_MASK

public static final int CTRL_DOWN_MASK
Ctrl キーの拡張定数です。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

META_DOWN_MASK

public static final int META_DOWN_MASK
メタキーの拡張定数です。

導入されたバージョン:
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
マウスボタン 1 の拡張定数です。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

BUTTON2_DOWN_MASK

public static final int BUTTON2_DOWN_MASK
マウスボタン 2 の拡張定数です。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

BUTTON3_DOWN_MASK

public static final int BUTTON3_DOWN_MASK
マウスボタン 3 の拡張定数です。

導入されたバージョン:
1.4
関連項目:
定数フィールド値

ALT_GRAPH_DOWN_MASK

public static final int ALT_GRAPH_DOWN_MASK
Alt+Graph キーの拡張定数です。

導入されたバージョン:
1.4
関連項目:
定数フィールド値
メソッドの詳細

isShiftDown

public boolean isShiftDown()
イベントで Shift キーが押されていたかどうかを返します。


isControlDown

public boolean isControlDown()
イベントで Ctrl キーが押されていたかどうかを返します。


isMetaDown

public boolean isMetaDown()
イベントでメタキーが押されていたかどうかを返します。


isAltDown

public boolean isAltDown()
イベントで Alt キーが押されていたかどうかを返します。


isAltGraphDown

public boolean isAltGraphDown()
イベントで Alt+Graph キーが押されていたかどうかを返します。


getWhen

public long getWhen()
このイベントが発生した時点のタイムスタンプを返します。


getModifiers

public int getModifiers()
このイベントに関する修飾子のフラグを返します。


getModifiersEx

public int getModifiersEx()
このイベントに関する拡張修飾子のフラグを返します。拡張修飾子は、イベントが発生した直後の Alt、Ctrl、メタキーやマウスボタンなど、すべてのモーダルキーの状態を表します。

たとえば、ユーザがボタン 1 に続いてボタン 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 キーと Button 1 を押して 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 ファイルを変更することにより地域対応が可能です。

戻り値:
イベント発生時に押されていた拡張修飾キーの組み合わせを記述するテキスト文字列
導入されたバージョン:
1.4

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.