APIdia Launch Partner
Top Description Fields Constructors Methods
java.awt

public Class Event

extends Object
implements Serializable
Class Inheritance
All Implemented Interfaces
java.io.Serializable
Annotations
@Deprecated
since:9
Imports
java.awt.event.KeyEvent, java.io.Serial

Deprecated

since 9.

It is recommended that AWTEvent and its subclasses be used instead

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Event is a platform-independent class that encapsulates events from the platform's Graphical User Interface in the Java 1.0 event model. In Java 1.1 and later versions, the Event class is maintained only for backwards compatibility. The information in this class description is provided to assist programmers in converting Java 1.0 programs to the new event model.

In the Java 1.0 event model, an event contains an Event#id field that indicates what type of event it is and which other Event variables are relevant for the event.

For keyboard events, Event#key contains a value indicating which key was activated, and Event#modifiers contains the modifiers for that event. For the KEY_PRESS and KEY_RELEASE event ids, the value of key is the unicode character code for the key. For KEY_ACTION and KEY_ACTION_RELEASE, the value of key is one of the defined action-key identifiers in the Event class (PGUP, PGDN, F1, F2, etc).

Author
Sami Shaio
Since
1.0

Field Summary

Modifier and TypeField and Description
public static final int
ACTION_EVENT

This event indicates that the user wants some action to occur.

private static final int[][]
public static final int
ALT_MASK

This flag indicates that the Alt key was down when the event occurred.

public Object
arg

An arbitrary argument of the event.

public static final int
BACK_SPACE

The BackSpace key.

public static final int
CAPS_LOCK

The Caps Lock key, a non-ASCII action key.

public int
clickCount

For MOUSE_DOWN events, this field indicates the number of consecutive clicks.

private boolean
consumed

This field controls whether or not the event is sent back down to the peer once the target has processed it - false means it's sent to the peer, true means it's not.

public static final int
CTRL_MASK

This flag indicates that the Control key was down when the event occurred.

private transient long
public static final int
DELETE

The Delete key.

public static final int
DOWN

The Down Arrow key, a non-ASCII action key.

public static final int
END

The End key, a non-ASCII action key.

public static final int
ENTER

The Enter key.

public static final int
ESCAPE

The Escape key.

public Event
evt

References Deprecated Event is deprecated or references (maybe indirectly) at least one deprecated element.
The next event.
public static final int
F1

The F1 function key, a non-ASCII action key.

public static final int
F10

The F10 function key, a non-ASCII action key.

public static final int
F11

The F11 function key, a non-ASCII action key.

public static final int
F12

The F12 function key, a non-ASCII action key.

public static final int
F2

The F2 function key, a non-ASCII action key.

public static final int
F3

The F3 function key, a non-ASCII action key.

public static final int
F4

The F4 function key, a non-ASCII action key.

public static final int
F5

The F5 function key, a non-ASCII action key.

public static final int
F6

The F6 function key, a non-ASCII action key.

public static final int
F7

The F7 function key, a non-ASCII action key.

public static final int
F8

The F8 function key, a non-ASCII action key.

public static final int
F9

The F9 function key, a non-ASCII action key.

public static final int
GOT_FOCUS

A component gained the focus.

public static final int
HOME

The Home key, a non-ASCII action key.

public int
id

Indicates which type of event the event is, and which other Event variables are relevant for the event.

public static final int
INSERT

The Insert key, a non-ASCII action key.

public int
key

The key code of the key that was pressed in a keyboard event.

public static final int
KEY_ACTION

The user has pressed a non-ASCII action key.

public static final int
KEY_ACTION_RELEASE

The user has released a non-ASCII action key.

private static final int
public static final int
KEY_PRESS

The user has pressed a normal key.

public static final int
KEY_RELEASE

The user has released a normal key.

public static final int
LEFT

The Left Arrow key, a non-ASCII action key.

public static final int
LIST_DESELECT

An item in a list has been deselected.

private static final int
public static final int
LIST_SELECT

An item in a list has been selected.

public static final int
LOAD_FILE

A file loading event.

public static final int
LOST_FOCUS

A component lost the focus.

public static final int
META_MASK

This flag indicates that the Meta key was down when the event occurred.

private static final int
public int
modifiers

The state of the modifier keys.

public static final int
MOUSE_DOWN

The user has pressed the mouse button.

public static final int
MOUSE_DRAG

The user has moved the mouse with a button pressed.

public static final int
MOUSE_ENTER

The mouse has entered a component.

