You use the jaccessinspector
accessibility evaluation tool for the Java Accessibility Utilities API to examine accessible information about the objects in the Java Virtual Machine.
Description
jaccessinspector
tool lets you select different methods for examining the object accessibility information::
When events occur such as a change of focus, mouse movement, property change, menu selection, and the display of a popup menu
When you press the F1 key when the mouse is over an object, or F2 when the mouse is over a window
jaccessinspector
tool displays the results of calling Java Accessibility API methods on that object.Running the jaccessinspector Tool
To use the jaccessinspector
tool, launch the jaccessinspector
Windows application after launching a Java application. For example, to launch jaccessinspector
, run one of the following Windows applications:
Note:
The no-suffix version is installed with 64 bit Java.
JAVA_HOME
is an environment variable and it should be set to the path of the JDK or JRE, for example, c:\Program Files\Java\jdk-9
.
64-bit Windows:
%JAVA_HOME%\bin\jaccessinspector.exe:
Inspects a Java application as if jaccessinspector
were a 64-bit assistive technology application
%JAVA_HOME%\bin\jaccessinspector-32.exe:
Inspects a Java application as if jaccessinspector
were a 32-bit assistive technology application
You now have two windows open: The Java application window and the jaccessinspector
window. The jaccessinspector
window contains five menus:
The items in UpdateSettings, JavaEvents, and AccessibilityEvents menus let you query Java applications in a variety of ways.
File Menu
This section describes the File menu items.
UpdateSettings Menu
This section describes the UpdateSettings menu items.
Determines the x- and y-coordinates of the mouse (assuming the jaccessinspector tool window is topmost) when the mouse has stopped moving, and then queries the Java application for the accessible object underneath the mouse, dumping the output into the jaccessinspector
window.
Determines the x- and y-coordinates of the mouse (assuming the jaccessinspector tool window is topmost), and then queries the Java application for the accessible object of the HWND underneath the mouse, dumping the output into the jaccessinspector
window.
Determines the x- and y-coordinates of the mouse (assuming the jaccessinspector tool window is topmost), and then queries the Java application for the accessible object underneath the cursor, dumping the output into the jaccessinspector
window.
JavaEvents Menu
This section describes the JavaEvents menu items.
Registers with the Java application all Java Mouse Entered events, and upon receiving one, queries the object that was entered by the cursor and dumps the output into the jaccessinspector
window.
Note:
If the mouse is moved quickly, then there may be some delay before the displayed information is updated.Registers with the Java application all Java Focus Gained events, and upon receiving an event, queries the object that received the focus and dumps the output into the jaccessinspector
window.
Register with the Java application all Java Caret Update events, and upon receiving an event, queries the object in which the caret was updated, and dumps the output into the jaccessinspector
window.
Note:
Because objects that contain carets are almost by definition objects that are rich text objects, this won't seem as responsive as the other event tracking options. In real use, one would make fewer accessibility calls in Caret Update situations (for example, just get the new letter, word, sentence at the caret location), which would be significantly faster.Registers with the Java application all Menu events, and upon receiving an event, queries the object in which the caret was updated, and dumps the output into the jaccessinspector
window.
Registers with the Java application all Popup Menu events, and upon receiving an event, queries the object in which the caret was updated, and dumps the output into the jaccessinspector
window.
Registers with the Java application to receive a Property Changed event when a Java application terminates.
AccessibilityEvents Menu
This section describes the AccessibilityEvents menu items.
Note:
The items listed in the AccessibilityEvents menu are the most important for testing applications, especially for assistive technology applications.Registers with the Java application all Java Property Changed events specifically on accessible objects in which the Name property has changed, and upon receiving an event, dumps the output into the scrolling window, along with information about the property that changed.
Register with the Java application for all Java Property Changed events specifically on accessible objects in which the Description property has changed, and upon receiving an event, dumps the output into the jaccessinspector
window, along with information about the property that changed.
Register with the Java application all Java Property Changed events specifically on accessible objects in which the State property has changed, and upon receiving an event, dumps the output into the jaccessinspector
window, along with information about the property that changed.
Register with the Java application all Java Property Changed events specifically on accessible objects in which the Value property has changed, and upon receiving an event, dumps the output into the scrolling window, along with information about the property that changed.
Register with the Java application all Java Property Changed events specifically on accessible objects in which the Selection property has changed, and upon receiving an event, dumps the output into the jaccessinspector
window, along with information about the property that changed.
Register with the Java application all Java Property Changed events specifically on accessible objects in which the Text property has changed, and upon receiving one event, dump the output into the jaccessinspector
window, along with information about the property that changed.
Register with the Java application all Java Property Changed events specifically on accessible objects in which the Caret property has changed, and upon receiving an event, dumps the output into the jaccessinspector
window, along with information about the property that changed.
Register with the Java application all Java Property Changed events specifically on accessible objects in which the VisibleData property has changed, and upon receiving an event, dumps the output into the jaccessinspector
window, along with information about the property that changed.
Register with the Java application all Java Property Changed events specifically on accessible objects in which the Child property has changed, and upon receiving an event, dumps the output into the jaccessinspector
window, along with information about the property that changed.
Register with the Java application all Java Property Changed events specifically on accessible objects in which the Active Descendent property has changed, and upon receiving an event, dumps the output into the jaccessinspector
window, along with information about the property that changed.
Register with the Java application all Property Changed events specifically on accessible objects in which the Table Model Change property has changed, and upon receiving an event, dumps the output into the jaccessinspector
window, along with information about the property that changed.
Options Menu
This section describes the Options menu items.
Enables monitoring of only the events also monitored by JAWS.
Enables monitoring of all events in the jaccessinspector
window.
Resets the selected Options to the default settings.
Opens the Go To Message dialog that lets you display a logged message by entering its message number.
Clears the history of logged messages from the jaccessinspector
window.