OpenJDK 27 · com.sun.java.accessibility.util.EventQueueMonitor

Modifier and Type	Field and Description
private static ComponentEvtDispatchThread	cedt Class that tells us what the component event dispatch thread is.
pack-priv static EventQueueMonitorItem	componentEventQueue Queue that holds events for later processing.
pack-priv static Object	componentEventQueueLock Handle the synchronization between the thing that populates the component event dispatch thread (`queueComponentEvent`) and the thing that processes the events (`ComponentEvtDispatchThread`).
pack-priv static Component	currentMouseComponent
pack-priv static Point	currentMousePosition
pack-priv static boolean	guiInitialized Class variable stating whether the GUI subsystem has been initialized or not.
pack-priv static GUIInitializedListener	guiInitializedListener
pack-priv static MouseMotionListener	mouseMotionListener
pack-priv static TopLevelWindowListener	topLevelWindowListener
pack-priv static Vector<Container>	topLevelWindows
pack-priv static Window	topLevelWindowWithFocus

Access	Constructor and Description
public	EventQueueMonitor() Create a new `EventQueueMonitor` instance.

Method Summary

Modifier and Type	Method and Description
public static void	addGUIInitializedListener(GUIInitializedListener the listener to add l) Adds the specified listener to be notified when the GUI subsystem is initialized.
pack-priv static void	addTopLevelWindow(Component the Container c) Add a Container to the list of top-level containers in the cache.
public static void	addTopLevelWindowListener(TopLevelWindowListener the listener to add l) Adds the specified listener to be notified when a top level window is created or destroyed.
public void	eventDispatched(AWTEvent theEvent) Implements java.awt.event.AWTEventListener.eventDispatched. Handle events as a result of registering a listener on the `EventQueue` in `maybeInitialize`.
public static Accessible	Returns: the `Accessible` at the specified point getAccessibleAt(Point the point to be accessed p) Obtain the `Accessible` object at the given point on the Screen.
pack-priv static synchronized Component	Returns: the Component at the given Point on the screen in the given Container -- can be null if no Component is at that Point getComponentAt(Container the Container to search c, Point the Point in screen coordinates p) Return the Component at the given Point on the screen in the given Container.
public static Point	Returns: the last recorded position of the mouse in screen coordinates getCurrentMousePosition() Return the last recorded position of the mouse in screen coordinates.
pack-priv static synchronized Component	getShowingComponentAt(Container c, int x, int y) Internal test
public static Window[]	Returns: an array of top level `Window`s in use in the Java Virtual Machine getTopLevelWindows() Return the list of top level Windows in use in the Java Virtual Machine.
public static Window	Returns: the top level `Window` that currently has keyboard focus getTopLevelWindowWithFocus() Return the top level `Window` that currently has keyboard focus.
public static boolean	Returns: true if the GUI subsystem has been initialized isGUIInitialized() Says whether the GUI subsystem has been initialized or not.
public static void	maybeInitialize() Tell the `EventQueueMonitor` to start listening for events.
pack-priv static void	maybeNotifyAssistiveTechnologies() Assisitive technologies that have registered a `GUIInitializedListener` will be notified.
pack-priv static void	processEvent(AWTEvent the AWTEvent theEvent) Process the event.
pack-priv static void	queueComponentEvent(ComponentEvent a `ComponentEvent` e) Queue up a `ComponentEvent` for later processing by the `ComponentEvtDispatch` thread.
public static void	removeGUIInitializedListener(GUIInitializedListener the listener to remove l) Removes the specified listener to be notified when the GUI subsystem is initialized.
pack-priv static void	removeTopLevelWindow(Window w) Removes a container from the list of top level containers in the cache.
public static void	removeTopLevelWindowListener(TopLevelWindowListener the listener to remove l) Removes the specified listener to be notified when a top level window is created or destroyed.
pack-priv static void	updateCurrentMousePosition(MouseEvent the MouseEvent that holds the new mouse position. mouseEvent) Update current mouse position.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

cedt	back to summary
private static ComponentEvtDispatchThread cedt Class that tells us what the component event dispatch thread is.

componentEventQueue	back to summary
pack-priv static EventQueueMonitorItem componentEventQueue Queue that holds events for later processing.

