- java.lang.Object
-
- com.sun.java.accessibility.util.EventQueueMonitor
-
- All Implemented Interfaces:
AWTEventListener,EventListener
public class EventQueueMonitor extends Object implements AWTEventListener
TheEventQueueMonitorclass 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 Description EventQueueMonitor()Create a newEventQueueMonitorinstance.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static voidaddGUIInitializedListener(GUIInitializedListener l)Adds the specified listener to be notified when the GUI subsystem is initialized.static voidaddTopLevelWindowListener(TopLevelWindowListener l)Adds the specified listener to be notified when a top level window is created or destroyed.voideventDispatched(AWTEvent theEvent)Handle events as a result of registering a listener on theEventQueueinmaybeInitialize().static AccessiblegetAccessibleAt(Point p)Obtain theAccessibleobject at the given point on the Screen.static PointgetCurrentMousePosition()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 WindowgetTopLevelWindowWithFocus()Return the top levelWindowthat currently has keyboard focus.static booleanisGUIInitialized()Says whether the GUI subsystem has been initialized or not.static voidmaybeInitialize()Tell theEventQueueMonitorto start listening for events.static voidremoveGUIInitializedListener(GUIInitializedListener l)Removes the specified listener to be notified when the GUI subsystem is initialized.static voidremoveTopLevelWindowListener(TopLevelWindowListener l)Removes the specified listener to be notified when a top level window is created or destroyed.
-
-
-
Constructor Detail
-
EventQueueMonitor
public EventQueueMonitor()
Create a newEventQueueMonitorinstance. 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 theEventQueueMonitorto start listening for events.
-
eventDispatched
public void eventDispatched(AWTEvent theEvent)
Handle events as a result of registering a listener on theEventQueueinmaybeInitialize().- Specified by:
eventDispatchedin interfaceAWTEventListener- Parameters:
theEvent- the event to be processed
-
getAccessibleAt
public static Accessible getAccessibleAt(Point p)
Obtain theAccessibleobject at the given point on the Screen. The return value may be null if anAccessibleobject cannot be found at the particular point.- Parameters:
p- the point to be accessed- Returns:
- the
Accessibleat 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 aGUIInitializedListenerand 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 ofisGUIInitialized()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 levelWindowthat currently has keyboard focus.- Returns:
- the top level
Windowthat currently has keyboard focus
-
-