javax.accessibility
类 AccessibleContext

java.lang.Object
  javax.accessibility.AccessibleContext

直接已知子类：

Component.AccessibleAWTComponent, ImageIcon.AccessibleImageIcon, JList.AccessibleJList.AccessibleJListChild, JTable.AccessibleJTable.AccessibleJTableCell, JTableHeader.AccessibleJTableHeader.AccessibleJTableHeaderEntry, JTree.AccessibleJTree.AccessibleJTreeNode, MenuComponent.AccessibleAWTMenuComponent, ProgressMonitor.AccessibleProgressMonitor

public abstract class AccessibleContext
extends Object

AccessibleContext 表示所有可访问对象返回的最少信息。此信息包括对象的可访问名称、描述、职责和状态，以及关于其父对象和子对象的信息。AccessibleContext 还包含用于获取更多关于组件的特定可访问信息的方法。如果组件支持这些方法，则它们将返回实现以下一个或多个接口的对象：

• AccessibleAction － 可以执行一个或多个动作的对象。此接口为辅助技术提供了标准机制，以确定这些动作并通知对象执行它们。任何可以操作的对象都应支持此接口。
• AccessibleComponent － 具有图形表示形式的对象。此接口为辅助技术提供了标准机制，以确定和设置对象的图形表示形式。屏幕上呈现的任何对象都应该支持此接口。
• AccessibleSelection － 允许选择其子对象的对象。此接口为辅助技术提供了标准机制，以确定当前选定的子对象，并修改选择设置。任何具有可选子对象的对象都应支持此接口。
• AccessibleText － 在显示器上显示可编辑文本信息的对象。此接口为辅助技术提供了标准机制，以通过文本的内容、属性和空间位置来访问该文本。任何包含可编辑文本的对象都应支持此接口。
• AccessibleValue － 支持数字值的对象。此接口为辅助技术提供了标准机制，以确定和设置对象的当前值，以及最小值和最大值。任何支持数字值的对象都应支持此接口。

ACCESSIBLE_NAME_PROPERTY

public static final String ACCESSIBLE_NAME_PROPERTY

用于确定 accessibleName 属性已更改的常量。PropertyChangeEvent 中原有的值将为原有的 accessibleName，新值将为新的 accessibleName。

另请参见：

getAccessibleName(), addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_DESCRIPTION_PROPERTY

public static final String ACCESSIBLE_DESCRIPTION_PROPERTY

用于确定 accessibleDescription 属性已更改的常量。PropertyChangeEvent 中原有的值将为原有的 accessibleDescription，新值将为新的 accessibleDescription。

另请参见：

getAccessibleDescription(), addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_STATE_PROPERTY

public static final String ACCESSIBLE_STATE_PROPERTY

用于确定 accessibleStateSet 属性已更改的常量。accessibleStateSet 中原有值将为原有的 AccessibleState，新值将为新的 AccessibleState。例如，如果支持垂直和水平状态的某组件从垂直方向更改为水平方向，则原有值将为 AccessibleState.VERTICAL，新值将为 AccessibleState.HORIZONTAL。请注意这两个值也可以为 null。例如，当某组件从启用状态更改为禁用状态，则原有值将为 AccessibleState.ENABLED，新值将为 null。

另请参见：

getAccessibleStateSet(), AccessibleState, AccessibleStateSet, addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_VALUE_PROPERTY

public static final String ACCESSIBLE_VALUE_PROPERTY

用于确定 accessibleValue 属性已更改的常量。PropertyChangeEvent 中原有的值将为表示原有值的 Number，新值将为表示新值的 Number

另请参见：

getAccessibleValue(), addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_SELECTION_PROPERTY

public static final String ACCESSIBLE_SELECTION_PROPERTY

用于确定 accessibleSelection 已更改的常量。当前保留 PropertyChangeEvent 中的原有值和新值，供将来使用。

另请参见：

getAccessibleSelection(), addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_CARET_PROPERTY

public static final String ACCESSIBLE_CARET_PROPERTY

用于确定 accessibleText 插入符已更改的常量。PropertyChangeEvent 中的原有值将为表示原有插入符位置的整数，新值将为表示新的/当前插入符位置的整数。

另请参见：

addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_VISIBLE_DATA_PROPERTY

public static final String ACCESSIBLE_VISIBLE_DATA_PROPERTY

用于确定对象的可见外观已更改的常量。当前保留 PropertyChangeEvent 中的原有值和新值，供将来使用。

另请参见：

addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_CHILD_PROPERTY

public static final String ACCESSIBLE_CHILD_PROPERTY

用于确定何时向对象添加或从对象移除 Accessible 子级的常量。如果要添加 Accessible 子级，则原有值将为 null，新值将为 Accessible 子级。如果要移除 Accessible 子级，则原有值将为 Accessible 子级，新值将为 null。

另请参见：

addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY

public static final String ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY

用于确定组件的活动子级已更改的常量。活动的子级用于列表、树和表这样的对象，这些对象可能有临时子级。当活动子级已更改时，属性更改事件的原有值将为表示以前活动子级的 Accessible，新值将为表示当前活动子级的 Accessible。

另请参见：

addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

ACCESSIBLE_TABLE_CAPTION_CHANGED

public static final String ACCESSIBLE_TABLE_CAPTION_CHANGED

用于指示表标题已更改的常量。PropertyChangeEvent 中的原有值将为表示以前表标题的 Accessible，新值将为表示新表标题的 Accessible。

另请参见：

Accessible, AccessibleTable, 常量字段值

ACCESSIBLE_TABLE_SUMMARY_CHANGED

public static final String ACCESSIBLE_TABLE_SUMMARY_CHANGED

用于指示表摘要已更改的常量。PropertyChangeEvent 中的原有值将为表示以前表摘要的 Accessible，新值将为表示新表摘要的 Accessible。

另请参见：

Accessible, AccessibleTable, 常量字段值

ACCESSIBLE_TABLE_MODEL_CHANGED

public static final String ACCESSIBLE_TABLE_MODEL_CHANGED

用于指示表数据已更改的常量。PropertyChangeEvent 中的原有值将为 null，新值将为表示表更改的 AccessibleTableModelChange。

另请参见：

AccessibleTable, AccessibleTableModelChange, 常量字段值

ACCESSIBLE_TABLE_ROW_HEADER_CHANGED

public static final String ACCESSIBLE_TABLE_ROW_HEADER_CHANGED

用于指示行标题已更改的常量。PropertyChangeEvent 中的原有值将为 null，新值将为表示标题更改的 AccessibleTableModelChange。

另请参见：

AccessibleTable, AccessibleTableModelChange, 常量字段值

ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED

public static final String ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED

用于指示行描述已更改的常量。PropertyChangeEvent 中的原有值将为 null，新值将为表示行索引的 Integer。

另请参见：

AccessibleTable, 常量字段值

ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED

public static final String ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED

用于指示列标题已更改的常量。PropertyChangeEvent 中的原有值将为 null，新值将为表示标题更改的 AccessibleTableModelChange。

另请参见：

AccessibleTable, AccessibleTableModelChange, 常量字段值

ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED

public static final String ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED

用于指示列描述已更改的常量。PropertyChangeEvent 中的原有值将为 null，新值将为表示列索引的 Integer。

另请参见：

AccessibleTable, 常量字段值

ACCESSIBLE_ACTION_PROPERTY

public static final String ACCESSIBLE_ACTION_PROPERTY

用于指示支持的动作集已更改的常量。PropertyChangeEvent 中的原有值将为表示所支持的原有动作数的 Integer，新值将为表示所支持的新动作数的 Integer。

另请参见：

AccessibleAction, 常量字段值

ACCESSIBLE_HYPERTEXT_OFFSET

