---
# Copyright (c) 2017, 2018, Oracle and/or its affiliates. All rights reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 2 only, as
# published by the Free Software Foundation.
#
# This code is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
# version 2 for more details (a copy is included in the LICENSE file that
# accompanied this code).
#
# You should have received a copy of the GNU General Public License version
# 2 along with this work; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
#
# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
# or visit www.oracle.com if you need additional information or have any
# questions.
#

title: 'JACCESSWALKER(1) JDK @@VERSION_SHORT@@ | JDK Commands'
date: @@COPYRIGHT_YEAR@@
lang: en
---

## Name

jaccesswalker - navigate through the component trees in a particular Java
Virtual Machine and present the hierarchy in a tree view

## Description

You select a node in the tree, and from the **Panels** menu, you select
**Accessibility API Panel**. The `jaccesswalker` tool shows you the
accessibility information for the object in the window.

## Running the jaccesswalker Tool

To use `jaccesswalker`, launch the `jaccesswalker` tool after launching a Java
application. For example, to launch `jaccesswalker`, enter the following
command:

**Note:**

`JAVA_HOME` is an environment variable and should be set to the path of the JDK
or JRE, such as, `c:\Program Files\Java\jdk-10`.

>   `%JAVA_HOME%\bin\jaccesswalker.exe`

You now have two windows open: The Java application window, and the window for
the `jaccesswalker` tool. There are two tasks that you can do with
`jaccesswalker` . You can build a tree view of the Java applications' GUI
hierarchy, and you can query the Java Accessibility API information of a
particular element in the GUI hierarchy.

## Building the GUI Hierarchy

From the **File** menu, select **Refresh Tree** menu. The `jaccesswalker` tool
builds a list of the top-level windows belonging to Java applications. The tool
then recursively queries the elements in those windows, and builds a tree of
all of the GUI components in all of the Java applications in all of the JVMs
running in the system.

## Examining a GUI Component

After a GUI tree is built, you can view detailed accessibility information
about an individual GUI component by selecting it in the tree, then selecting
**Panels**, and then **Display Accessibility Information**.
