1. /*

  2.  * @(#)AccessibleIcon.java	1.5 00/02/02

  3.  *

  4.  * Copyright 1997-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package javax.accessibility;

  12. 

  13. /**

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

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

  16.  * provides the standard mechanism for an assistive technology

  17.  * to get descriptive information about icons.

  18.  * Applications can determine

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

  20.  * obtaining its AccessibleContext (see

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

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

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

  24.  *

  25.  * @see Accessible

  26.  * @see AccessibleContext

  27.  *

  28.  * @version     1.3 10/12/99

  29.  * @author	Lynn Monsanto

  30.  */

  31. public interface AccessibleIcon {

  32. 

  33.     /**

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

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

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

  37.      * of the icon.

  38.      *

  39.      * @return the description of the icon

  40.      */

  41.     public String getAccessibleIconDescription();

  42.     

  43.     /**

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

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

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

  47.      * of the icon.

  48.      *

  49.      * @param description the description of the icon

  50.      */

  51.     public void setAccessibleIconDescription(String description);

  52. 	

  53.     /**

  54.      * Gets the width of the icon

  55.      *

  56.      * @return the width of the icon.

  57.      */

  58.     public int getAccessibleIconWidth();

  59. 

  60.     /**

  61.      * Gets the height of the icon

  62.      *

  63.      * @return the height of the icon.

  64.      */

  65.     public int getAccessibleIconHeight();

  66. 

  67. }