Help for the AWB v1.7
The AWB, or Accessibility Work Bench, is a tool
for testing the implementation UNO Accessibility API.
The main window is roughly divided into three areas:
- The tree view on the left shows a part of the
accessibility tree of one or more StarOffice/OpenOffice applications.
- The graphical view on the right side shows
a graphical representation of the accessibility objects in the tree. To
make objects missing in the graphical view visible expand the corresponding
nodes in the tree view.
- The text window at the bottom logs important messages.
The tree view has a top-level node for every open
document window of StarOffice/OpenOffice. Expand those nodes to make them
visible in the graphical view.
Nodes
The nodes in the tree view belong to different classes, some of which
have children others do not:
- Accessible Object
The node represents an accessible object and has corresponding shape in
the graphical view. Only this kind of node gets highlighted by clicking
on those shapes.
- Simple Property
These leaves represent simple properties of their parent nodes. Examples
are the position, size, and color of an accessible object.
- Complex Properties
These nodes have children that are not accessible objects. Examples are
the lists of interfaces or services supported by an accessible object.
Actions
The tree view supports the following actions:
- Left double click expands the node under the mouse pointer.
- Right click shows a context menu. Entries, when supported, are:
- Expand Shapes
Expands all nodes in the sub-tree that lie on a path from the root to a shape.
- Expand Subtree
Expands all nodes in the sub-tree.
- Select...
Show a dialog that gives access to the XAccessibleSelection interface.
- select..., copy..., cut..., paste...,
edit..., format...
Show dialogs that give access to the XAccessibleText and
XAccessibleEditableText interfaces.
The graphical view shows several properties of accessibility objects:
- The bounding box is represented as a rectangle.
- The background color of the accessible object is taken to draw the
bounding box rectangle.
- The foreground color is used to fill the bounding box.
- The accessible name is shown when the menu checkbox Options->Show Name
is check.
- The accessible description is shown when the menu checkbox Options->Show
Descriptons is checked.
- If the XAccessibleText interface is supported and the menu checkbox
Options->Show Text is checked then the text of the accessible object is
shown.
Actions
The graphical view supports three the following actions:
- Left click (no modifiers) highlights the object under the mouse as well
as the corresponding node in the tree view.
- Left click with Control modifier expands the object under the
mouse.
- Mouse motion with Shift modifier highlights the object under the mouse
as well as the corresponding node in the tree view.