Documentation Contents

Enabling and Testing Java Access Bridge on Microsoft Windows

Java Accessibility Guide > Enabling and Testing Java Access Bridge

Java Access Bridge is a technology that enables Java applications and applets that implement the Java Accessibility API to be visible to assistive technologies on Microsoft Windows systems. See Java SE Desktop Accessibility for more information.

The following topics are covered:

• Enabling and Disabling Java Access Bridge
  • Enabling Java Access Bridge
  • Disabling Java Access Bridge
• Testing Java Access Bridge
• Obtaining Java Access Bridge Testing Tools
• Troubleshooting

Enabling and Disabling Java Access Bridge

Java Access Bridge has been included in the Java SE Runtime Environment (JRE) since JRE 7 Update 6 (7u6). Consequently, you do not need the standalone version of Java Access Bridge (the latest version is 2.0.2).

Enabling Java Access Bridge

To enable Java Access Bridge, run the following command (where %JRE_HOME% is the directory of your JRE):

%JRE_HOME%\bin\jabswitch -enable

Alternatively, in Windows Vista and later, you can enable Java Access Bridge through the Control Panel:

1. Go to Start > Control Panel > Ease of Access > Ease of Access Center. Alternatively, press Windows logo key+u to access the Ease of Access Center.
2. Select Use the computer without a display.
3. In the section Other programs installed, select the check box Enable Java Access Bridge (you may have to scroll down).

Note: After enabling Java Access Bridge, you must restart your assistive technology software and Java applications that use the accessibility API.

Disabling Java Access Bridge

To disable Java Access Bridge, run the following command:

%JRE_HOME%\bin\jabswitch -disable

Note: You cannot disable Java Access Bridge through the Windows Ease of Access Center.

Testing Java Access Bridge

To test Java Access Bridge, follow these steps:

1. Ensure that Java Access Bridge is enabled.
2. Install an assistive technology product that supports Java Access Bridge such as one of the following products:
   • JAWS
   • NonVisual Desktop Access (NVDA)
   • SuperNova
   • ZoomText
3. Run a Java application that uses the accessibility API such as the SwingSet2 demonstration program. Ensure that your assistive technology product works properly with the Java application.

Obtaining Java Access Bridge Testing Tools

The Java Access Bridge testing tools, jaccessinspector and jaccesswalker, are available in JDK 11 and later and work with all 64-bit JDK releases. These tools replace Java Ferret and Java Monkey.

To test 32-bit applications, use Java Ferret and Java Monkey, which are part of Java Access Bridge 2.0.2. Download it from Java Access Bridge Downloads. For more information about Java Access Bridge 2.0.2, Java Ferret, and Java Monkey, see Java Access Bridge Installation and Application Developer's Guide Release 2.0.2.

Troubleshooting

Using Assistive Technologies on 64-Bit Operating Systems

The following lists the minimum version requirements of some assistive technologies for 64-bit operating systems:

• JAWS: Version 13 and later
• NVDA: Version 2011.3 and later
• SuperNova: Version 13 and later
• ZoomText: Version 10.1.5 and later

Note: It is recommend that you install both the 32-bit and 64-bit versions of the JRE. The 32-bit version only adds support for 32-bit assistive technology, and the 64-bit version only adds support for 64-bit assistive technology.

Using Java Access Bridge with Only the Private JRE

The JDK contains a private JRE. This is required to run tools included with the JDK. If you do not install the public JRE either as an option when installing the JDK or by installing the JRE by itself, and you intend to use the private JRE of the JDK, you will need to manually copy files as specified in the following table:

---

Copyright © 1993, 2024, Oracle and/or its affiliates. All rights reserved.

Contact Us