- 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,Translator
@JavaBean(description="Minimal information that all accessible objects return") public abstract class AccessibleContext extends Object
AccessibleContext表示所有可访问对象返回的最小信息。 此信息包括对象的可访问名称,描述,角色和状态,以及有关其父级和子级的信息。AccessibleContext还包含用于获取关于组件的更具体的可访问性信息的方法。 如果组件支持它们,则这些方法将返回实现以下一个或多个接口的对象:-
AccessibleAction- 对象可以执行一个或多个操作。 此接口为辅助技术提供标准机制,以确定这些操作是什么,并告诉对象执行它们。 任何可以操作的对象都应该支持这个接口。 -
AccessibleComponent- 该对象具有图形表示。 该接口为辅助技术提供标准机制,以确定和设置对象的图形表示。 屏幕上呈现的任何对象都应支持此接口。 -
AccessibleSelection- 该对象允许选择其子项。 此接口为辅助技术提供标准机制,以确定对象的当前所选子项以及修改其选择集。 具有可以选择的子项的任何对象都应支持此接口。 -
AccessibleText- 该对象在显示屏上显示可编辑的文本信息。 此接口为辅助技术提供标准机制,以通过其内容,属性和空间位置访问该文本。 包含可编辑文本的任何对象都应支持此接口。 -
AccessibleValue- 该对象支持数值。 该接口为辅助技术提供标准机制,以确定和设置对象的当前值,以及获取其最小值和最大值。 任何支持数值的对象都应支持此接口。
-
-
字段汇总
-
构造方法摘要
构造方法 构造器 描述 AccessibleContext()
-
方法摘要
所有方法 实例方法 抽象方法 具体的方法 变量和类型 方法 描述 voidaddPropertyChangeListener(PropertyChangeListener listener)将PropertyChangeListener添加到侦听器列表中。voidfirePropertyChange(String propertyName, Object oldValue, Object newValue)支持报告绑定的属性更改。AccessibleActiongetAccessibleAction()获取与此对象关联的AccessibleAction,该对象支持一个或多个操作。abstract AccessiblegetAccessibleChild(int i)返回对象的指定Accessible子级。abstract intgetAccessibleChildrenCount()返回对象的可访问子级数。AccessibleComponentgetAccessibleComponent()获取与此对象关联的AccessibleComponent,该对象具有图形表示。StringgetAccessibleDescription()获取此对象的accessibleDescription属性。AccessibleEditableTextgetAccessibleEditableText()获取与此对象关联的AccessibleEditableText,在显示屏上显示可编辑文本。AccessibleIcon[]getAccessibleIcon()获取与具有一个或多个关联图标的对象关联的AccessibleIcons。abstract intgetAccessibleIndexInParent()获取此对象在其可访问父级中的从0开始的索引。StringgetAccessibleName()获取此对象的accessibleName属性。AccessiblegetAccessibleParent()获取此对象的父级的Accessible。AccessibleRelationSetgetAccessibleRelationSet()获取与对象关联的AccessibleRelationSet。abstract AccessibleRolegetAccessibleRole()获取此对象的角色。AccessibleSelectiongetAccessibleSelection()获取与此对象关联的AccessibleSelection,该对象允许选择其Accessible对象。abstract AccessibleStateSetgetAccessibleStateSet()获取此对象的状态集。AccessibleTablegetAccessibleTable()获取与对象关联的AccessibleTable。AccessibleTextgetAccessibleText()获取与此对象关联的AccessibleText,在显示屏上显示文本。AccessibleValuegetAccessibleValue()获取与此对象关联的AccessibleValue,该对象支持Numerical值。abstract LocalegetLocale()获取组件的语言环境。voidremovePropertyChangeListener(PropertyChangeListener listener)从侦听器列表中删除PropertyChangeListener。voidsetAccessibleDescription(String s)设置此对象的可访问描述。voidsetAccessibleName(String s)设置此对象的本地化可访问名称。voidsetAccessibleParent(Accessible a)设置此对象的Accessible父级。
-
-
-
字段详细信息
-
ACCESSIBLE_NAME_PROPERTY
public static final String ACCESSIBLE_NAME_PROPERTY
用于确定accessibleName属性何时更改的常量 。PropertyChangeEvent的旧值将是旧的accessibleName,新值将是新的accessibleName。
-
ACCESSIBLE_DESCRIPTION_PROPERTY
public static final String ACCESSIBLE_DESCRIPTION_PROPERTY
用于确定accessibleDescription属性何时更改的常量 。PropertyChangeEvent的旧值将是旧的accessibleDescription,新值将是新的accessibleDescription。
-
ACCESSIBLE_STATE_PROPERTY
public static final String ACCESSIBLE_STATE_PROPERTY
用于确定accessibleStateSet属性何时更改的accessibleStateSet。 旧值将是老AccessibleState,新值将是新AccessibleState在accessibleStateSet。 例如,如果支持垂直和水平状态的组件将其方向从垂直更改为水平,则旧值将为AccessibleState.VERTICAL,新值将为AccessibleState.HORIZONTAL。 请注意,任何一个值也可以是null。 例如,当组件从启用更改为禁用时,旧值将为AccessibleState.ENABLED,新值将为null。
-
ACCESSIBLE_VALUE_PROPERTY
public static final String ACCESSIBLE_VALUE_PROPERTY
用于确定accessibleValue属性何时更改的accessibleValue。PropertyChangeEvent的旧值将是表示旧值的Number,而新值将是表示新值的Number。
-
ACCESSIBLE_SELECTION_PROPERTY
public static final String ACCESSIBLE_SELECTION_PROPERTY
用于确定accessibleSelection更改的accessibleSelection。PropertyChangeEvent中的旧值和新值目前保留供将来使用。
-
ACCESSIBLE_CARET_PROPERTY
public static final String ACCESSIBLE_CARET_PROPERTY
用于确定accessibleText插入符号何时更改的accessibleText。PropertyChangeEvent的旧值将是表示旧插入符位置的整数,新值将是表示新/当前插入符号位置的整数。
-
ACCESSIBLE_VISIBLE_DATA_PROPERTY
public static final String ACCESSIBLE_VISIBLE_DATA_PROPERTY
常量用于确定对象的可视外观何时发生更改。PropertyChangeEvent中的旧值和新值目前保留供将来使用。
-
ACCESSIBLE_CHILD_PROPERTY
public static final String ACCESSIBLE_CHILD_PROPERTY
常量用于确定何时从对象添加/删除Accessible子项。 如果要添加Accessible子项,则旧值将为null,新值将为Accessible子项。 如果正在删除Accessible子项,则旧值将为Accessible子项,新值将为null。
-
ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY
public static final String ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY
用于确定组件的活动后代何时更改的常量。 活动后代用于列表,树和表等对象,这些对象可能包含瞬态子对象。 当活动后代发生更改时,属性更改事件的旧值将是表示上一个活动子项的Accessible,新值将是表示当前活动子项的Accessible。
-
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指定新的文本。
-
ACCESSIBLE_INVALIDATE_CHILDREN
public static final String ACCESSIBLE_INVALIDATE_CHILDREN
PropertyChangeEvent,表示组件(如树或文本)的子项发生了重大更改。 此更改通知事件侦听器它需要重新获取子组件的状态。 该oldValue为null和newValue是他们的孩子已经变得无效的组件。- 从以下版本开始:
- 1.5
- 另请参见:
-
getAccessibleText(),addPropertyChangeListener(java.beans.PropertyChangeListener),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),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
此对象的可访问父级。
-
accessibleName
protected String accessibleName
包含对象名称的本地化String。
-
accessibleDescription
protected String accessibleDescription
包含对象描述的本地化String。
-
-
方法详细信息
-
getAccessibleName
public String getAccessibleName()
获取此对象的accessibleName属性。 对象的accessibleName属性是本地化的String,用于指定对象的用途。 例如,标签或按钮的accessibleName属性可能是标签或按钮本身的文本。 如果对象不显示其名称,则accessibleName设置accessibleName。 例如,在文本字段的情况下,用于输入城市名称,accessibleName为en_US的语言环境可以为“city”。- 结果
-
对象的本地化名称;
null如果此对象没有名称 - 另请参见:
-
setAccessibleName(java.lang.String)
-
setAccessibleName
@BeanProperty(preferred=true, description="Sets the accessible name for the component.") public void setAccessibleName(String s)
设置此对象的本地化可访问名称。 更改名称将导致PropertyChangeEvent为被解雇ACCESSIBLE_NAME_PROPERTY财产。- 参数
-
s- 对象的新本地化名称 - 另请参见:
-
getAccessibleName(),addPropertyChangeListener(java.beans.PropertyChangeListener)
-
getAccessibleDescription
public String getAccessibleDescription()
获取此对象的accessibleDescription属性。 此对象的accessibleDescription属性是一个描述对象用途的简短本地化短语。 例如,在“取消”按钮的情况下,accessibleDescription可能是“忽略更改并关闭对话框”。- 结果
-
对象的本地化描述;
null如果此对象没有描述 - 另请参见:
-
setAccessibleDescription(java.lang.String)
-
setAccessibleDescription
@BeanProperty(preferred=true, description="Sets the accessible description for the component.") public void setAccessibleDescription(String s)
设置此对象的可访问描述。 更改名称将导致PropertyChangeEvent为被解雇ACCESSIBLE_DESCRIPTION_PROPERTY财产。- 参数
-
s- 对象的新本地化描述 - 另请参见:
-
setAccessibleName(java.lang.String),addPropertyChangeListener(java.beans.PropertyChangeListener)
-
getAccessibleRole
public abstract AccessibleRole getAccessibleRole()
获取此对象的角色。 对象的作用是此对象的类的通用目的或用途。 例如,按钮的作用是AccessibleRole.PUSH_BUTTON。 提供了AccessibleRole中的角色,以便组件开发人员可以从一组预定义角色中进行选择。 这使得辅助技术能够为各种调整的组件子类提供一致的接口(例如,对于像按钮一样使用的所有组件使用AccessibleRole.PUSH_BUTTON)以及区分行为不同的子类(例如,AccessibleRole.CHECK_BOX为AccessibleRole.RADIO_BUTTON,无线电为AccessibleRole.RADIO_BUTTON纽扣)。请注意,
AccessibleRole类也是可扩展的,因此如果预定义角色集AccessibleRole,自定义组件开发人员可以定义自己的AccessibleRole。- 结果
-
描述对象角色的
AccessibleRole的实例 - 另请参见:
-
AccessibleRole
-
getAccessibleStateSet
public abstract AccessibleStateSet getAccessibleStateSet()
获取此对象的状态集。AccessibleStateSet的一个对象由一组独特的AccessibleStates。 对象的AccessibleStateSet发生更改将导致PropertyChangeEvent针对ACCESSIBLE_STATE_PROPERTY属性触发。- 结果
-
AccessibleStateSet的实例,包含对象的当前状态集 - 另请参见:
-
AccessibleStateSet,AccessibleState,addPropertyChangeListener(java.beans.PropertyChangeListener)
-
getAccessibleParent
public Accessible getAccessibleParent()
获取此对象的父级Accessible。- 结果
-
Accessible此对象的父级;null如果此对象没有Accessible父级
-
setAccessibleParent
public void setAccessibleParent(Accessible a)
设置此对象的父级的Accessible。 这仅适用于实际组件的父级不应被视为组件的可访问父级的情况,并且是仅应由可访问子级的父级调用的方法。- 参数
-
a- -Accessible设置为父级
-
getAccessibleIndexInParent
public abstract int getAccessibleIndexInParent()
获取此对象在其可访问父级中的从0开始的索引。- 结果
- 该对象在其父对象中的从0开始的索引; -1如果此对象没有可访问的父对象。
- 另请参见:
-
getAccessibleParent(),getAccessibleChildrenCount(),getAccessibleChild(int)
-
getAccessibleChildrenCount
public abstract int getAccessibleChildrenCount()
返回对象的可访问子级数。- 结果
- 对象的可访问子节点数。
-
getAccessibleChild
public abstract Accessible getAccessibleChild(int i)
返回对象的指定Accessible子级。Accessible对象的Accessible子Accessible从零开始,因此Accessible子Accessible的第一个子Accessible位于索引0,第二个子Accessible位于索引1,依此类推。- 参数
-
i- 从零开始的儿童指数 - 结果
-
Accessible该对象的子项 - 另请参见:
-
getAccessibleChildrenCount()
-
getLocale
public abstract Locale getLocale() throws IllegalComponentStateException
获取组件的语言环境。 如果组件没有语言环境,则返回其父级的语言环境。- 结果
- 这个组件的语言环境。 如果此组件没有语言环境,则返回其父组件的语言环境。
- 异常
-
IllegalComponentStateException- 如果组件没有自己的语言环境且尚未添加到包含层次结构中,则可以从包含的父级确定区域设置
-
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()
获取与此对象关联的AccessibleValue,该对象支持Numerical值。- 结果
-
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)
支持报告绑定的属性更改。 如果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
-
-