private static final int
public static final int
MOUSE_EXIT

The mouse has exited a component.

public static final int
MOUSE_MOVE

The mouse has moved with no button pressed.

public static final int
MOUSE_UP

The user has released the mouse button.

public static final int
NUM_LOCK

The Num Lock key, a non-ASCII action key.

public static final int
PAUSE

The Pause key, a non-ASCII action key.

public static final int
PGDN

The Page Down key, a non-ASCII action key.

public static final int
PGUP

The Page Up key, a non-ASCII action key.

public static final int
RIGHT

The Right Arrow key, a non-ASCII action key.

public static final int
SAVE_FILE

A file saving event.

public static final int
SCROLL_ABSOLUTE

The user has moved the bubble (thumb) in a scroll bar, moving to an "absolute" position, rather than to an offset from the last position.

public static final int
SCROLL_BEGIN

The scroll begin event.

public static final int
SCROLL_END

The scroll end event.

private static final int
public static final int
SCROLL_LINE_DOWN

The user has activated the line down area of a scroll bar.

public static final int
SCROLL_LINE_UP

The user has activated the line up area of a scroll bar.

public static final int
SCROLL_LOCK

The Scroll Lock key, a non-ASCII action key.

public static final int
SCROLL_PAGE_DOWN

The user has activated the page down area of a scroll bar.

public static final int
SCROLL_PAGE_UP

The user has activated the page up area of a scroll bar.

private static final long
serialVersionUID

Use serialVersionUID from JDK 1.1 for interoperability.

public static final int
SHIFT_MASK

This flag indicates that the Shift key was down when the event occurred.

public static final int
TAB

The Tab key.

public Object
target

The target component.

public static final int
UP

The Up Arrow key, a non-ASCII action key.

public long
when

The time stamp.

public static final int
WINDOW_DEICONIFY

The user has asked the window manager to de-iconify the window.

public static final int
WINDOW_DESTROY

The user has asked the window manager to kill the window.

private static final int
public static final int
WINDOW_EXPOSE

The user has asked the window manager to expose the window.

public static final int
WINDOW_ICONIFY

The user has asked the window manager to iconify the window.

public static final int
WINDOW_MOVED

The user has asked the window manager to move the window.

public int
x

The x coordinate of the event.

public int
y

The y coordinate of the event.

Constructor Summary

AccessConstructor and Description
public
Event(Object
the target component.
target
,
long
the time stamp.
when
,
int
the event type.
id
,
int
the x coordinate.
x
,
int
the y coordinate.
y
,
int
the key pressed in a keyboard event.
key
,
int
the state of the modifier keys.
modifiers
,
Object
the specified argument.
arg
)

Creates an instance of Event with the specified target component, time stamp, event type, x and y coordinates, keyboard key, state of the modifier keys, and argument.

public
Event(Object
the target component.
target
,
long
the time stamp.
when
,
int
the event type.
id
,
int
the x coordinate.
x
,
int
the y coordinate.
y
,
int
the key pressed in a keyboard event.
key
,
int
the state of the modifier keys.
modifiers
)

Creates an instance of Event, with the specified target component, time stamp, event type, x and y coordinates, keyboard key, state of the modifier keys, and an argument set to null.

public
Event(Object
the target component.
target
,
int
the event type.
id
,
Object
the specified argument.
arg
)

Creates an instance of Event with the specified target component, event type, and argument.

Method Summary

Modifier and TypeMethod and Description
pack-priv void
consume()

Note

The Event class is obsolete and is available only for backwards compatibility.

public boolean

Returns:

true if the key is down; false otherwise.
controlDown
()

Checks if the Control key is down.

pack-priv char
pack-priv static int
private static native void
initIDs()

Initialize JNI field and method IDs for fields that may be accessed from C.

pack-priv boolean
isConsumed()

Note

The Event class is obsolete and is available only for backwards compatibility.

public boolean

Returns:

true if the key is down; false otherwise.
metaDown
()

Checks if the Meta key is down.

protected String

Returns:

the parameter string of this event
paramString
()

Returns a string representing the state of this Event.

public boolean

Returns:

true if the key is down; false otherwise.
shiftDown
()

Checks if the Shift key is down.

public String

Returns:

a string that represents the event and the values of its member fields.
toString
()

Overrides java.lang.Object.toString.

Returns a representation of this event's values as a string.

public void
translate(int
the distance to translate the x coordinate.
dx
,
int
the distance to translate the y coordinate.
dy
)

