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.


Variable Index

 o ACTION
The ACTION event is sent whenever an action button is activated.
 o COLORMODEL_CHANGE_FLAG
Indicates that the pixel definition of the root window has changed.
 o 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.
 o NONE
Neither press nor release.
 o PRESSED
An actuator was pressed.
 o RELEASED
An actuator was released.
 o SIZE_CHANGE_FLAG
Indicates that the size of the root window area has changed.
 o TYPED
The TYPED event is used to deliver translated characters into the system.

Method Index

 o graphicsChange(long, Region, int)
Called when a change occurred in the graphics system, e.g.
 o 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.
 o pointerEventOccurred(long, int, int, int, int)
Called when an event on a pointing object (e.g.

Variables

 o 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.

 o 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_)

 o 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_)

 o 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.

 o 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.

 o 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.

 o 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.

 o 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.

Methods

 o 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
 o 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
 o 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