componentEventQueueLock	back to summary
pack-priv static Object componentEventQueueLock Handle the synchronization between the thing that populates the component event dispatch thread (`queueComponentEvent`) and the thing that processes the events (`ComponentEvtDispatchThread`).

currentMouseComponent	back to summary
pack-priv static Component currentMouseComponent

currentMousePosition	back to summary
pack-priv static Point currentMousePosition

guiInitialized back to summary

guiInitialized	back to summary
pack-priv static boolean guiInitialized Class variable stating whether the GUI subsystem has been initialized or not. See Also `isGUIInitialized`

pack-priv static boolean guiInitialized

Class variable stating whether the GUI subsystem has been initialized or not.

See Also: isGUIInitialized

guiInitializedListener	back to summary
pack-priv static GUIInitializedListener guiInitializedListener

mouseMotionListener	back to summary
pack-priv static MouseMotionListener mouseMotionListener

topLevelWindowListener	back to summary
pack-priv static TopLevelWindowListener topLevelWindowListener

topLevelWindows	back to summary
pack-priv static Vector<Container> topLevelWindows

topLevelWindowWithFocus	back to summary
pack-priv static Window topLevelWindowWithFocus

Constructor Detail

EventQueueMonitor back to summary

EventQueueMonitor	back to summary
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., `java.awt.Toolkit#getSystemEventQueue`.

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., java.awt.Toolkit#getSystemEventQueue.

Method Detail

addGUIInitializedListener back to summary

addGUIInitializedListener	back to summary
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:GUIInitializedListener the listener to add See Also `isGUIInitialized`, `removeTopLevelWindowListener`

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:GUIInitializedListener: the listener to add

addTopLevelWindow	back to summary
pack-priv static void addTopLevelWindow(Component c) Add a Container to the list of top-level containers in the cache. This follows the object's hierarchy up the tree until it finds the top most parent. If the parent is not already in the list of Containers, it adds it to the list. Parameters c:Component the Container

addTopLevelWindow

back to summary

pack-priv static void addTopLevelWindow(Component c)

Add a Container to the list of top-level containers in the cache. This follows the object's hierarchy up the tree until it finds the top most parent. If the parent is not already in the list of Containers, it adds it to the list.

Parameters

c:Component: the Container

addTopLevelWindowListener back to summary

addTopLevelWindowListener	back to summary
public static void addTopLevelWindowListener(TopLevelWindowListener l) Adds the specified listener to be notified when a top level window is created or destroyed. Parameters l:TopLevelWindowListener the listener to add See Also `removeTopLevelWindowListener`

public static void addTopLevelWindowListener(TopLevelWindowListener l)

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

Parameters

l:TopLevelWindowListener: the listener to add

See Also

removeTopLevelWindowListener

eventDispatched back to summary

eventDispatched	back to summary
public void eventDispatched(AWTEvent theEvent) Implements java.awt.event.AWTEventListener.eventDispatched. Handle events as a result of registering a listener on the `EventQueue` in `maybeInitialize`.

public void eventDispatched(AWTEvent theEvent)

Implements java.awt.event.AWTEventListener.eventDispatched.

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

getAccessibleAt back to summary

getAccessibleAt	back to summary
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:Point the point to be accessed Returns:Accessible the `Accessible` at the specified point

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:Point: the point to be accessed

Returns:Accessible

the Accessible at the specified point

getComponentAt	back to summary
pack-priv static synchronized Component getComponentAt(Container c, Point p) Return the Component at the given Point on the screen in the given Container. Parameters c:Container the Container to search p:Point the Point in screen coordinates Returns:Component the Component at the given Point on the screen in the given Container -- can be null if no Component is at that Point

getComponentAt

back to summary

pack-priv static synchronized Component getComponentAt(Container c, Point p)

Return the Component at the given Point on the screen in the given Container.

Parameters

c:Container: the Container to search
p:Point: the Point in screen coordinates

Returns:Component

the Component at the given Point on the screen in the given Container -- can be null if no Component is at that Point

getCurrentMousePosition	back to summary
public static Point getCurrentMousePosition() Return the last recorded position of the mouse in screen coordinates. Returns:Point the last recorded position of the mouse in screen coordinates

getCurrentMousePosition

back to summary

public static Point getCurrentMousePosition()

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

Returns:Point: the last recorded position of the mouse in screen coordinates

getShowingComponentAt	back to summary
pack-priv static synchronized Component getShowingComponentAt(Container c, int x, int y) Internal test