Translates this event so that its x and y coordinates are increased by dx and dy, respectively.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAllwaitwaitwait

Field Detail

ACTION_EVENTback to summary
public static final int ACTION_EVENT

This event indicates that the user wants some action to occur.

actionKeyCodesback to summary
private static final int[][] actionKeyCodes
ALT_MASKback to summary
public static final int ALT_MASK

This flag indicates that the Alt key was down when the event occurred. For mouse events, this flag indicates that the middle mouse button was pressed or released.

argback to summary
public Object arg

An arbitrary argument of the event. The value of this field depends on the type of event. arg has been replaced by event specific property.

Annotations
@SuppressWarnings:serial
BACK_SPACEback to summary
public static final int BACK_SPACE

The BackSpace key.

CAPS_LOCKback to summary
public static final int CAPS_LOCK

The Caps Lock key, a non-ASCII action key.

clickCountback to summary
public int clickCount

For MOUSE_DOWN events, this field indicates the number of consecutive clicks. For other events, its value is 0. This field has been replaced by MouseEvent.getClickCount().

See Also
java.awt.event.MouseEvent#getClickCount()
consumedback to summary
private boolean consumed

This field controls whether or not the event is sent back down to the peer once the target has processed it - false means it's sent to the peer, true means it's not.

See Also
isConsumed()
CTRL_MASKback to summary
public static final int CTRL_MASK

This flag indicates that the Control key was down when the event occurred.

databack to summary
private transient long data
DELETEback to summary
public static final int DELETE

The Delete key.

DOWNback to summary
public static final int DOWN

The Down Arrow key, a non-ASCII action key.

ENDback to summary
public static final int END

The End key, a non-ASCII action key.

ENTERback to summary
public static final int ENTER

The Enter key.

ESCAPEback to summary
public static final int ESCAPE

The Escape key.

evtback to summary
public Event evt

References Deprecated

Event is deprecated or references (maybe indirectly) at least one deprecated element.

See corresponding docs for further information.

The next event. This field is set when putting events into a linked list. This has been replaced by EventQueue.

See Also
java.awt.EventQueue
F1back to summary
public static final int F1

The F1 function key, a non-ASCII action key.

F10back to summary
public static final int F10

The F10 function key, a non-ASCII action key.

F11back to summary
public static final int F11

The F11 function key, a non-ASCII action key.

F12back to summary
public static final int F12

The F12 function key, a non-ASCII action key.

F2back to summary
public static final int F2

The F2 function key, a non-ASCII action key.

F3back to summary
public static final int F3

The F3 function key, a non-ASCII action key.

F4back to summary
public static final int F4

The F4 function key, a non-ASCII action key.

F5back to summary
public static final int F5

The F5 function key, a non-ASCII action key.

F6back to summary
public static final int F6

The F6 function key, a non-ASCII action key.

F7back to summary
public static final int F7

The F7 function key, a non-ASCII action key.

F8back to summary
public static final int F8

The F8 function key, a non-ASCII action key.

F9back to summary
public static final int F9

The F9 function key, a non-ASCII action key.

GOT_FOCUSback to summary
public static final int GOT_FOCUS

A component gained the focus.

HOMEback to summary
public static final int HOME

The Home key, a non-ASCII action key.

idback to summary
public int id

Indicates which type of event the event is, and which other Event variables are relevant for the event. This has been replaced by AWTEvent.getID()

See Also
java.awt.AWTEvent#getID()
INSERTback to summary
public static final int INSERT

The Insert key, a non-ASCII action key.

keyback to summary
public int key

The key code of the key that was pressed in a keyboard event. This has been replaced by KeyEvent.getKeyCode()

See Also
java.awt.event.KeyEvent#getKeyCode()
KEY_ACTIONback to summary
public static final int KEY_ACTION

The user has pressed a non-ASCII action key. The key field contains a value that indicates that the event occurred on one of the action keys, which comprise the 12 function keys, the arrow (cursor) keys, Page Up, Page Down, Home, End, Print Screen, Scroll Lock, Caps Lock, Num Lock, Pause, and Insert.

KEY_ACTION_RELEASEback to summary
public static final int KEY_ACTION_RELEASE

The user has released a non-ASCII action key. The key field contains a value that indicates that the event occurred on one of the action keys, which comprise the 12 function keys, the arrow (cursor) keys, Page Up, Page Down, Home, End, Print Screen, Scroll Lock, Caps Lock, Num Lock, Pause, and Insert.

KEY_EVENTback to summary
private static final int KEY_EVENT
KEY_PRESSback to summary
public static final int KEY_PRESS

