Description Carolyn MacLeod 2005-04-08 17:48:22 EDT

eclipse build 3.1 M6 (April 1/2005)

Please download the following tool from Microsoft, called inspect32.exe:
http://www.microsoft.com/downloads/details.aspx?
displaylang=en&familyid=3755582a-a707-460a-bf21-1373316e13f0
(Note that Bugzilla split the link across 2 lines).

Create a desktop shortcut for inspect32.exe and call it something like "MSAA 
Inspector" or "Accessibility Inspector".  Keep it somewhere useful that you 
will remember (I have mine on my Start menu <g>). This is a tool that can be 
used to help make your UI more accessible to screen readers.

Now run inspect32. Note that it just brings up a little "stay on top" window 
containing a list of field names and their values.  The fields have names 
like 'Name:', 'Value:', 'Role:', 'State:', etc.  As you move the mouse around -
 or more importantly, as you tab and arrow around through your UI - note that 
the field values change based on which control has focus.  For basic screen 
reader accessibility, the most important field is 'Name:'.  If you tab 
somewhere, or use an arrow key, and you look at 'Name:' and if it says 'none', 
then you know that you have some work to do.  Pretty much everything you tab 
to should have some kind of name.

So, for example, if I select
   Help->Cheat Sheets... Other -- "Hello World Application" -- OK
to open a "Cheat Sheets" view entitled "Simple Java Application", then I look 
at the inspect32 window, I see that the Name is 'none', and I know that a 
screen reader couldn't speak anything useful to a blind developer here.

At this point, the little minus sign beside the word "Introduction" has focus, 
so probably the most useful Name here would be "Introduction". I believe the 
little minus sign corresponds to your class named TreeNode - correct?
If so, what you need to do is add an AccessibleListener to all TreeNodes, and 
implement the getName method to return the text of the "Introduction" Label. 
For example, towards the end of your TreeNode constructor, perhaps, or 
somewhere after the widget has been created, you need something like the 
following (I am just guessing at the names, of course):

treeNodeWidget.getAccessible().addAccessibleListener(new AccessibleAdapter() {
	public void getName(AccessibleEvent e) {
		e.result = myLabelSibling.getText();
	}
});


Continuing from here, if you type tab again, and look at the inspect32 window 
again, you will notice that the little question mark icon that now has focus 
also does not have a name. It looks like this class is called an 
ImageHyperlink. I see that it does have the Help text "Open Related Help". You 
need to have something similar in the Name field, and you need to proceed in a 
similar manner to the above, except this time for ImageHyperlink. You might 
want to return something like:
	e.result = "Open Help Related To " + myLabelSibling.getText();


Continuing from here, tab twice more and there is another ImageHyperlink, with 
the Help text of "Click to Begin". So in my previous ImageHyperlink example, 
you will obviously have to be smarter than what I suggested, because 
ImageHyperlinks can have different help text, and you need to use the help 
text specific to the ImageHyperlink instance.

There's more (sorry) but adding these 2 Name fields will help a lot.
I am going to add a new comment to discuss the rest.