uTools-Manuals/docs/java/javax/accessibility/package-summary.html

319 lines
24 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<h1 class="title" title="Package">Package javax.accessibility</h1>
<div class="docSummary">
<div class="block">
定义用户界面组件与提供对这些组件的访问的辅助技术之间的合同。
</div>
</div>
<p>See: <a href="#package.description">描述</a></p>
</div><div class="contentContainer">
<ul class="blockList">
<li class="blockList">
<table border="0" cellpadding="3" cellspacing="0" class="typeSummary" summary="Interface Summary table, listing interfaces, and an explanation">
<caption>
<span>接口摘要</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">接口</th>
<th class="colLast" scope="col">描述</th>
</tr>
</tbody>
<tbody>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/Accessible.html" title="interface in javax.accessibility">Accessible</a></td>
<td class="colLast">
<div class="block">
Interface Accessible是可访问性包的主要界面。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleAction.html" title="interface in javax.accessibility">AccessibleAction</a></td>
<td class="colLast">
<div class="block">
任何可以执行一个或多个操作的对象都应该支持AccessibleAction接口。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleComponent.html" title="interface in javax.accessibility">AccessibleComponent</a></td>
<td class="colLast">
<div class="block">
AccessibleComponent接口应该由屏幕上呈现的任何对象支持。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleEditableText.html" title="interface in javax.accessibility">AccessibleEditableText</a></td>
<td class="colLast">
<div class="block">
AccessibleEditableText接口应该由显示器上显示可编辑文本信息的所有类来实现。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleExtendedComponent.html" title="interface in javax.accessibility">AccessibleExtendedComponent</a></td>
<td class="colLast">
<div class="block">
AccessibleExtendedComponent接口应该由屏幕上呈现的任何对象支持。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleExtendedTable.html" title="interface in javax.accessibility">AccessibleExtendedTable</a></td>
<td class="colLast">
<div class="block">
Class AccessibleExtendedTable提供有关以二维表格格式显示数据的用户界面组件的扩展信息。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleExtendedText.html" title="interface in javax.accessibility">AccessibleExtendedText</a></td>
<td class="colLast">
<div class="block">
<span>AccessibleExtendedText接口包含AccessibleText接口未提供的附加方法应用程序可以通过首先获取其AccessibleContext参见<a href="../../javax/accessibility/Accessible.html" title="javax.accessibility中的接口"><code>Accessible</code></a> ),然后调用<a href="../../javax/accessibility/AccessibleContext.html#getAccessibleText--">AccessibleContext的<code>AccessibleContext.getAccessibleText()</code></a>方法来确定对象是否支持AccessibleExtendedText接口。</span>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleHypertext.html" title="interface in javax.accessibility">AccessibleHypertext</a></td>
<td class="colLast">
<div class="block">
AccessibleHypertext类是在显示器上显示超文本信息的所有类的基类。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleIcon.html" title="interface in javax.accessibility">AccessibleIcon</a></td>
<td class="colLast">
<div class="block">
AccessibleIcon接口应该由具有关联图标的任何对象例如按钮支持。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleKeyBinding.html" title="interface in javax.accessibility">AccessibleKeyBinding</a></td>
<td class="colLast">
<div class="block">
任何具有诸如键盘助记符和/或键盘快捷键之类的键盘绑定的对象都可以支持AccessibleKeyBinding接口可用于选择对象。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleSelection.html" title="interface in javax.accessibility">AccessibleSelection</a></td>
<td class="colLast">
<div class="block">
该AccessibleSelection界面提供了辅助技术的标准机制以确定当前所选择的孩子是什么以及修改选择集。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleStreamable.html" title="interface in javax.accessibility">AccessibleStreamable</a></td>
<td class="colLast">
<div class="block">
所述
<code>AccessibleStreamable</code>接口应该由实施
<code>AccessibleContext</code>呈现在显示屏幕上的部件的后面的原始流的任何组分。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleTable.html" title="interface in javax.accessibility">AccessibleTable</a></td>
<td class="colLast">
<div class="block">
Class AccessibleTable描述了以二维表格格式显示数据的用户界面组件。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleTableModelChange.html" title="interface in javax.accessibility">AccessibleTableModelChange</a></td>
<td class="colLast">
<div class="block">
AccessibleTableModelChange接口描述对表模型的更改。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleText.html" title="interface in javax.accessibility">AccessibleText</a></td>
<td class="colLast">
<div class="block">
AccessibleText界面应由显示文本信息的所有类实现。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleValue.html" title="interface in javax.accessibility">AccessibleValue</a></td>
<td class="colLast">
<div class="block">
AccessibleValue界面应该由支持数值的任何对象例如滚动条支持。
</div> </td>
</tr>
</tbody>
</table> </li>
<li class="blockList">
<table border="0" cellpadding="3" cellspacing="0" class="typeSummary" summary="Class Summary table, listing classes, and an explanation">
<caption>
<span>类摘要</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col"></th>
<th class="colLast" scope="col">描述</th>
</tr>
</tbody>
<tbody>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleAttributeSequence.html" title="class in javax.accessibility">AccessibleAttributeSequence</a></td>
<td class="colLast">
<div class="block">
该类将共享相同连续属性集的文本的跨度以及该组属性一起收集。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleBundle.html" title="class in javax.accessibility">AccessibleBundle</a></td>
<td class="colLast">
<div class="block">
用于维护强类型枚举的基类。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleContext.html" title="class in javax.accessibility">AccessibleContext</a></td>
<td class="colLast">
<div class="block">
AccessibleContext表示所有可访问对象返回的最小信息。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleHyperlink.html" title="class in javax.accessibility">AccessibleHyperlink</a></td>
<td class="colLast">
<div class="block">
链接的封装或链接的集合(例如,
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleRelation.html" title="class in javax.accessibility">AccessibleRelation</a></td>
<td class="colLast">
<div class="block">
Class AccessibleRelation描述了实现AccessibleRelation的对象与一个或多个其他对象之间的关系。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleRelationSet.html" title="class in javax.accessibility">AccessibleRelationSet</a></td>
<td class="colLast">
<div class="block">
Class AccessibleRelationSet确定组件的关系集。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleResourceBundle.html" title="class in javax.accessibility">AccessibleResourceBundle</a></td>
<td class="colLast">Deprecated
<div class="block">
<span class="deprecationComment">从Java平台1.3版开始,此类已被弃用。</span>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleRole.html" title="class in javax.accessibility">AccessibleRole</a></td>
<td class="colLast">
<div class="block">
AccessibleRole类决定组件的作用。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleState.html" title="class in javax.accessibility">AccessibleState</a></td>
<td class="colLast">
<div class="block">
AccessibleState类描述组件的特定状态。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleStateSet.html" title="class in javax.accessibility">AccessibleStateSet</a></td>
<td class="colLast">
<div class="block">
AccessibleStateSet类确定组件的状态集。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../javax/accessibility/AccessibleTextSequence.html" title="class in javax.accessibility">AccessibleTextSequence</a></td>
<td class="colLast">
<div class="block">
这个类收集了文本跨度的关键细节。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<a name="package.description">
<!-- --> </a>
<h2 title="Package javax.accessibility Description">Package javax.accessibility Description</h2>
<div class="block">
<span>定义用户界面组件与提供对这些组件的访问的辅助技术之间的合同。</span>
<span>如果一个Java应用程序完全支持Java Accessibility API那么它应该与诸如屏幕阅读器屏幕放大器等的辅助技术兼容并且友好。使用完全支持Java Accessibility API的Java应用程序没有屏幕阅读器关闭屏幕模型是必要的因为API提供通常包含在离屏模型中的所有信息。</span>
<p> <span>Java Accessibility API包由8个Java编程语言接口和6个Java编程语言类组成。</span> <span>这些在下面描述。</span> </p>
<h3> <span><a name="Accessible"></a> <a href="Accessible.html">Interface Accessible</a></span> </h3>
<span><a href="Accessible.html">Interface Accessible</a>是Java Accessibility API的主界面。</span>
<span>支持Java Accessibility API的所有组件都必须实现此接口。</span>
<span>它包含一个单一的方法, <tt>getAccessibleContext</tt> ,它返回<a href="#AccessibleContext">AccessibleContext</a>类的一个实例。</span>
<span>Sun认为实现此接口是作为Java应用程序用户界面一部分的每个对象的绝对最低要求如果该程序与辅助技术兼容。</span>
<h3> <span><a name="AccessibleContext"></a> <a href="AccessibleContext.html">Class AccessibleContext</a></span> </h3>
<span><a href="AccessibleContext.html">AccessibleContext</a>表示所有可访问的对象返回的最少信息,并通过调用实现在物体上的<tt>getAccessibleContext</tt>方法获得<a href="#Accessible">Accessible</a>接口。</span>
<span>此信息包括对象的可访问名称,描述, <a href="#AccessibleRole">role</a><a href="#AccessibleState">state</a> ,以及有关对象的父项和子项的信息。</span>
<span>此外还包括JavaBeans <sup><font size="-2">TM</font></sup>属性更改支持,以便在可访问属性的值更改时允许辅助性技术学习。</span>
<span>AccessibleContext还包含获取有关组件的更多特定辅助功能信息的方法。</span>
<span>如果组件支持它,这些方法将返回一个实现一个或多个以下接口的对象:</span>
<ul>
<li> <span><b><a href="#AccessibleAction">AccessibleAction</a></b> - 该对象可以执行一个或多个操作。</span> <span>该界面提供了辅助技术的标准机制来确定哪些操作是什么,并告诉对象来执行这些操作。</span> <span><tt>AccessibleContext</tt>上调用<tt>getAccessibleAction</tt>方法时,任何可以被操纵的对象都应该返回一个实现该接口的对象。</span> </li>
<li> <span><b><a href="#AccessibleComponent">AccessibleComponent</a></b> - 对象具有图形表示。</span> <span>该界面提供了辅助技术的标准机制,以确定和设置对象的图形表示。</span> <span>当在<tt>AccessibleContext</tt>上调用<tt>getAccessibleComponent</tt>方法时,屏幕上呈现的任何对象都应该返回实现此接口的对象。</span> </li>
<li> <span><b><a href="#AccessibleSelection">AccessibleSelection</a></b> - 对象允许选择它的孩子。</span> <span>该界面提供了辅助技术的标准机制,以确定当前选定的儿童以及修改选择集。</span> <span>具有可选择的子项的任何对象应该在<tt>AccessibleContext</tt>上调用<tt>getAccessibleSelection</tt>方法时返回实现此接口的对象。</span> </li>
<li> <span><b><a href="#AccessibleText">AccessibleText</a></b> - 对象在显示器上显示可编辑的文本信息。</span> <span>该界面提供了辅助技术通过其内容,属性和空间位置访问该文本的标准机制。</span> <span>包含可编辑文本的任何对象应在<tt>AccessibleContext</tt>上调用<tt>getAccessibleText</tt>方法时返回实现此接口的对象。</span> </li>
<li> <span><b><a href="#AccessibleHypertext">AccessibleHypertext</a></b> - 该对象在显示器上显示超文本信息。</span> <span>该界面提供辅助技术的标准机制,通过其内容,属性和空间位置访问该超文本。</span> <span>包含超文本的任何对象应在<tt>AccessibleContext</tt>上调用<tt>getAccessibleText</tt>方法时返回实现此接口的对象。</span> </li>
<li> <span><b><a href="#AccessibleValue">AccessibleValue</a></b> - 对象支持数值。</span> <span>该界面提供了辅助技术的标准机制,用于确定和设置对象的当前值以及最小值和最大值。</span> <span><tt>AccessibleContext</tt>上调用<tt>getAccessibleValue</tt>方法时,任何支持数值的对象都应该返回实现此接口的对象。</span> </li>
</ul>
<h3> <span><a name="AccessibleRole"></a> <a href="AccessibleRole.html">Class AccessibleRole</a></span> </h3>
<span>该类将Accessible对象的角色封装在用户界面中并通过在<tt>AccessibleContext</tt>上调用<tt>getAccessibleRole</tt>方法<a href="#AccessibleContext">获得</a></span>
<span>可访问的角色包括“复选框”,“菜单项”,“面板”等。这些角色由此类中的<tt>常量</tt> (如<tt>AccessibleRole.CHECK_BOX, AccessibleRole.MENU_ITEM,</tt><tt>AccessibleRole.PANEL标识</tt></span>
<span>这个类中的常量表现出强类型的常见对象角色枚举。</span>
<span>这个类的公共构造函数被有意地省略,应用程序应该使用这个类的一个常量。</span>
<span>虽然这个类预定义了大量的标准角色列表,但是它是可扩展的,因此在将来可以添加额外的程序员定义的角色,而不需要修改基类。</span>
<h3> <span><a name="AccessibleState"></a> <a href="AccessibleState.html">Class AccessibleState</a></span> </h3>
<span>该类封装了Accessible对象的特定状态。</span>
<span>可访问的状态包括“武装”,“忙”,“检查”,“聚焦”等等。这些角色由此类中的<tt>常量标识</tt> ,如<tt>AccessibleState.ARMED, AccessibleState.BUSY, AccessibleState.CHECKED,</tt><tt>AccessibleState.FOCUSED</tt></span>
<span>可访问对象的所有状态的总和称为<a href="#AccessibleStateSet">AccessibleStateSet</a> ,可以通过在<tt>AccessibleContext</tt>上调用<tt>getAccessibleStateSet</tt>方法<a href="#AccessibleContext">获得</a></span>
<p> <span>这个类中的常量表现出强类型的常见对象角色枚举。</span> <span>这个类的公共构造函数被有意地省略,应用程序应该使用这个类的一个常量。</span> <span>虽然这个类预先定义了大量的标准角色,但是它是可扩展的,所以在将来可以添加额外的程序员定义的角色,而不需要修改基类。</span> </p>
<h3> <span><a name="AccessibleStateSet"></a> <a href="AccessibleStateSet.html">Class AccessibleStateSet</a></span> </h3>
<span>该类封装了Accessible对象的状态集合并通过在<tt>AccessibleContext</tt>上调用<tt>getAccessibleStateSet</tt>方法<a href="#AccessibleContext">获得</a></span>
<span>由于对象可能具有多个状态(例如,它可能都是“检查”和“聚焦”),因此需要封装这些状态的集合。</span>
<span>该类中的方法提供在状态集上检索<a href="#AccessibleState">个人AccessibleStates</a></span>
<h3> <span><a name="AccessibleBundle"></a> <a href="AccessibleBundle.html">Class AccessibleBundle</a></span> </h3>
<span>此类用于维护强类型枚举。</span>
<span>它是<a href="#AccessibleRole">AccessibleRole</a><a href="#AccessibleState">AccessibleState</a>类的超级类。</span>
<span>程序员通常不会直接与这个类交互,而是使用<a href="#AccessibleRole">AccessibleRole</a><a href="#AccessibleState">AccessibleState</a>类。</span>
<h3> <span><a name="AccessibleAction"></a> <a href="AccessibleAction.html">Interface AccessibleAction</a></span> </h3>
<span>所述<a href="AccessibleAction.html">AccessibleAction</a>接口应该由能够执行一个或多个动作的任何对象的支持。</span>
<span>该界面提供了辅助技术的标准机制,以确定哪些操作以及告诉对象执行这些操作。</span>
<span>任何可以被操纵的对象都应该支持这个接口。</span>
<p> <span>应用程序可以通过首先获得其<a href="#AccessibleContext">AccessibleContext</a> (参见<a href="#Accessible">Accessible</a> ),然后调用<tt>AccessibleContext的getAccessibleAction</tt>方法来<a href="#AccessibleContext">确定</a>对象是否支持AccessibleAction <a href="#AccessibleContext">接口</a></span> <span>如果返回值不为空,则该对象支持该接口。</span> </p>
<h3> <span><a name="AccessibleComponent"></a> <a href="AccessibleComponent.html">Interface AccessibleComponent</a></span> </h3>
<span>应该在屏幕上呈现的任何对象<a href="AccessibleComponent.html">支持</a> AccessibleComponent界面。</span>
<span>该界面提供了辅助技术的标准机制来确定和设置对象的图形表示。</span>
<p> <span>应用程序可以通过首先获取其<a href="#AccessibleContext">AccessibleContext</a> (参见<a href="#Accessible">Accessible</a> ),然后调用<tt>AccessibleContext的getAccessibleComponent</tt>方法来<a href="#AccessibleContext">确定</a>对象是否支持AccessibleComponent <a href="#AccessibleContext">接口</a></span> <span>如果返回值不为空,则该对象支持该接口。</span> </p>
<h3> <span><a name="AccessibleSelection"></a> <a href="AccessibleSelection.html">Interface AccessibleSelection</a></span> </h3>
<span><a href="AccessibleSelection.html">AccessibleSelection</a>接口提供辅助技术的标准机制,以确定当前所选择的孩子是什么,以及修改选择集。</span>
<span>具有可以选择的子项的任何对象都应该支持AccessibleSelection接口。</span>
<p> <span>应用程序可以通过首先获得其<a href="#AccessibleContext">AccessibleContext</a> (参见<a href="#Accessible">Accessible</a> ),然后调用<tt>88471235388641的getAccessibleSelection</tt>方法来<a href="#AccessibleContext">确定</a>对象是否支持AccessibleSelection <a href="#AccessibleContext">接口</a></span> <span>如果返回值不为空,则该对象支持该接口。</span> </p>
<h3> <span><a name="AccessibleText"></a> <a href="AccessibleText.html">Interface AccessibleText</a></span> </h3>
<span>界面<a href="AccessibleText.html">AccessibleText</a>是制作丰富,可编辑的文字的合同。</span>
<span>并非所有显示在屏幕上的文字都是丰富且可编辑的(例如,包含在按钮,标签,菜单等中的文本,用户不期望操作)。</span>
<span>然而包含可编辑文本的对象必须实现AccessibleText接口如果它们与辅助技术进行互操作。</span>
<p> <span>该界面提供了在像素坐标和给定像素坐标处的文本之间进行的支持,用于在文本中的给定位置之前,之前或之后检索字母,单词和句子。</span> <span>该界面提供支持在文本中的给定位置(字体,字体大小,样式等)检索字符的属性,以及获取所选文本(如果有),文本长度和文字插入符的位置。</span> </p>
<p> <span>应用程序可以首先获取其<a href="#AccessibleContext">AccessibleContext</a> (参见<a href="#Accessible">Accessible</a> ),然后调用<tt>getAccessibleText的getAccessibleText</tt>方法来<a href="#AccessibleContext">确定</a>对象是否支持AccessibleText <a href="#AccessibleContext">接口</a></span> <span>如果返回值不为空,则该对象支持该接口。</span> </p>
<h3> <span><a name="AccessibleHypertext"></a> <a href="AccessibleHypertext.html">Interface AccessibleHypertext</a></span> </h3>
<span>所述<a href="AccessibleHypertext.html">AccessibleHypertext</a>接口应该由呈现在显示器上的超文本信息的任何对象得到支持。</span>
<span>该界面提供了辅助技术通过其内容,属性和空间位置访问该文本的标准机制。</span>
<span>它还提供了操纵<a href="#AccessibleHyperlink">hyperlinks的</a>标准<a href="#AccessibleHyperlink">机制</a></span>
<span>应用程序可以通过首先获取其<a href="#AccessibleContext">AccessibleContext</a> (参见<a href="#Accessible">Accessible</a> 然后调用AccessibleContext的AccessibleContext.getAccessibleText方法来<a href="#AccessibleContext">确定</a>对象是否支持AccessibleHypertext <a href="#AccessibleContext">接口</a></span>
<span>如果返回值是扩展AccessibleHypertext的类则该对象支持AccessibleHypertext。</span>
<h3> <span><a name="AccessibleHyperlink"></a> <a href="AccessibleHyperlink.html">Interface AccessibleHyperlink</a></span> </h3>
<span>超链接的对象应该支持<a href="AccessibleHyperlink.html">AccessibleHyperlink</a>接口。</span>
<span>将通过在<a href="#AccessibleHypertext">AccessibleHypertext</a>对象上调用getLink方法来返回实现此<a href="#AccessibleHypertext">接口的</a>对象。</span>
<h3> <span><a name="AccessibleValue"></a> <a href="AccessibleValue.html">Interface AccessibleValue</a></span> </h3>
<span><a href="AccessibleValue.html">AccessibleValue</a>接口应该由支持数值的任何对象(例如滚动条)支持。</span>
<span>该界面提供了辅助技术的标准机制,用于确定和设置数值以及获取最小值和最大值。</span>
<p> <span>应用程序可以通过首先获取其<a href="#AccessibleContext">AccessibleContext</a> (参见<a href="#Accessible">Accessible</a> ),然后调用<tt>AccessibleContext的getAccessibleValue</tt>方法来<a href="#AccessibleContext">确定</a>对象是否支持AccessibleValue <a href="#AccessibleContext">接口</a></span> <span>如果返回值不为空,则该对象支持该接口。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.2
</dd>
</dl>
</div>