- 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
- 对象支持数值。 该界面提供了辅助技术的标准机制,用于确定和设置对象的当前值,以及获取其最小值和最大值。 任何支持数值的对象都应该支持这个接口。
-
-
Field Summary
-
构造方法摘要
构造方法 Constructor 描述 AccessibleContext()
-
方法摘要
所有方法 接口方法 抽象方法 具体的方法 Modifier and Type 方法 描述 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
属性已更改。 旧值将为旧AccessibleState
,新值将在AccessibleState
中新增accessibleStateSet
。 例如,如果支持垂直和水平状态的组件将其方向从垂直方向改变为水平,则旧值将为AccessibleState.VERTICAL
,新值将为AccessibleState.HORIZONTAL
。 请注意,这两个值也可以是null
。 例如,当组件从启用变为禁用时,旧值将为AccessibleState.ENABLED
,新值将为null
。
-
ACCESSIBLE_VALUE_PROPERTY
public static final String ACCESSIBLE_VALUE_PROPERTY
常数用于确定accessibleValue
属性何时更改。 在旧值PropertyChangeEvent
将是一个Number
表示旧值和新值将是一个Number
表示新值。
-
ACCESSIBLE_SELECTION_PROPERTY
public static final String ACCESSIBLE_SELECTION_PROPERTY
常数用于确定accessibleSelection
发生变化。PropertyChangeEvent
中的旧值和新值目前保留供将来使用。
-
ACCESSIBLE_CARET_PROPERTY
public static final String ACCESSIBLE_CARET_PROPERTY
常数用于确定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
。
-
ACCESSIBLE_TABLE_CAPTION_CHANGED
public static final String ACCESSIBLE_TABLE_CAPTION_CHANGED
常数用于表示表格已更改。PropertyChangeEvent
的旧值将是Accessible
表示前一个表格标题,新值将是一个Accessible
表示新的表格标题。- 另请参见:
-
Accessible
,AccessibleTable
, Constant Field Values
-
ACCESSIBLE_TABLE_SUMMARY_CHANGED
public static final String ACCESSIBLE_TABLE_SUMMARY_CHANGED
常数用于表示表格摘要已更改。PropertyChangeEvent
的旧值将为Accessible
表示前一表格摘要,新值将为新表表摘要的Accessible
。- 另请参见:
-
Accessible
,AccessibleTable
, Constant Field Values
-
ACCESSIBLE_TABLE_MODEL_CHANGED
public static final String ACCESSIBLE_TABLE_MODEL_CHANGED
用于表示表数据已更改的常数。PropertyChangeEvent
的旧值将为null
,新值为AccessibleTableModelChange
表示表的变动。
-
ACCESSIBLE_TABLE_ROW_HEADER_CHANGED
public static final String ACCESSIBLE_TABLE_ROW_HEADER_CHANGED
用于指示行标题已更改的常量。PropertyChangeEvent
的旧值将为null
,新值为AccessibleTableModelChange
表示标头更改。
-
ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED
public static final String ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED
常数用于指示行描述已更改。PropertyChangeEvent
的旧值将为null
,新值为Integer
表示行索引。- 另请参见:
-
AccessibleTable
, Constant Field Values
-
ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED
public static final String ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED
常量用于指示列标题已更改。PropertyChangeEvent
的旧值将为null
,新值将为AccessibleTableModelChange
表示标头更改。
-
ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED
public static final String ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED
常数用于指示列描述已更改。PropertyChangeEvent
的旧值将为null
,新值将为Integer
表示列索引。- 另请参见:
-
AccessibleTable
, Constant Field Values
-
ACCESSIBLE_ACTION_PROPERTY
public static final String ACCESSIBLE_ACTION_PROPERTY
常数用于指示受支持的操作集已更改。PropertyChangeEvent
的旧值将是Integer
代表支持的旧数量的操作,新值将为Integer
表示支持的新操作数。
-
ACCESSIBLE_HYPERTEXT_OFFSET
public static final String ACCESSIBLE_HYPERTEXT_OFFSET
用于指示超文本元素已经接收焦点的常数。PropertyChangeEvent
的旧值将是Integer
表示上一个具有焦点的元素的文档中的起始索引,新值将是Integer
表示当前具有焦点的元素的文档中的起始索引。 值-1表示元素没有或没有焦点。
-
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
是孩子成为无效的组件。
-
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
。
-
ACCESSIBLE_COMPONENT_BOUNDS_CHANGED
public static final String ACCESSIBLE_COMPONENT_BOUNDS_CHANGED
PropertyChangeEvent
,其指示组件边界中发生更改。oldValue
是旧的组件界限,而newValue
是新的组件界限。- 从以下版本开始:
- 1.5
- 另请参见:
-
addPropertyChangeListener(java.beans.PropertyChangeListener)
, Constant Field Values
-
accessibleParent
protected Accessible accessibleParent
该对象的可访问父级。
-
accessibleName
protected String accessibleName
包含对象名称的本地化字符串。
-
accessibleDescription
protected String accessibleDescription
包含对象描述的本地化字符串。
-
-
方法详细信息
-
getAccessibleName
public String getAccessibleName()
获取此对象的accessibleName
属性。 一个对象的accessibleName
属性是一个本地化的String
,它指定对象的目的。 例如,标签或按钮的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
-
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
小孩的第一个子项为索引0,第二个子项为索引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
-
-