- 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 方法 描述 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属性已更改。 旧值将为旧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
-
-