站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

javax.accessibility (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

软件包 javax.accessibility

定义了用户界面组件与提供对这些组件进行访问的辅助技术之间的协定。

请参见:
          描述

接口摘要
Accessible Accessible 接口是可访问性包的主接口。
AccessibleAction 任何能够执行一个或多个动作的对象都应该支持 AccessibleAction 接口。
AccessibleComponent 屏幕上呈现的任何对象都应该支持 AccessibleComponent 接口。
AccessibleEditableText 在显示器上显示可编辑文本信息的所有类都应该实现 AccessibleEditableText 接口。
AccessibleExtendedComponent 屏幕上呈现的任何对象都应该支持 AccessibleExtendedComponent 接口。
AccessibleExtendedTable AccessibleExtendedTable 类提供了有关以二维表的格式呈现数据的用户界面组件的扩展信息。
AccessibleExtendedText AccessibleExtendedText 接口包含 AccessibleText 接口所未提供的其他方法 应用程序通过先获取某个对象的 AccessibleContext(参见 Accessible),然后调用 AccessibleContext 的 AccessibleContext.getAccessibleText() 方法,能够确定该对象是否支持 AccessibleExtendedText 接口。
AccessibleHypertext AccessibleHypertext 类是在显示器上显示超文本信息的所有类的基类。
AccessibleIcon 任何具有关联图标(例如按钮)的对象都应支持 AccessibleIcon 接口。
AccessibleKeyBinding 任何具有键盘绑定(例如可用于选择对象的键盘助记符和/或键盘快捷键)功能的对象都应支持 AccessibleKeyBinding 接口。
AccessibleSelection 此 AccessibleSelection 接口提供了辅助技术的标准机制,以确定当前选定了哪些子级,以及修改选项集合。
AccessibleStreamable  
AccessibleTable AccessibleTable 类描述了以二维表格式呈现数据的用户界面组件。
AccessibleTableModelChange AccessibleTableModelChange 接口描述了表模型的更改。
AccessibleText 在显示器上显示文本信息的所有类都应该实现 AccessibleText 接口。
AccessibleValue 任何支持数字值的对象(例如滚动条)都应支持 AccessibleValue 接口。
 

类摘要
AccessibleAttributeSequence 关于文本属性的连续序列的信息
AccessibleBundle 用于维护强类型枚举的基类。
AccessibleContext AccessibleContext 表示所有可访问对象返回的最少信息。
AccessibleHyperlink Hypertext 文档中的某个链接或一组链接(例如客户端 imagemap)的封装。
AccessibleRelation AccessibleRelation 类描述了实现 AccessibleRelation 的对象与一个或多个其他对象之间的关系。
AccessibleRelationSet AccessibleRelationSet 类确定了组件的关系集。
AccessibleResourceBundle 已过时。 从 Java 2 Platform 的 1.3 版开始,此类已废弃。
AccessibleRole AccessibleRole 类确定组件的职责。
AccessibleState AccessibleState 类描述了组件的特殊状态。
AccessibleStateSet AccessibleStateSet 类确定组件的状态集。
AccessibleTextSequence 关于连续文本序列的信息。
 

软件包 javax.accessibility 的描述

定义了用户界面组件与提供对这些组件进行访问的辅助技术之间的协定。如果 Java 应用程序完全支持 Java Accessibility API,则它应该与屏幕读取器、屏幕放大器这样的辅助技术保持兼容和友好。使用完全支持 Java Accessibility API 的 Java 应用程序,将不再需要离屏模型的屏幕读取器 ,因为该 API 提供了离屏模型中通常所包含的所有信息。

Java Accessibility API 包由 8 个 Java 编程语言接口和 6 个 Java 编程语言类组成。以下是对这些接口和类的描述。

Interface Accessible

Interface Accessible 是 Java Accessibility API 的主接口。所有支持 Java Accessibility API 的组件都必须实现此接口。它包含单个方法 getAccessibleContext,此方法返回 AccessibleContext 类的一个实例。Sun 认为,如果 Java 应用程序要与辅助技术兼容,则对于作为该程序用户界面的一部分的每个对象来说,实现此接口是绝对的最低需求。

Class AccessibleContext

AccessibleContext 表示所有可访问对象所返回的最少信息,它是通过调用实现 Accessible 接口的对象上的 getAccessibleContext 方法获得的。此信息包括对象的可访问名称、描述、职责状态,以及关于该对象的父对象和子对象的信息。此外,还包括对 JavaBeans TM 属性更改的支持,从而当可访问的属性值发生更改时,辅助技术能够获悉。AccessibleContext 还包含用于获取更多关于组件的特定可访问信息的方法。如果组件支持它,则这些方法将返回实现以下一个或多个接口的对象:

Class AccessibleRole

此类封装了 Accessible 对象职责,该类通过调用 AccessibleContext 上的 getAccessibleRole 方法获得。可访问的职责包括 “复选框”、“菜单项”、“面板”等等。这些职责由此类中的常量(如 AccessibleRole.CHECK_BOX、AccessibleRole.MENU_ITEMAccessibleRole.PANEL)来标识。此类中的常量存在一个公共对象职责的强类型的枚举。我们有意忽略了此类的公共构造方法,应用程序应使用此类的一个常量。虽然此类预定义了一个大的标准职责列表,但它是可扩展的,这样可以在将来添加其他程序员所定义的职责,而无需修改基类。

Class AccessibleState

此类封装了 Accessible 对象的特殊状态。可访问的状态包括 "Armed"、"Busy"、"Checked"、"Focused"等等。这些职责由此类的常量(如 AccessibleState.ARMED、AccessibleState.BUSY、AccessibleState.CHECKEDAccessibleState.FOCUSED)来标识。Accessible 对象的所有状态的集合称为 AccessibleStateSet,它可以通过调用 AccessibleContext 上的 getAccessibleStateSet 方法获得。

此类中的常量存在一个公共对象职责的强类型的枚举。我们有意忽略了此类的公共构造方法,应用程序应使用此类的一个常量。虽然此类预定义了一个大的标准职责列表,但它是可扩展的,这样可以在将来添加其他程序员所定义的职责,而无需修改基类。

Class AccessibleStateSet

此类封装了 Accessible 对象的状态集合,此类通过调用 AccessibleContext 上的 getAccessibleStateSet 方法获得。因为一个对象可能有多个状态(例如,它可能同时处于 "Checked" 和 "Focused" 状态),因此此类需要封装这些状态的集合。此类中的方法可以在状态集上检索单个 AccessibleStates

Class AccessibleBundle

此类用于维护强类型枚举。它是 AccessibleRoleAccessibleState 类的超类。程序员一般不与此类直接进行交互,而是使用 AccessibleRoleAccessibleState 类。

Interface AccessibleAction

任何能够执行一个或多个动作的对象都应支持 AccessibleAction 接口。此接口为辅助技术提供了标准机制,以确定这些动作并通知对象执行它们。任何可以操作的对象都应支持此接口。

应用程序通过先获取某个对象的 AccessibleContext(参见 Accessible),然后调用 AccessibleContext 上的 getAccessibleAction 方法,能够确定该对象是否支持 AccessibleAction 接口。如果返回值不为 null,则该对象支持此接口。

Interface AccessibleComponent

任何在屏幕上呈现的对象都应支持 AccessibleComponent 接口。此接口为辅助技术提供了标准机制,以确定和设置对象的图形表示形式。

应用程序通过先调用某个对象的 AccessibleContext(参见 Accessible),然后调用 AccessibleContext 上的 getAccessibleComponent 方法,能够确定该对象是否支持 AccessibleComponent 接口。如果返回值不为 null,则该对象支持此接口。

Interface AccessibleSelection

AccessibleSelection 接口为辅助技术提供了标准机制,以确定当前选定了哪些子对象,并修改选择设置。任何具有可选子对象的对象都应支持 AccessibleSelection 接口。

应用程序通过先获取某个对象的 AccessibleContext(参见 Accessible),然后调用 AccessibleContext 上的 getAccessibleSelection 方法,能够确定该对象是否支持 AccessibleSelection 接口。如果返回值不为 null,则该对象支持此接口。

Interface AccessibleText

AccessibleText 接口是针对生成丰富的、可编辑的文本 Accessible 的协定。并不是屏幕上显示的所有文本都是富文本和可编辑的(例如对于按钮、标签和菜单中所包含的文本,用户就不能对其进行操作)。但是,如果包含可编辑文本的对象要与辅助技术进行互操作,则它们必须实现 AccessibleText 接口。

此接口支持在像素坐标和给定像素坐标处的文本之间进行转换,以及检索文本中给定位置处、给定位置前或给定位置后的字母、单词和句子。此接口支持对文本中给定位置处的字符属性(字体、字体大小、样式,等等)进行检索,以及获得选中的文本(如果有)、文本长度和文本插入符位置。

应用程序通过先获取某个对象的 AccessibleContext(参见 Accessible),然后调用 AccessibleContextgetAccessibleText 方法,能够确定该对象是否支持 AccessibleText 接口。如果返回值不为 null,则该对象支持此接口。

Interface AccessibleHypertext

任何在显示器上显示超文本信息的对象都应支持 AccessibleHypertext 接口。此接口为辅助技术提供了标准机制,用于通过文本的内容、属性和空间位置来访问该文本。它还提供了操作超链接的标准机制。应用程序通过先获取某个对象的 AccessibleContext(参见 Accessible),然后调用 AccessibleContext 的 AccessibleContext.getAccessibleText() 方法,能够确定该对象是否支持 AccessibleHypertext 接口。如果返回值是一个扩展了 AccessibleHypertext 的类,则该对象支持 AccessibleHypertext。

Interface AccessibleHyperlink

超链接对象应支持 AccessibleHyperlink 接口。通过调用 AccessibleHypertext 对象上的 getLink 方法将返回实现此接口的对象。

Interface AccessibleValue

任何支持数字值的对象(例如滚动条)都应支持 AccessibleValue 接口。此接口为辅助技术提供了标准机制,以确定和设置数字值,以及获取最小值和最大值。

应用程序通过先获取某对象的 AccessibleContext(参见 Accessible),然后调用 AccessibleContextgetAccessibleValue 方法,能够确定该对象是否支持 AccessibleValue 接口。如果返回值不为 null,则该对象支持此接口。

从以下版本开始:
JDK1.2

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策