- 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()
-
方法摘要
所有方法 实例方法 抽象方法 具体的方法 变量和类型 方法 描述 void
addPropertyChangeListener(PropertyChangeListener listener)
将PropertyChangeListener
添加到侦听器列表中。void
firePropertyChange(String propertyName, Object oldValue, Object newValue)
支持报告绑定的属性更改。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()
获取此对象在其可访问父级中的从0开始的索引。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()
获取与此对象关联的AccessibleValue
,该对象支持Numerical
值。abstract Locale
getLocale()
获取组件的语言环境。void
removePropertyChangeListener(PropertyChangeListener listener)
从侦听器列表中删除PropertyChangeListener
。void
setAccessibleDescription(String s)
设置此对象的可访问描述。void
setAccessibleName(String s)
设置此对象的本地化可访问名称。void
setAccessibleParent(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
-
-