public static final String ACCESSIBLE_HYPERTEXT_OFFSET

用于指示超文本元素已收到焦点的常量。PropertyChangeEvent 中的原有值将为表示以前具有焦点的元素在文档中的起始索引的 Integer，新值将为表示当前具有焦点的元素在文档中的起始索引的 Integer。值 -1 指示该元素现在不具有焦点或以前不具有焦点。

另请参见：

AccessibleHyperlink, 常量字段值

ACCESSIBLE_TEXT_PROPERTY

public static final String ACCESSIBLE_TEXT_PROPERTY

指示文本已更改的 PropertyChangeEvent。
对于文本插入来说，oldValue 为 null，newValue 为指定所插入文本的 AccessibleTextSequence。
对于文本删除来说，oldValue 为指定所删除文本的 AccessibleTextSequence，newValue 为 null。
对于文本替换来说，oldValue 为指定原有文本的 AccessibleTextSequence，newValue 为指定新文本的 AccessibleTextSequence。

另请参见：

getAccessibleText(), addPropertyChangeListener(java.beans.PropertyChangeListener), #AccessibleText.AccessibleTextSequence, 常量字段值

ACCESSIBLE_INVALIDATE_CHILDREN

public static final String ACCESSIBLE_INVALIDATE_CHILDREN

指示某个组件（例如树或文本）的子级已发生重要更改的 PropertyChangeEvent。此更改通知事件侦听器，需要重新获取子组件的状态。oldValue 为 null，newValue 为其子级已无效的组件。

从以下版本开始：

1.5

另请参见：

getAccessibleText(), addPropertyChangeListener(java.beans.PropertyChangeListener), #AccessibleText.AccessibleTextSequence, 常量字段值

ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED

public static final String ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED

指示文本属性已更改的 PropertyChangeEvent。
对于属性插入来说，oldValue 为 null，newValue 为指定所插入属性的 AccessibleAttributeSequence。
对于属性删除来说，oldValue 为指定所删除属性的 AccessibleAttributeSequence，newValue 为 null。
对于属性替换来说，oldValue 为指定原有属性的 AccessibleAttributeSequence，newValue 为指定新属性的 AccessibleAttributeSequence。

从以下版本开始：

1.5

另请参见：

getAccessibleText(), addPropertyChangeListener(java.beans.PropertyChangeListener), #AccessibleText.AccessibleAttributeSequence, 常量字段值

ACCESSIBLE_COMPONENT_BOUNDS_CHANGED

public static final String ACCESSIBLE_COMPONENT_BOUNDS_CHANGED

指示组件边界已更改的 PropertyChangeEvent。oldValue 为原有组件的边界，newValue 为新组件的界限。

从以下版本开始：

1.5

另请参见：

addPropertyChangeListener(java.beans.PropertyChangeListener), 常量字段值

accessibleParent

protected Accessible accessibleParent

此对象的可访问父级。

另请参见：

getAccessibleParent(), setAccessibleParent(javax.accessibility.Accessible)

accessibleName

protected String accessibleName

包含对象名称的本地化 String。

另请参见：

getAccessibleName(), setAccessibleName(java.lang.String)

accessibleDescription

protected String accessibleDescription

包含对象描述的本地化 String。

另请参见：

getAccessibleDescription(), setAccessibleDescription(java.lang.String)

AccessibleContext

public AccessibleContext()

getAccessibleName

public String getAccessibleName()

获取此对象的 accessibleName 属性。对象的 accessibleName 属性是指定该对象功能的本地化 String。例如，标签和按钮的 accessibleName 属性可以是标签或按钮本身的文本。对于不显示其名称的对象，仍应设置 accessibleName。例如，对于用于输入城市名称的文本字段，在 en_US 语言环境下，accessibleName 可以为 "city"。

返回：

对象的本地化名称；如果此对象没有名称，则返回 null

另请参见：

setAccessibleName(java.lang.String)

setAccessibleName

public void setAccessibleName(String s)

设置此对象的可访问的本地化名称。更改名称将导致激发 ACCESSIBLE_NAME_PROPERTY 属性的 PropertyChangeEvent。

参数：

s - 对象的新本地化名称。

另请参见：

getAccessibleName(), addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleDescription

public String getAccessibleDescription()

获取此对象的 accessibleDescription 属性。此对象的 accessibleDescription 属性是描述该对象功能的本地化短语。例如，对于 "Cancel" 按钮，accessibleDescription 可以是 "Ignore changes and close dialog box"（忽略更改并关闭对话框）。

返回：

该对象的本地化描述；如果此对象没有描述，则返回 null

另请参见：

setAccessibleDescription(java.lang.String)

setAccessibleDescription

public void setAccessibleDescription(String s)

设置此对象的可访问描述。更改名称将导致激发 ACCESSIBLE_DESCRIPTION_PROPERTY 属性的 PropertyChangeEvent。

参数：

s - 此对象的新的本地化描述

另请参见：

setAccessibleName(java.lang.String), addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleRole

public abstract AccessibleRole getAccessibleRole()

获取此对象的职责。对象的职责是此对象的类的一般功能或用途。例如，push 按钮的职责是 AccessibleRole.PUSH_BUTTON。AccessibleRole 中提供了一些职责，组件开发人员可以从一组预定义职责中进行选择。这就使辅助技术能为各种交互的组件子类（例如，对所有充当按钮的组件使用 AccessibleRole.PUSH_BUTTON）以及区分行为各异的子类（例如，复选框 AccessibleRole.CHECK_BOX 和单选框 AccessibleRole.RADIO_BUTTON）提供一致的接口。

注意，AccessibleRole 类也是可扩展的，因此如果预定义的职责集合不充分，则自定义组件的开发人员可以定义他们自己的 AccessibleRole。

返回：

描述该对象职责的 AccessibleRole 实例

另请参见：

AccessibleRole

getAccessibleStateSet

public abstract AccessibleStateSet getAccessibleStateSet()

获取此对象的状态集合。对象的 AccessibleStateSet 由一组唯一的 AccessibleState 组成。对象的 AccessibleStateSet 中的更改将导致激发 ACCESSIBLE_STATE_PROPERTY 属性的 PropertyChangeEvent。

返回：

包含对象的当前状态集合的 AccessibleStateSet 的实例

另请参见：

AccessibleStateSet, AccessibleState, addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleParent

public Accessible getAccessibleParent()

获取此对象的 Accessible 父对象。

返回：

此对象的 Accessible 父对象；如果此对象没有 Accessible 父对象，则返回 null

setAccessibleParent

public void setAccessibleParent(Accessible a)

设置此对象的 Accessible 父对象。这意味着此方法仅用于以下情形：即不应将实际组件的父级视为组件的可访问父级，并且此方法只应由可访问子级的父级调用。

参数：

a - - 要设置为父级的 Accessible

getAccessibleIndexInParent

public abstract int getAccessibleIndexInParent()

获取此对象在其可访问父级中的基于零的索引。

返回：

返回此对象在父级中从零开始的索引；如果此对象没有可访问父级，则返回 -1。

另请参见：

getAccessibleParent(), getAccessibleChildrenCount(), getAccessibleChild(int)

getAccessibleChildrenCount

public abstract int getAccessibleChildrenCount()

返回该对象的可访问子级数。

返回：

该对象的可访问子级数。

getAccessibleChild

public abstract Accessible getAccessibleChild(int i)

返回该对象的指定 Accessible 子级。Accessible 对象的 Accessible 子级是从零开始的，因此 Accessible 对象的第一个子对象的索引为 0，第二个子对象的索引为 1，依此类推。

参数：

i - 子级从零开始的索引

返回：

对象的 Accessible 子级

另请参见：

