javax.accessibility

接口
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 - 支持数字值的对象。此接口为辅助技术提供了标准机制,以确定和设置对象的当前值,以及最小值和最大值。任何支持数字值的对象都应支持此接口。


字段摘要
static String ACCESSIBLE_ACTION_PROPERTY
          用于指示支持的动作集已更改的常量。
static String ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY
          用于确定组件的活动子级已更改的常量。
static String ACCESSIBLE_CARET_PROPERTY
          用于确定 accessibleText 插入符已更改的常量。
static String ACCESSIBLE_CHILD_PROPERTY
          用于确定何时向对象添加或从对象移除 Accessible 子级的常量。
static String ACCESSIBLE_COMPONENT_BOUNDS_CHANGED
          指示组件边界已更改的 PropertyChangeEvent。
static String ACCESSIBLE_DESCRIPTION_PROPERTY
          用于确定 accessibleDescription 属性已更改的常量。
static String ACCESSIBLE_HYPERTEXT_OFFSET
          用于指示超文本元素已收到焦点的常量。
static String ACCESSIBLE_INVALIDATE_CHILDREN
          指示某个组件(例如树或文本)的子级已发生重要更改的 PropertyChangeEvent。
static String ACCESSIBLE_NAME_PROPERTY
          用于确定 accessibleName 属性已更改的常量。
static String ACCESSIBLE_SELECTION_PROPERTY
          用于确定 accessibleSelection 已更改的常量。
static String ACCESSIBLE_STATE_PROPERTY
          用于确定 accessibleStateSet 属性已更改的常量。
static String ACCESSIBLE_TABLE_CAPTION_CHANGED
          用于指示表标题已更改的常量。
static String ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED
          用于指示列描述已更改的常量。
static String ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED
          用于指示列标题已更改的常量。
static String ACCESSIBLE_TABLE_MODEL_CHANGED
          用于指示表数据已更改的常量。
static String ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED
          用于指示行描述已更改的常量。
static String ACCESSIBLE_TABLE_ROW_HEADER_CHANGED
          用于指示行标题已更改的常量。
static String ACCESSIBLE_TABLE_SUMMARY_CHANGED
          用于指示表摘要已更改的常量。
static String ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED
          指示文本属性已更改的 PropertyChangeEvent。
static String ACCESSIBLE_TEXT_PROPERTY
          指示文本已更改的 PropertyChangeEvent。
static String ACCESSIBLE_VALUE_PROPERTY
          用于确定 accessibleValue 属性已更改的常量。
static String ACCESSIBLE_VISIBLE_DATA_PROPERTY
          用于确定对象的可见外观已更改的常量。
protected  String accessibleDescription
          包含对象描述的本地化 String。
protected  String accessibleName
          包含对象名称的本地化 String。
protected  Accessible accessibleParent
          此对象的可访问父级。
 
构造方法摘要
AccessibleContext()
           
 
方法摘要
 void addPropertyChangeListener(PropertyChangeListener listener)
          将 PropertyChangeListener 添加到侦听器列表。
 void firePropertyChange(String propertyName, Object oldValue, Object newValue)
          对报告 bound 属性更改的支持。
 AccessibleAction getAccessibleAction()
          获取与此对象关联的可支持一个或多个动作的 AccessibleAction。
abstract  Accessible getAccessibleChild(int i)
          返回该对象的指定 Accessible 子级。
abstract  int getAccessibleChildrenCount()
          返回该对象的可访问子级数。
 AccessibleComponent getAccessibleComponent()
          获取与此对象关联的 AccessibleComponent,它具有图形表示形式。
 String getAccessibleDescription()
          获取此对象的 accessibleDescription 属性。
 AccessibleEditableText getAccessibleEditableText()
          获取与在显示器上显示可编辑文本的此对象关联的 AccessibleEditableText。
 AccessibleIcon[] getAccessibleIcon()
          获取与此对象关联的具有一个或多个相关图标的 AccessibleIcons
abstract  int getAccessibleIndexInParent()
          获取此对象在其可访问父级中的基于零的索引。
 String getAccessibleName()
          获取此对象的 accessibleName 属性。
 Accessible getAccessibleParent()
          获取此对象的 Accessible 父对象。
 AccessibleRelationSet getAccessibleRelationSet()
          获取与某个对象关联的 AccessibleRelationSet
abstract  AccessibleRole getAccessibleRole()
          获取此对象的职责。
 AccessibleSelection getAccessibleSelection()
          获取与此对象关联的 AccessibleSelection,该对象允许选择其 Accessible 子级。
abstract  AccessibleStateSet getAccessibleStateSet()
          获取此对象的状态集合。
 AccessibleTable getAccessibleTable()
          获取与某个对象关联的 AccessibleTable
 AccessibleText getAccessibleText()
          获取与在显示器上显示文本的此对象关联的 AccessibleText。
 AccessibleValue getAccessibleValue()
          获取与此对象关联的支持 Numerical 值的 AccessibleValue。
abstract  Locale getLocale()
          获取该组件的语言环境。
 void removePropertyChangeListener(PropertyChangeListener listener)
          从侦听器列表移除 PropertyChangeListener。
 void setAccessibleDescription(String s)
          设置此对象的可访问描述。
 void setAccessibleName(String s)
          设置此对象的可访问的本地化名称。
 void setAccessibleParent(Accessible a)
          设置此对象的 Accessible 父对象。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

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 的实例
另请参见: