Package javax.accessibility

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

See: 描述

接口摘要

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

类摘要

类	描述
AccessibleAttributeSequence	该类将共享相同连续属性集的文本的跨度以及该组属性一起收集。
AccessibleBundle	用于维护强类型枚举的基类。
AccessibleContext	AccessibleContext表示所有可访问对象返回的最小信息。
AccessibleHyperlink	链接的封装或链接的集合（例如，
AccessibleRelation	Class AccessibleRelation描述了实现AccessibleRelation的对象与一个或多个其他对象之间的关系。
AccessibleRelationSet	Class AccessibleRelationSet确定组件的关系集。
AccessibleResourceBundle	Deprecated 从Java平台1.3版开始，此类已被弃用。
AccessibleRole	AccessibleRole类决定组件的作用。
AccessibleState	AccessibleState类描述组件的特定状态。
AccessibleStateSet	AccessibleStateSet类确定组件的状态集。
AccessibleTextSequence	这个类收集了文本跨度的关键细节。

Package javax.accessibility Description

定义用户界面组件与提供对这些组件的访问的辅助技术之间的合同。 如果一个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表示所有可访问的对象返回的最少信息，并通过调用实现在物体上的getAccessibleContext方法获得Accessible接口。 此信息包括对象的可访问名称，描述， role和state ，以及有关对象的父项和子项的信息。 此外，还包括JavaBeans ^TM属性更改支持，以便在可访问属性的值更改时允许辅助性技术学习。 AccessibleContext还包含获取有关组件的更多特定辅助功能信息的方法。 如果组件支持它，这些方法将返回一个实现一个或多个以下接口的对象：

• AccessibleAction - 该对象可以执行一个或多个操作。 该界面提供了辅助技术的标准机制来确定哪些操作是什么，并告诉对象来执行这些操作。 当AccessibleContext上调用getAccessibleAction方法时，任何可以被操纵的对象都应该返回一个实现该接口的对象。
• AccessibleComponent - 对象具有图形表示。 该界面提供了辅助技术的标准机制，以确定和设置对象的图形表示。 当在AccessibleContext上调用getAccessibleComponent方法时，屏幕上呈现的任何对象都应该返回实现此接口的对象。
• AccessibleSelection - 对象允许选择它的孩子。 该界面提供了辅助技术的标准机制，以确定当前选定的儿童以及修改选择集。 具有可选择的子项的任何对象应该在AccessibleContext上调用getAccessibleSelection方法时返回实现此接口的对象。
• AccessibleText - 对象在显示器上显示可编辑的文本信息。 该界面提供了辅助技术通过其内容，属性和空间位置访问该文本的标准机制。 包含可编辑文本的任何对象应在AccessibleContext上调用getAccessibleText方法时返回实现此接口的对象。
• AccessibleHypertext - 该对象在显示器上显示超文本信息。 该界面提供辅助技术的标准机制，通过其内容，属性和空间位置访问该超文本。 包含超文本的任何对象应在AccessibleContext上调用getAccessibleText方法时返回实现此接口的对象。
• AccessibleValue - 对象支持数值。 该界面提供了辅助技术的标准机制，用于确定和设置对象的当前值以及最小值和最大值。 在AccessibleContext上调用getAccessibleValue方法时，任何支持数值的对象都应该返回实现此接口的对象。

Class AccessibleRole

该类将Accessible对象的角色封装在用户界面中，并通过在AccessibleContext上调用getAccessibleRole方法获得 。 可访问的角色包括“复选框”，“菜单项”，“面板”等。这些角色由此类中的常量 （如AccessibleRole.CHECK_BOX, AccessibleRole.MENU_ITEM,和AccessibleRole.PANEL）标识 。 这个类中的常量表现出强类型的常见对象角色枚举。 这个类的公共构造函数被有意地省略，应用程序应该使用这个类的一个常量。 虽然这个类预定义了大量的标准角色列表，但是它是可扩展的，因此在将来可以添加额外的程序员定义的角色，而不需要修改基类。

Class AccessibleState

该类封装了Accessible对象的特定状态。 可访问的状态包括“武装”，“忙”，“检查”，“聚焦”等等。这些角色由此类中的常量标识 ，如AccessibleState.ARMED, AccessibleState.BUSY, AccessibleState.CHECKED,和AccessibleState.FOCUSED 。 可访问对象的所有状态的总和称为AccessibleStateSet ，可以通过在AccessibleContext上调用getAccessibleStateSet方法获得 。

