com.sun.java.accessibility.util

Class EventQueueMonitor

java.lang.Object

com.sun.java.accessibility.util.EventQueueMonitor

All Implemented Interfaces:

AWTEventListener, EventListener

@Exported
public class EventQueueMonitor
extends Object
implements AWTEventListener

The EventQueueMonitor class provides key core functionality for Assistive Technologies (and other system-level technologies that need some of the same things that Assistive Technology needs).

See Also:

AWTEventMonitor, SwingEventMonitor

Constructor Summary

Constructors

Constructor and Description
EventQueueMonitor() Create a new EventQueueMonitor instance.

Method Summary

Modifier and Type	Method and Description
static void	addGUIInitializedListener(GUIInitializedListener l) Adds the specified listener to be notified when the GUI subsystem is initialized.
static void	addTopLevelWindowListener(TopLevelWindowListener l) Adds the specified listener to be notified when a top level window is created or destroyed.
void	eventDispatched(AWTEvent theEvent) Handle events as a result of registering a listener on the EventQueue in maybeInitialize().
static Accessible	getAccessibleAt(Point p) Obtain the Accessible object at the given point on the Screen.
static Point	getCurrentMousePosition() Return the last recorded position of the mouse in screen coordinates.
static Window[]	getTopLevelWindows() Return the list of top level Windows in use in the Java Virtual Machine.
static Window	getTopLevelWindowWithFocus() Return the top level Window that currently has keyboard focus.
static boolean	isGUIInitialized() Says whether the GUI subsystem has been initialized or not.
static void	maybeInitialize() Tell the EventQueueMonitor to start listening for events.
static void	removeGUIInitializedListener(GUIInitializedListener l) Removes the specified listener to be notified when the GUI subsystem is initialized.
static void	removeTopLevelWindowListener(TopLevelWindowListener l) Removes the specified listener to be notified when a top level window is created or destroyed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EventQueueMonitor

public EventQueueMonitor()

Create a new EventQueueMonitor instance. Normally, this will be called only by the AWT Toolkit during initialization time. Assistive technologies should not create instances of EventQueueMonitor by themselves. Instead, they should either refer to it directly via the static methods in this class, e.g., getCurrentMousePosition() or obtain the instance by asking the Toolkit, e.g., Toolkit.getSystemEventQueue().

Method Detail

maybeInitialize

public static void maybeInitialize()

Tell the EventQueueMonitor to start listening for events.

eventDispatched

public void eventDispatched(AWTEvent theEvent)

Handle events as a result of registering a listener on the EventQueue in maybeInitialize().

Specified by:

eventDispatched in interface AWTEventListener

getAccessibleAt

public static Accessible getAccessibleAt(Point p)

Obtain the Accessible object at the given point on the Screen. The return value may be null if an Accessible object cannot be found at the particular point.

Parameters:

p - the point to be accessed

Returns:

the Accessible at the specified point

isGUIInitialized

public static boolean isGUIInitialized()

Says whether the GUI subsystem has been initialized or not. If this returns true, the assistive technology can freely create GUI component instances. If the return value is false, the assistive technology should register a GUIInitializedListener and wait to create GUI component instances until the listener is called.

Returns:

true if the GUI subsystem has been initialized

See Also:

addGUIInitializedListener(com.sun.java.accessibility.util.GUIInitializedListener)

addGUIInitializedListener

public static void addGUIInitializedListener(GUIInitializedListener l)

Adds the specified listener to be notified when the GUI subsystem is initialized. Assistive technologies should get the results of isGUIInitialized() before calling this method.

Parameters:

l - the listener to add

See Also:

isGUIInitialized(), removeTopLevelWindowListener(com.sun.java.accessibility.util.TopLevelWindowListener)

removeGUIInitializedListener

public static void removeGUIInitializedListener(GUIInitializedListener l)

Removes the specified listener to be notified when the GUI subsystem is initialized.

Parameters:

l - the listener to remove

See Also:

addGUIInitializedListener(com.sun.java.accessibility.util.GUIInitializedListener)

addTopLevelWindowListener

public static void addTopLevelWindowListener(TopLevelWindowListener l)

Adds the specified listener to be notified when a top level window is created or destroyed.

Parameters:

l - the listener to add

See Also:

removeTopLevelWindowListener(com.sun.java.accessibility.util.TopLevelWindowListener)

removeTopLevelWindowListener

public static void removeTopLevelWindowListener(TopLevelWindowListener l)

Removes the specified listener to be notified when a top level window is created or destroyed.

Parameters:

l - the listener to remove

See Also:

addTopLevelWindowListener(com.sun.java.accessibility.util.TopLevelWindowListener)

getCurrentMousePosition

public static Point getCurrentMousePosition()

Return the last recorded position of the mouse in screen coordinates.

Returns:

the last recorded position of the mouse in screen coordinates

getTopLevelWindows

public static Window[] getTopLevelWindows()

Return the list of top level Windows in use in the Java Virtual Machine.

Returns:

an array of top level Windows in use in the Java Virtual Machine

getTopLevelWindowWithFocus

public static Window getTopLevelWindowWithFocus()

Return the top level Window that currently has keyboard focus.

Returns:

the top level Window that currently has keyboard focus