1. /*

  2.  * @(#)AccessibleIcon.java	1.8 03/12/19

  3.  *

  4.  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package javax.accessibility;

  9. 

  10. /**

  11.  * The AccessibleIcon interface should be supported by any object 

  12.  * that has an associated icon (e.g., buttons). This interface 

  13.  * provides the standard mechanism for an assistive technology

  14.  * to get descriptive information about icons.

  15.  * Applications can determine

  16.  * if an object supports the AccessibleIcon interface by first

  17.  * obtaining its AccessibleContext (see

  18.  * {@link Accessible}) and then calling the

  19.  * {@link AccessibleContext#getAccessibleIcon} method.

  20.  * If the return value is not null, the object supports this interface.

  21.  *

  22.  * @see Accessible

  23.  * @see AccessibleContext

  24.  *

  25.  * @version     1.3 10/12/99

  26.  * @author	Lynn Monsanto

  27.  */

  28. public interface AccessibleIcon {

  29. 

  30.     /**

  31.      * Gets the description of the icon.  This is meant to be a brief

  32.      * textual description of the object.  For example, it might be

  33.      * presented to a blind user to give an indication of the purpose

  34.      * of the icon.

  35.      *

  36.      * @return the description of the icon

  37.      */

  38.     public String getAccessibleIconDescription();

  39.     

  40.     /**

  41.      * Sets the description of the icon.  This is meant to be a brief

  42.      * textual description of the object.  For example, it might be

  43.      * presented to a blind user to give an indication of the purpose

  44.      * of the icon.

  45.      *

  46.      * @param description the description of the icon

  47.      */

  48.     public void setAccessibleIconDescription(String description);

  49. 	

  50.     /**

  51.      * Gets the width of the icon

  52.      *

  53.      * @return the width of the icon.

  54.      */

  55.     public int getAccessibleIconWidth();

  56. 

  57.     /**

  58.      * Gets the height of the icon

  59.      *

  60.      * @return the height of the icon.

  61.      */

  62.     public int getAccessibleIconHeight();

  63. 

  64. }