Path: csiph.com!x330-a1.tempe.blueboxinc.net!newsfeed.hal-mli.net!feeder1.hal-mli.net!border3.nntp.dca.giganews.com!border1.nntp.dca.giganews.com!nntp.giganews.com!postnews.google.com!v3g2000vbx.googlegroups.com!not-for-mail
From: Ross <rossclement@gmail.com>
Newsgroups: comp.lang.java.programmer
Subject: Making Java programs accessible for visually impaired users
Date: Fri, 12 Aug 2011 01:38:19 -0700 (PDT)
Organization: http://groups.google.com
Lines: 164
Message-ID: <8ddb2e0b-3a7c-458f-87cf-5b06ec352c2d@v3g2000vbx.googlegroups.com>
NNTP-Posting-Host: 80.176.151.208
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
X-Trace: posting.google.com 1313138300 27888 127.0.0.1 (12 Aug 2011 08:38:20 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Fri, 12 Aug 2011 08:38:20 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: v3g2000vbx.googlegroups.com; posting-host=80.176.151.208; posting-account=e1CBswoAAACHfb-egdiJeDKz3WQXJQFe
User-Agent: G2/1.0
X-Google-Web-Client: true
X-Google-Header-Order: HUALESNKRC
X-HTTP-UserAgent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:5.0.1) Gecko/20100101 Firefox/5.0.1,gzip(gfe)
Xref: x330-a1.tempe.blueboxinc.net comp.lang.java.programmer:7035

I'm rather confused about the very varied information on the web about
how to make Swing applications accessible for visually impaired users.
I've found this page which describes it as being easy and
straightforward, and gives some examples. http://www.erigena.com/resources/articles/accessible-java/

I've extended that program to produce a new example, see below. This
is my first attempt at even a one-pager in terms of accessibility.

The program I would like to make accessible includes a small number of
custom GUI widgets, so I'd need to implement various interfaces. But,
I've found this as an example: http://www-03.ibm.com/able/guidelines/java/snsjavagcustom.html

Is there a current "best practice" or best choice of tools which could
be used to make a Java application accessible?




import java.awt.*;
import javax.swing.*;
import javax.accessibility.*;
import java.awt.event.*;

public class AccessTest extends JFrame
{
          private JList content;

          public AccessTest()
	  {
            setLayout( new BorderLayout() );
	    JMenu file = new JMenu( "File" );
            file.setMnemonic( 'F' );

            AccessibleContext context = file.getAccessibleContext();
	    context.setAccessibleName( "File Menu" );
	    context.setAccessibleDescription( "Menu for loading and saving
files" );

            JMenuItem quit = new JMenuItem( "Quit" );
            quit.setMnemonic( 'Q' );
            quit.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_Q,
Event.CTRL_MASK));

            context = quit.getAccessibleContext();
	    context.setAccessibleName( "Quit" );
	    context.setAccessibleDescription( "Quit Option" );

            file.add( quit );
	    quit.addActionListener(
		new ActionListener()
		{
		  public void actionPerformed( ActionEvent aent )
		  {
		    goQuit();
		  }
		}
	    );

	    JMenuBar jmb = new JMenuBar();
            context = jmb.getAccessibleContext();
	    context.setAccessibleName( "Menu Bar" );
	    context.setAccessibleDescription( "The main menu bar" );
            setJMenuBar( jmb );

	    jmb.add( file );

            DefaultListModel dlm = new DefaultListModel();
 	    content = new JList();

	    for ( int index = 0; index < 100; index++ )
	    {
	      dlm.addElement( "Item Number " + (index+1) );
	    }

            content.setModel( dlm );

            context = content.getAccessibleContext();
	    context.setAccessibleName( "Content" );
	    context.setAccessibleDescription( "List of options to choose
from" );

 	    add( new JScrollPane( content ), BorderLayout.CENTER );

	    JPanel bottomPanel = new JPanel( new FlowLayout() );
            context = content.getAccessibleContext();
	    context.setAccessibleName( "Items List" );
	    context.setAccessibleDescription( "Bottom panel with selection
buttons" );

	    JButton delete = new JButton( "Delete" );
	    delete.setMnemonic( 'D' );

	    delete.addActionListener(
		new ActionListener()
		{
	    	  public void actionPerformed( ActionEvent aent )
		  {
		    goDelete();
		  }
		}
	    );

	    bottomPanel.add( delete );

	    JButton create = new JButton( "Create" );
	    create.setMnemonic( 'C' );
	    create.addActionListener(
		new ActionListener()
		{
	    	  public void actionPerformed( ActionEvent aent )
		  {
		    goCreate();
		  }
		}
	    );

	    bottomPanel.add( create );

	    add( bottomPanel, BorderLayout.SOUTH );

	    setBounds( 200, 200, 200, 200 );
 	    setTitle( "Test frame for accessibility" );

	    context = getAccessibleContext();
	    context.setAccessibleName( "Test Frame" );
	    context.setAccessibleDescription( "Test frame for some basic
experiments with the Java accessibility framework" );

	    addWindowListener(
		new WindowAdapter()
		{
		  public void windowClosing( WindowEvent went )
		  {
		    goQuit();
		  }
		}
	    );
	  }

	  private void goQuit()
	  {
	    System.exit( 0 );
	  }

  	  public static void main( String args[] )
          {
	    AccessTest at = new AccessTest();
	    at.setVisible( true );
	  }

 	  private void goDelete()
	  {
	    JOptionPane.showMessageDialog( this, "The delete option was
selected", "Delete Selected",
					   JOptionPane.INFORMATION_MESSAGE );
	  }

 	  private void goCreate()
	  {
	    JOptionPane.showMessageDialog( this, "The create option was
selected", "Create Selected",
					   JOptionPane.INFORMATION_MESSAGE );
	  }
}