All Packages Class Hierarchy This Package Previous Next Index
Interface sun.porting.windowsystem.EventHandler
- public interface EventHandler
The EventHandler
interface is presented to the underlying
operating system (by registering with the underlying GraphicsSystem
)
in order to allow events to flow into the system.
-
ACTION
- The
ACTION
event is sent whenever an action button
is activated.
-
COLORMODEL_CHANGE_FLAG
- Indicates that the pixel definition of the root window has changed.
-
GRAPHICS_INVALID_FLAG
- Indicates that some change or another happened at the graphics layer
which has made the current state of the
This is a bit that can be logically OR-ed with the other flags.
-
NONE
- Neither press nor release.
-
PRESSED
- An actuator was pressed.
-
RELEASED
- An actuator was released.
-
SIZE_CHANGE_FLAG
- Indicates that the size of the root window area has changed.
-
TYPED
- The
TYPED
event is used to deliver translated characters
into the system.
-
graphicsChange(long, Region, int)
- Called when a change occurred in the graphics system, e.g.
-
keyboardEventOccurred(long, int, int, char)
- Called when an event on a key object (typewriter-style keyboard key,
button on a remote control, etc) has occurred.
-
pointerEventOccurred(long, int, int, int, int)
- Called when an event on a pointing object (e.g.
NONE
public static final int NONE
- Neither press nor release. This is used for events that have no "click"
associated with them, e.g. a mouse move or drag.
PRESSED
public static final int PRESSED
- An actuator was pressed. This could be a mouse button, or a key on a
keyboard, keypad, remote control, etc. which signifies an event that can
be represented by a virtual key code (i.e. a constant in
java.awt.event.KeyEvent
whose name begins with VK_
)
RELEASED
public static final int RELEASED
- An actuator was released. This could be a mouse button, or a key on a
keyboard, keypad, remote control, etc. which signifies an event that can
be represented by a virtual key code (i.e. a constant in
java.awt.event.KeyEvent
whose name begins with VK_
)
ACTION
public static final int ACTION
- The
ACTION
event is sent whenever an action button
is activated. This event is used for special keys
(e.g. a "GO" key on a keypad) which cannot be represented by a virtual
key code and are supposed to be handled or translated by the toolkit.
TYPED
public static final int TYPED
- The
TYPED
event is used to deliver translated characters
into the system. If translation from virtual keys to Unicode character codes
is done at a low level, this event type is used to deliver them; if the
translation must performed at a higher level (e.g. in the toolkit) then these
events will never be seen.
GRAPHICS_INVALID_FLAG
public static final int GRAPHICS_INVALID_FLAG
- Indicates that some change or another happened at the graphics layer
which has made the current state of the
This is a bit that can be logically OR-ed with the other flags.
COLORMODEL_CHANGE_FLAG
public static final int COLORMODEL_CHANGE_FLAG
- Indicates that the pixel definition of the root window has changed.
This is a bit that can be logically OR-ed with the other flags.
SIZE_CHANGE_FLAG
public static final int SIZE_CHANGE_FLAG
- Indicates that the size of the root window area has changed.
This is a bit that can be logically OR-ed with the other flags.
pointerEventOccurred
public abstract void pointerEventOccurred(long when,
int x,
int y,
int ID,
int number)
- Called when an event on a pointing object (e.g. a mouse, track ball,
joystick etc.) has occurred.
- Parameters:
- when - Time at which the event occurred, in milliseconds since
1/1/70 UTC.
- x - Current position of pointer - x coordinate
- y - Current position of pointer - y coordinate
- ID - Type identifier indicating the kind of event
- number - Used to distinguish among several buttons (etc) that
could have been pressed or released.
- See Also:
- currentTimeMillis
keyboardEventOccurred
public abstract void keyboardEventOccurred(long when,
int ID,
int keycode,
char keychar)
- Called when an event on a key object (typewriter-style keyboard key,
button on a remote control, etc) has occurred.
- Parameters:
- when - Time at which the event occurred, in milliseconds since
1/1/70 UTC.
- ID - Type identifier indicating the kind of event
- keycode - A code identifying which key was pressed.
- keychar - Unicode character -- for TYPED events only. (Events
with the TYPED id will only occur if the system is doing key-to-char
translation at a low level.)
- See Also:
- KeyEvent, currentTimeMillis
graphicsChange
public abstract void graphicsChange(long when,
Region r,
int flags)
- Called when a change occurred in the graphics system, e.g. the
depth or size of the screen was changed.
GRAPHICS_INVALID_FLAG
forces the window system to repaint all of its windows; it may
be sent all by itself if the system is an emulator and needs a
refresh. The Region
structure, if supplied, is used to clip the
repaint. GRAPHICS_INVALID_FLAG
should always be sent if the
event is a change in color model. But it is permissible *not*
to repaint on a size change in some circumstances (most likely
in an emulator). Other actions are to be taken as appropriate
(e.g. resetting the window system's idea of the root window
clip area.)
All Packages Class Hierarchy This Package Previous Next Index