模块 java.desktop
包 javax.accessibility

类 AccessibleContext

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

      protected AccessibleContext()
      子类调用的构造方法。

  • 方法详情

    • getAccessibleName

      public String  getAccessibleName()
      获取此对象的 accessibleName 属性。对象的 accessibleName 属性是指定对象用途的本地化 String。例如，标签或按钮的 accessibleName 属性可能是标签或按钮本身的文本。对于不显示其名称的对象，accessibleName 仍应设置。例如，对于用于输入城市名称的文本字段，en_US locale的 accessibleName 可以是“城市”。
      返回：
      对象的本地化名称； null 如果这个对象没有名字
      参见：

    • setAccessibleName

      @BeanProperty (preferred =true, description ="Sets the accessible name for the component.") public void setAccessibleName(String  s)
      设置此对象的本地化可访问名称。更改名称将导致为 ACCESSIBLE_NAME_PROPERTY 属性触发 PropertyChangeEvent。
      参数：
      s - 对象的新本地化名称
      参见：

    • getAccessibleDescription

      public String  getAccessibleDescription()
      获取此对象的 accessibleDescription 属性。此对象的 accessibleDescription 属性是一个简短的本地化短语，描述了该对象的用途。例如，对于“取消”按钮，accessibleDescription 可能是“忽略更改并关闭对话框”。
      返回：
      对象的本地化描述； null 如果这个对象没有描述
      参见：

    • setAccessibleDescription

      @BeanProperty (preferred =true, description ="Sets the accessible description for the component.") public void setAccessibleDescription(String  s)
      设置此对象的可访问描述。更改名称将导致为 ACCESSIBLE_DESCRIPTION_PROPERTY 属性触发 PropertyChangeEvent。
      参数：
      s - 对象的新本地化描述
      参见：

    • getAccessibleRole

      public abstract AccessibleRole  getAccessibleRole()
      获取此对象的角色。对象的作用是这个对象的类的通用目的或用途。例如，按钮的作用是 AccessibleRole.PUSH_BUTTON 。提供 AccessibleRole 中的角色，以便组件开发人员可以从一组预定义的角色中进行选择。这使辅助技术能够为各种经过调整的组件子类提供一致的接口（例如，对所有像按钮一样的组件使用AccessibleRole.PUSH_BUTTON）以及区分行为不同的子类（例如，AccessibleRole.CHECK_BOX用于复选框和AccessibleRole.RADIO_BUTTON用于无线电纽扣）。

      请注意，AccessibleRole 类也是可扩展的，因此如果预定义角色集不足，自定义组件开发人员可以定义自己的 AccessibleRole 类。

      返回：
      AccessibleRole 的一个实例，描述对象的角色
      参见：

    • getAccessibleStateSet

      public abstract AccessibleStateSet  getAccessibleStateSet()
      获取此对象的状态集。对象的 AccessibleStateSet 由一组唯一的 AccessibleStates 组成。对象的 AccessibleStateSet 中的更改将导致为 ACCESSIBLE_STATE_PROPERTY 属性触发 PropertyChangeEvent。
      返回：
      AccessibleStateSet 的实例，包含对象的当前状态集
      参见：

    • 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 如果此对象没有可访问的父对象。
      参见：

    • getAccessibleChildrenCount

      public abstract int getAccessibleChildrenCount()
      返回对象的可访问子对象的数量。
      返回：
      对象的可访问子对象的数量。

    • getAccessibleChild

      public abstract Accessible  getAccessibleChild(int i)
      返回对象的指定 Accessible 子对象。 Accessible 对象的 Accessible 子对象是从零开始的，因此 Accessible 子对象的第一个子对象位于索引 0，第二个子对象位于索引 1，依此类推。
      参数：
      i - 从零开始的子索引
      返回：
      对象的 Accessible 子对象
      参见：

    • getLocale

      public abstract Locale  getLocale() throws IllegalComponentStateException
      获取组件的locale。如果组件没有区域设置，则返回其父组件的区域设置。
      返回：
      该组件的locale。如果此组件没有区域设置，则返回其父组件的区域设置。
      抛出：
      IllegalComponentStateException - 如果组件没有自己的区域设置并且尚未添加到包含层次结构中，以便可以从包含父项确定区域设置

    • addPropertyChangeListener

      public void addPropertyChangeListener(PropertyChangeListener  listener)
      将 PropertyChangeListener 添加到监听器列表。监听器已为所有 Accessible 属性注册，并将在这些属性更改时调用。
      参数：
      listener - 要添加的 PropertyChangeListener
      参见：

    • removePropertyChangeListener

      public void removePropertyChangeListener(PropertyChangeListener  listener)
      从监听器列表中删除 PropertyChangeListener。这将删除为所有属性注册的 PropertyChangeListener。
      参数：
      listener - 要删除的 PropertyChangeListener

    • getAccessibleAction

      public AccessibleAction  getAccessibleAction()
      获取与支持一个或多个操作的对象关联的 AccessibleAction。
      返回：
      AccessibleAction 如果对象支持；否则返回null
      参见：

    • getAccessibleComponent

      public AccessibleComponent  getAccessibleComponent()
      获取与此具有图形表示的对象关联的 AccessibleComponent。
      返回：
      AccessibleComponent 如果对象支持；否则返回null
      参见：

    • getAccessibleSelection

      public AccessibleSelection  getAccessibleSelection()
      获取与此对象关联的 AccessibleSelection，从而允许选择其 Accessible 子对象。
      返回：
      AccessibleSelection 如果对象支持；否则返回null
      参见：

    • getAccessibleText

      public AccessibleText  getAccessibleText()
      获取与此对象关联的 AccessibleText 在显示器上呈现文本。
      返回：
      AccessibleText 如果对象支持；否则返回null
      参见：

    • getAccessibleEditableText

      public AccessibleEditableText  getAccessibleEditableText()
      获取与此对象关联的 AccessibleEditableText，在显示器上呈现可编辑的文本。
      返回：
      AccessibleEditableText 如果对象支持；否则返回null
      自从：
      1.4
      参见：

    • getAccessibleValue

      public AccessibleValue  getAccessibleValue()
      获取与支持 Numerical 值的此对象关联的 AccessibleValue。
      返回：
      AccessibleValue 如果对象支持；否则返回null
      参见：

    • getAccessibleIcon

      public AccessibleIcon [] getAccessibleIcon()
      获取与具有一个或多个关联图标的对象关联的 AccessibleIcons。
      返回：
      如果对象支持，则为 AccessibleIcon 数组；否则返回 null
      自从：
      1.3
      参见：

    • getAccessibleRelationSet

      public AccessibleRelationSet  getAccessibleRelationSet()
      获取与对象关联的 AccessibleRelationSet。
      返回：
      AccessibleRelationSet 如果对象支持；否则返回 null
      自从：
      1.3
      参见：

    • getAccessibleTable

      public AccessibleTable  getAccessibleTable()
      获取与对象关联的 AccessibleTable。
      返回：
      AccessibleTable 如果对象支持；否则返回 null
      自从：
      1.3
      参见：

    • firePropertyChange

      public void firePropertyChange(String  propertyName, Object  oldValue, Object  newValue)
      支持报告绑定的属性更改。如果 oldValue 和 newValue 不相等且 PropertyChangeEvent 监听器列表不为空，则向每个监听器触发 PropertyChange 事件。通常，这是供 Accessible 对象本身使用的，不应由应用程序调用。
      参数：
      propertyName - 已更改属性的编程名称
      oldValue - 属性的旧值
      newValue - 属性的新值
      参见：