The user has pressed a normal key.

KEY_RELEASEback to summary
public static final int KEY_RELEASE

The user has released a normal key.

LEFTback to summary
public static final int LEFT

The Left Arrow key, a non-ASCII action key.

LIST_DESELECTback to summary
public static final int LIST_DESELECT

An item in a list has been deselected.

LIST_EVENTback to summary
private static final int LIST_EVENT
LIST_SELECTback to summary
public static final int LIST_SELECT

An item in a list has been selected.

LOAD_FILEback to summary
public static final int LOAD_FILE

A file loading event.

LOST_FOCUSback to summary
public static final int LOST_FOCUS

A component lost the focus.

META_MASKback to summary
public static final int META_MASK

This flag indicates that the Meta key was down when the event occurred. For mouse events, this flag indicates that the right button was pressed or released.

MISC_EVENTback to summary
private static final int MISC_EVENT
modifiersback to summary
public int modifiers

The state of the modifier keys. This is replaced with InputEvent.getModifiers() In java 1.1 MouseEvent and KeyEvent are subclasses of InputEvent.

See Also
java.awt.event.InputEvent#getModifiers()
MOUSE_DOWNback to summary
public static final int MOUSE_DOWN

The user has pressed the mouse button. The ALT_MASK flag indicates that the middle button has been pressed. The META_MASK flag indicates that the right button has been pressed.

See Also
java.awt.Event#ALT_MASK, java.awt.Event#META_MASK
MOUSE_DRAGback to summary
public static final int MOUSE_DRAG

The user has moved the mouse with a button pressed. The ALT_MASK flag indicates that the middle button is being pressed. The META_MASK flag indicates that the right button is being pressed.

See Also
java.awt.Event#ALT_MASK, java.awt.Event#META_MASK
MOUSE_ENTERback to summary
public static final int MOUSE_ENTER

The mouse has entered a component.

MOUSE_EVENTback to summary
private static final int MOUSE_EVENT
MOUSE_EXITback to summary
public static final int MOUSE_EXIT

The mouse has exited a component.

MOUSE_MOVEback to summary
public static final int MOUSE_MOVE

The mouse has moved with no button pressed.

MOUSE_UPback to summary
public static final int MOUSE_UP

The user has released the mouse button. The ALT_MASK flag indicates that the middle button has been released. The META_MASK flag indicates that the right button has been released.

See Also
java.awt.Event#ALT_MASK, java.awt.Event#META_MASK
NUM_LOCKback to summary
public static final int NUM_LOCK

The Num Lock key, a non-ASCII action key.

PAUSEback to summary
public static final int PAUSE

The Pause key, a non-ASCII action key.

PGDNback to summary
public static final int PGDN

The Page Down key, a non-ASCII action key.

PGUPback to summary
public static final int PGUP

The Page Up key, a non-ASCII action key.

SAVE_FILEback to summary
public static final int SAVE_FILE

A file saving event.

SCROLL_ABSOLUTEback to summary
public static final int SCROLL_ABSOLUTE

The user has moved the bubble (thumb) in a scroll bar, moving to an "absolute" position, rather than to an offset from the last position.

SCROLL_BEGINback to summary
public static final int SCROLL_BEGIN

The scroll begin event.

SCROLL_ENDback to summary
public static final int SCROLL_END

The scroll end event.

SCROLL_EVENTback to summary
private static final int SCROLL_EVENT
SCROLL_LINE_DOWNback to summary
public static final int SCROLL_LINE_DOWN

The user has activated the line down area of a scroll bar.

SCROLL_LINE_UPback to summary
public static final int SCROLL_LINE_UP

The user has activated the line up area of a scroll bar.

SCROLL_LOCKback to summary
public static final int SCROLL_LOCK

The Scroll Lock key, a non-ASCII action key.

SCROLL_PAGE_DOWNback to summary
public static final int SCROLL_PAGE_DOWN

The user has activated the page down area of a scroll bar.

SCROLL_PAGE_UPback to summary
public static final int SCROLL_PAGE_UP

The user has activated the page up area of a scroll bar.

serialVersionUIDback to summary
private static final long serialVersionUID

Use serialVersionUID from JDK 1.1 for interoperability.

Annotations
@Serial
SHIFT_MASKback to summary
public static final int SHIFT_MASK

This flag indicates that the Shift key was down when the event occurred.

TABback to summary
public static final int TAB

The Tab key.

targetback to summary
public Object target

The target component. This indicates the component over which the event occurred or with which the event is associated. This object has been replaced by AWTEvent.getSource()

Annotations
@SuppressWarnings:serial
See Also
java.awt.AWTEvent#getSource()
UPback to summary
public static final int UP

The Up Arrow key, a non-ASCII action key.

whenback to summary
public long when

The time stamp. Replaced by InputEvent.getWhen().

See Also
java.awt.event.InputEvent#getWhen()
WINDOW_DEICONIFYback to summary
public static final int WINDOW_DEICONIFY

The user has asked the window manager to de-iconify the window.

WINDOW_DESTROYback to summary
public static final int WINDOW_DESTROY

The user has asked the window manager to kill the window.

WINDOW_EVENTback to summary
private static final int WINDOW_EVENT
WINDOW_EXPOSEback to summary
public static final int WINDOW_EXPOSE

The user has asked the window manager to expose the window.

WINDOW_ICONIFYback to summary
public static final int WINDOW_ICONIFY

The user has asked the window manager to iconify the window.

WINDOW_MOVEDback to summary
public static final int WINDOW_MOVED

The user has asked the window manager to move the window.

xback to summary
public int x

The x coordinate of the event. Replaced by MouseEvent.getX()

See Also
java.awt.event.MouseEvent#getX()
yback to summary
public int y

The y coordinate of the event. Replaced by MouseEvent.getY()

See Also
java.awt.event.MouseEvent#getY()

Constructor Detail

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

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Creates an instance of Event with the specified target component, time stamp, event type, x and y coordinates, keyboard key, state of the modifier keys, and argument.

Parameters
target:Object

the target component.

when:long

the time stamp.

id:int

the event type.

x:int

the x coordinate.

y:int

the y coordinate.

key:int

the key pressed in a keyboard event.

modifiers:int

the state of the modifier keys.

arg:Object

the specified argument.

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

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Creates an instance of Event, with the specified target component, time stamp, event type, x and y coordinates, keyboard key, state of the modifier keys, and an argument set to null.

Parameters
target:Object

the target component.

when:long

the time stamp.

id:int

the event type.

x:int

the x coordinate.

y:int

the y coordinate.

key:int

the key pressed in a keyboard event.

modifiers:int

the state of the modifier keys.

Eventback to summary
public Event(Object target, int id, Object arg)

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Creates an instance of Event with the specified target component, event type, and argument.

Parameters
target:Object

the target component.

id:int

the event type.

arg:Object

the specified argument.

Method Detail

consumeback to summary
pack-priv void consume()

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

controlDownback to summary
public boolean controlDown()

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Checks if the Control key is down.

Returns:boolean

true if the key is down; false otherwise.

See Also
java.awt.Event#modifiers, java.awt.Event#shiftDown, java.awt.Event#metaDown
getKeyEventCharback to summary
pack-priv char getKeyEventChar()
getOldEventKeyback to summary
pack-priv static int getOldEventKey(KeyEvent e)
initIDsback to summary
private static native void initIDs()

Initialize JNI field and method IDs for fields that may be accessed from C.

isConsumedback to summary
pack-priv boolean isConsumed()

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

metaDownback to summary
public boolean metaDown()

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Checks if the Meta key is down.

Returns:boolean

true if the key is down; false otherwise.

See Also
java.awt.Event#modifiers, java.awt.Event#shiftDown, java.awt.Event#controlDown
paramStringback to summary
protected String paramString()

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Returns a string representing the state of this Event. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.

Returns:String

the parameter string of this event

shiftDownback to summary
public boolean shiftDown()

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Checks if the Shift key is down.

Returns:boolean

true if the key is down; false otherwise.

See Also
java.awt.Event#modifiers, java.awt.Event#controlDown, java.awt.Event#metaDown
toStringback to summary
public String toString()

Overrides java.lang.Object.toString.

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Returns a representation of this event's values as a string.

Returns:String

a string that represents the event and the values of its member fields.

Since
1.1
See Also
java.awt.Event#paramString
translateback to summary
public void translate(int dx, int dy)

Note

The Event class is obsolete and is available only for backwards compatibility. It has been replaced by the AWTEvent class and its subclasses.

Translates this event so that its x and y coordinates are increased by dx and dy, respectively.

This method translates an event relative to the given component. This involves, at a minimum, translating the coordinates into the local coordinate system of the given component. It may also involve translating a region in the case of an expose event.

Parameters
dx:int

the distance to translate the x coordinate.

dy:int

the distance to translate the y coordinate.