getTopLevelWindows back to summary

getTopLevelWindows	back to summary
public static Window[] getTopLevelWindows() Return the list of top level Windows in use in the Java Virtual Machine. Returns:Window[] an array of top level `Window`s in use in the Java Virtual Machine

public static Window[] getTopLevelWindows()

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

Returns:Window[]: an array of top level Windows in use in the Java Virtual Machine

getTopLevelWindowWithFocus back to summary

getTopLevelWindowWithFocus	back to summary
public static Window getTopLevelWindowWithFocus() Return the top level `Window` that currently has keyboard focus. Returns:Window the top level `Window` that currently has keyboard focus

public static Window getTopLevelWindowWithFocus()

Return the top level Window that currently has keyboard focus.

Returns:Window: the top level Window that currently has keyboard focus

isGUIInitialized back to summary

isGUIInitialized	back to summary
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:boolean true if the GUI subsystem has been initialized See Also `addGUIInitializedListener`

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:boolean: true if the GUI subsystem has been initialized
See Also: addGUIInitializedListener

maybeInitialize	back to summary
public static void maybeInitialize() Tell the `EventQueueMonitor` to start listening for events.

maybeNotifyAssistiveTechnologies back to summary

maybeNotifyAssistiveTechnologies	back to summary
pack-priv static void maybeNotifyAssistiveTechnologies() Assisitive technologies that have registered a `GUIInitializedListener` will be notified. See Also `addGUIInitializedListener`

pack-priv static void maybeNotifyAssistiveTechnologies()

Assisitive technologies that have registered a GUIInitializedListener will be notified.

See Also: addGUIInitializedListener

processEvent	back to summary
pack-priv static void processEvent(AWTEvent theEvent) Process the event. This maintains the event cache in addition to calling all the registered listeners. Note The events that come through here are from peered Components. Parameters theEvent:AWTEvent the AWTEvent

processEvent

back to summary

pack-priv static void processEvent(AWTEvent theEvent)

Process the event. This maintains the event cache in addition to calling all the registered listeners.

Note

The events that come through here are from peered Components.

Parameters

theEvent:AWTEvent: the AWTEvent

queueComponentEvent back to summary

queueComponentEvent	back to summary
pack-priv static void queueComponentEvent(ComponentEvent e) Queue up a `ComponentEvent` for later processing by the `ComponentEvtDispatch` thread. Parameters e:ComponentEvent a `ComponentEvent`

pack-priv static void queueComponentEvent(ComponentEvent e)

Queue up a ComponentEvent for later processing by the ComponentEvtDispatch thread.

Parameters

e:ComponentEvent: a ComponentEvent

removeGUIInitializedListener back to summary

removeGUIInitializedListener	back to summary
public static void removeGUIInitializedListener(GUIInitializedListener l) Removes the specified listener to be notified when the GUI subsystem is initialized. Parameters l:GUIInitializedListener the listener to remove See Also `addGUIInitializedListener`

public static void removeGUIInitializedListener(GUIInitializedListener l)

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

Parameters

l:GUIInitializedListener: the listener to remove

See Also

addGUIInitializedListener

removeTopLevelWindow	back to summary
pack-priv static void removeTopLevelWindow(Window w) Removes a container from the list of top level containers in the cache.

removeTopLevelWindowListener back to summary

removeTopLevelWindowListener	back to summary
public static void removeTopLevelWindowListener(TopLevelWindowListener l) Removes the specified listener to be notified when a top level window is created or destroyed. Parameters l:TopLevelWindowListener the listener to remove See Also `addTopLevelWindowListener`

public static void removeTopLevelWindowListener(TopLevelWindowListener l)

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

Parameters

l:TopLevelWindowListener: the listener to remove

See Also

addTopLevelWindowListener

updateCurrentMousePosition	back to summary
pack-priv static void updateCurrentMousePosition(MouseEvent mouseEvent) Update current mouse position. Parameters mouseEvent:MouseEvent the MouseEvent that holds the new mouse position.

updateCurrentMousePosition

back to summary

pack-priv static void updateCurrentMousePosition(MouseEvent mouseEvent)

Update current mouse position.

Parameters

mouseEvent:MouseEvent: the MouseEvent that holds the new mouse position.

public Class EventQueueMonitor

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail