Class EventQueueMonitor
- java.lang.Object
-
- com.sun.java.accessibility.util.EventQueueMonitor
- All Implemented Interfaces:
-
AWTEventListener
,EventListener
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
Constructors
Constructor | Description |
---|---|
EventQueueMonitor() | Create a new |
Methods
Modifier and Type | Method | 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 |
static Accessible | getAccessibleAt(Point p) | Obtain the |
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 |
static boolean | isGUIInitialized() | Says whether the GUI subsystem has been initialized or not. |
static void | maybeInitialize() | Tell the |
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 declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Constructors
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()
.
Methods
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 interfaceAWTEventListener
- Parameters:
-
theEvent
- the event to be processed
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
Window
s 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
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/jdk.accessibility/com/sun/java/accessibility/util/EventQueueMonitor.html