getAccessibleChildrenCount()

getLocale

public abstract Locale getLocale()
                          throws IllegalComponentStateException

获取该组件的语言环境。如果该组件没有语言环境，则返回其父级的语言环境。

返回：

此组件的语言环境。如果此组件没有语言环境，则返回其父级的语言环境。

抛出：

IllegalComponentStateException - 如果该 Component 没有自己的语言环境，并且尚未被添加到可以从包含父级确定其语言环境的包含层次结构中。

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

将 PropertyChangeListener 添加到侦听器列表。此侦听器为所有 Accessible 属性注册，并且将在这些属性发生更改时调用。

参数：

listener - 要添加的 PropertyChangeListener

另请参见：

ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

从侦听器列表移除 PropertyChangeListener。此方法移除一个为所有属性注册的 PropertyChangeListener。

参数：

listener - 要移除的 PropertyChangeListener

getAccessibleAction

public AccessibleAction getAccessibleAction()

获取与此对象关联的可支持一个或多个动作的 AccessibleAction。

返回：

如果受对象支持，则返回 AccessibleAction；否则返回 null

另请参见：

AccessibleAction

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()

获取与此对象关联的 AccessibleComponent，它具有图形表示形式。

返回：

如果受对象支持，则返回 AccessibleComponent；否则返回 null

另请参见：

AccessibleComponent

getAccessibleSelection

public AccessibleSelection getAccessibleSelection()

获取与此对象关联的 AccessibleSelection，该对象允许选择其 Accessible 子级。

返回：

如果受对象支持，则返回 AccessibleSelection；否则返回 null

另请参见：

AccessibleSelection

getAccessibleText

public AccessibleText getAccessibleText()

获取与在显示器上显示文本的此对象关联的 AccessibleText。

返回：

如果受对象支持，则返回 AccessibleText；否则返回 null

另请参见：

AccessibleText

getAccessibleEditableText

public AccessibleEditableText getAccessibleEditableText()

获取与在显示器上显示可编辑文本的此对象关联的 AccessibleEditableText。

返回：

如果受对象支持，则返回 AccessibleEditableText；否则返回 null

从以下版本开始：

1.4

另请参见：

AccessibleEditableText

getAccessibleValue

public AccessibleValue getAccessibleValue()

获取与此对象关联的支持 Numerical 值的 AccessibleValue。

返回：

如果受对象支持，则返回 AccessibleValue；否则返回 null

另请参见：

AccessibleValue

getAccessibleIcon

public AccessibleIcon[] getAccessibleIcon()

获取与此对象关联的具有一个或多个相关图标的 AccessibleIcons

返回：

如果受对象支持，则返回一个 AccessibleIcon 数组；否则返回 null

从以下版本开始：

1.3

另请参见：

AccessibleIcon

getAccessibleRelationSet

public AccessibleRelationSet getAccessibleRelationSet()

获取与某个对象关联的 AccessibleRelationSet

返回：

如果受对象支持，则返回 AccessibleRelationSet；否则返回 null

从以下版本开始：

1.3

另请参见：

AccessibleRelationSet

getAccessibleTable

public AccessibleTable getAccessibleTable()

获取与某个对象关联的 AccessibleTable

返回：

如果受对象支持，则返回 AccessibleTable；否则返回 null

从以下版本开始：

1.3

另请参见：

AccessibleTable

firePropertyChange

public void firePropertyChange(String propertyName,
                               Object oldValue,
                               Object newValue)

对报告 bound 属性更改的支持。如果 oldValue 和 newValue 不相等，且 PropertyChangeEvent 侦听器列表不为空，则对每个侦听器激发一个 PropertyChange 事件。通常，这由 Accessible 对象自己使用，而不应由应用程序调用。

参数：

propertyName - 已更改的属性的计划名称。

oldValue - 属性的原有值。

newValue - 属性的新值。

另请参见：

PropertyChangeSupport, addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY

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