这个类中的常量表现出强类型的常见对象角色枚举。 这个类的公共构造函数被有意地省略，应用程序应该使用这个类的一个常量。 虽然这个类预先定义了大量的标准角色，但是它是可扩展的，所以在将来可以添加额外的程序员定义的角色，而不需要修改基类。

Class AccessibleStateSet

该类封装了Accessible对象的状态集合，并通过在AccessibleContext上调用getAccessibleStateSet方法获得 。 由于对象可能具有多个状态（例如，它可能都是“检查”和“聚焦”），因此需要封装这些状态的集合。 该类中的方法提供在状态集上检索个人AccessibleStates 。

Class AccessibleBundle

此类用于维护强类型枚举。 它是AccessibleRole和AccessibleState类的超级类。 程序员通常不会直接与这个类交互，而是使用AccessibleRole和AccessibleState类。

Interface AccessibleAction

所述AccessibleAction接口应该由能够执行一个或多个动作的任何对象的支持。 该界面提供了辅助技术的标准机制，以确定哪些操作以及告诉对象执行这些操作。 任何可以被操纵的对象都应该支持这个接口。

应用程序可以通过首先获得其AccessibleContext （参见Accessible ），然后调用AccessibleContext的getAccessibleAction方法来确定对象是否支持AccessibleAction 接口 。 如果返回值不为空，则该对象支持该接口。

Interface AccessibleComponent

应该在屏幕上呈现的任何对象支持 AccessibleComponent界面。 该界面提供了辅助技术的标准机制来确定和设置对象的图形表示。

应用程序可以通过首先获取其AccessibleContext （参见Accessible ），然后调用AccessibleContext的getAccessibleComponent方法来确定对象是否支持AccessibleComponent 接口 。 如果返回值不为空，则该对象支持该接口。

Interface AccessibleSelection

AccessibleSelection接口提供辅助技术的标准机制，以确定当前所选择的孩子是什么，以及修改选择集。 具有可以选择的子项的任何对象都应该支持AccessibleSelection接口。

应用程序可以通过首先获得其AccessibleContext （参见Accessible ），然后调用88471235388641的getAccessibleSelection方法来确定对象是否支持AccessibleSelection 接口 。 如果返回值不为空，则该对象支持该接口。

Interface AccessibleText

界面AccessibleText是制作丰富，可编辑的文字的合同。 并非所有显示在屏幕上的文字都是丰富且可编辑的（例如，包含在按钮，标签，菜单等中的文本，用户不期望操作）。 然而，包含可编辑文本的对象必须实现AccessibleText接口，如果它们与辅助技术进行互操作。

该界面提供了在像素坐标和给定像素坐标处的文本之间进行的支持，用于在文本中的给定位置之前，之前或之后检索字母，单词和句子。 该界面提供支持在文本中的给定位置（字体，字体大小，样式等）检索字符的属性，以及获取所选文本（如果有），文本长度和文字插入符的位置。

应用程序可以首先获取其AccessibleContext （参见Accessible ），然后调用getAccessibleText的getAccessibleText方法来确定对象是否支持AccessibleText 接口 。 如果返回值不为空，则该对象支持该接口。

Interface AccessibleHypertext

所述AccessibleHypertext接口应该由呈现在显示器上的超文本信息的任何对象得到支持。 该界面提供了辅助技术通过其内容，属性和空间位置访问该文本的标准机制。 它还提供了操纵hyperlinks的标准机制 。 应用程序可以通过首先获取其AccessibleContext （参见Accessible ），然后调用AccessibleContext的AccessibleContext.getAccessibleText（）方法来确定对象是否支持AccessibleHypertext 接口 。 如果返回值是扩展AccessibleHypertext的类，则该对象支持AccessibleHypertext。

Interface AccessibleHyperlink

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

Interface AccessibleValue

AccessibleValue接口应该由支持数值的任何对象（例如滚动条）支持。 该界面提供了辅助技术的标准机制，用于确定和设置数值以及获取最小值和最大值。

应用程序可以通过首先获取其AccessibleContext （参见Accessible ），然后调用AccessibleContext的getAccessibleValue方法来确定对象是否支持AccessibleValue 接口 。 如果返回值不为空，则该对象支持该接口。

从以下版本开始：

1.2