JavaTM Platform
Standard Ed. 6

javax.accessibility
类 AccessibleState

java.lang.Object
  继承者 javax.accessibility.AccessibleBundle
      继承者 javax.accessibility.AccessibleState

public class AccessibleState
extends AccessibleBundle

AccessibleState 类描述了组件的特殊状态。组件的实际状态定义为 AccessibleStateSet,它是由 AccessibleState 组成的集合。

toDisplayString 方法允许从此类中定义的键的预定义 ResourceBundle 获取与语言环境无关的键的本地化字符串。

此类中的常量表示公共对象职责的强类型的枚举。此类的公共构造方法已被有意忽略,应用程序应该使用此类的一个常量。如果此类中没有足够的常量来描述对象的职责,则应从此类生成一个子类,此子类应以类似的方式提供常量。


字段摘要
static AccessibleState ACTIVE
          指示某个窗口当前是活动窗口。
static AccessibleState ARMED
          指示选中了此对象。
static AccessibleState BUSY
          指示当前对象忙。
static AccessibleState CHECKED
          指示此对象当前被选中。
static AccessibleState COLLAPSED
          指示此对象是折叠的。
static AccessibleState EDITABLE
          指示用户可以更改此对象的内容。
static AccessibleState ENABLED
          指示此对象是启用的。
static AccessibleState EXPANDABLE
          指示此对象允许逐步显示其子级。
static AccessibleState EXPANDED
          指示此对象是展开的。
static AccessibleState FOCUSABLE
          指示此对象可以接受键盘焦点,这意味着当它具有焦点时,由键盘上的键入操作所产生的所有事件将被传递到此对象。
static AccessibleState FOCUSED
          指示此对象当前具有键盘焦点。
static AccessibleState HORIZONTAL
          指示此对象的方向为水平方向。
static AccessibleState ICONIFIED
          指示此对象是最小化的,并只通过一个图标来表示。
static AccessibleState INDETERMINATE
          指示对象状态是不确定的。
static AccessibleState MANAGES_DESCENDANTS
          指示此对象负责管理其子组件。
static AccessibleState MODAL
          指示在用户可以与不同窗口中的某个对象交互之前,必须对此对象采取某些操作。
static AccessibleState MULTI_LINE
          指示此(文本)对象可以包含多行文本
static AccessibleState MULTISELECTABLE
          指示此对象允许同时选定多个子级。
static AccessibleState OPAQUE
          指示此对象在其矩形区域内绘制每个像素。
static AccessibleState PRESSED
          指示此对象当前是按下的。
static AccessibleState RESIZABLE
          指示此对象的大小不固定。
static AccessibleState SELECTABLE
          指示此对象是某个允许选择子级的对象的子对象,并且此子对象就是这些可以被选择的子对象之一。
static AccessibleState SELECTED
          指示此对象是某个允许选择子级的对象的子对象,且此子对象是已被选定的子对象之一。
static AccessibleState SHOWING
          指示此对象、此对象的父对象、其父对象的父对象等都是可见的。
static AccessibleState SINGLE_LINE
          指示此(文本)对象只能包含单行文本
static AccessibleState TRANSIENT
          指示此对象是临时的。
static AccessibleState TRUNCATED
          该状态指示文本被边界矩形截取,并且有些文本不显示在屏幕上。
static AccessibleState VERTICAL
          指示此对象的方向为垂直方向。
static AccessibleState VISIBLE
          指示此对象是可见的。
 
从类 javax.accessibility.AccessibleBundle 继承的字段
key
 
构造方法摘要
protected AccessibleState(String key)
          使用给定的与语言环境无关的键创建新的 AccessibleState。
 
方法摘要
 
从类 javax.accessibility.AccessibleBundle 继承的方法
toDisplayString, toDisplayString, toDisplayString, toString
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

ACTIVE

public static final AccessibleState ACTIVE
指示某个窗口当前是活动窗口。这包括窗口、对话框、窗体等等。此外,此状态用于指示组件(例如列表、表或树)的当前活动子级。例如,列表的活动子级是周围绘制了矩形框的子级。

另请参见:
AccessibleRole.WINDOW, AccessibleRole.FRAME, AccessibleRole.DIALOG

PRESSED

public static final AccessibleState PRESSED
指示此对象当前是按下的。这通常与按钮相关,它指示当鼠标指针停留在按钮上时,用户已按下鼠标按钮,并且尚未释放鼠标按钮。

另请参见:
AccessibleRole.PUSH_BUTTON

ARMED

public static final AccessibleState ARMED
指示选中了此对象。这通常用于已按下且尚未释放,并且鼠标指针仍然停留在其上的按钮。

另请参见:
AccessibleRole.PUSH_BUTTON

BUSY

public static final AccessibleState BUSY
指示当前对象忙。这通常用于进度条、滑块或滚动条这之类的对象,以指示这些对象正处于过渡状态。

另请参见:
AccessibleRole.PROGRESS_BAR, AccessibleRole.SCROLL_BAR, AccessibleRole.SLIDER

CHECKED

public static final AccessibleState CHECKED
指示此对象当前被选中。这通常用于切换按钮、单选按钮和复选框之类的对象。

另请参见:
AccessibleRole.TOGGLE_BUTTON, AccessibleRole.RADIO_BUTTON, AccessibleRole.CHECK_BOX

EDITABLE

public static final AccessibleState EDITABLE
指示用户可以更改此对象的内容。这通常主要用于允许用户输入文本的对象。对于其他对象(例如滚动条和滑块),如果它们是启用的,则它们自动是可编辑的。

另请参见:
ENABLED

EXPANDABLE

public static final AccessibleState EXPANDABLE
指示此对象允许逐步显示其子级。这通常用于诸如树之类的分层对象,并通常与 EXPANDED 或 COLLAPSED 状态成对使用。

另请参见:
EXPANDED, COLLAPSED, AccessibleRole.TREE

COLLAPSED

public static final AccessibleState COLLAPSED
指示此对象是折叠的。这通常与 EXPANDABLE 状态成对使用,用于诸如树之类的提供逐步显示功能的对象。

另请参见:
EXPANDABLE, EXPANDED, AccessibleRole.TREE

EXPANDED

public static final AccessibleState EXPANDED
指示此对象是展开的。这通常与 EXPANDABLE 状态成对使用,用于诸如树之类的提供逐步显示功能的对象。

另请参见:
EXPANDABLE, COLLAPSED, AccessibleRole.TREE

ENABLED

public static final AccessibleState ENABLED
指示此对象是启用的。如果对象的状态集中没有此状态,则指示此对象是未启用的。用户不能操作未启用的对象。在图形显示中,它通常呈现灰色。


FOCUSABLE

public static final AccessibleState FOCUSABLE
指示此对象可以接受键盘焦点,这意味着当它具有焦点时,由键盘上的键入操作所产生的所有事件将被传递到此对象。

另请参见:
FOCUSED

FOCUSED

public static final AccessibleState FOCUSED
指示此对象当前具有键盘焦点。

另请参见:
FOCUSABLE

ICONIFIED

public static final AccessibleState ICONIFIED
指示此对象是最小化的,并只通过一个图标来表示。这通常只与窗体和内部窗体关联。

另请参见:
AccessibleRole.FRAME, AccessibleRole.INTERNAL_FRAME

MODAL

public static final AccessibleState MODAL
指示在用户可以与不同窗口中的某个对象交互之前,必须对此对象采取某些操作。这通常只与对话框关联。

另请参见:
AccessibleRole.DIALOG

OPAQUE

public static final AccessibleState OPAQUE
指示此对象在其矩形区域内绘制每个像素。透明的组件则仅绘制其中某些像素,允许其下面的像素“透视出来”。因此,没有完全绘制其像素的组件则提供了一定程度的透明度。

另请参见:
Accessible.getAccessibleContext(), AccessibleContext.getAccessibleComponent(), AccessibleComponent.getBounds()

RESIZABLE

public static final AccessibleState RESIZABLE
指示此对象的大小不固定。

另请参见:
Accessible.getAccessibleContext(), AccessibleContext.getAccessibleComponent(), AccessibleComponent.getSize(), AccessibleComponent.setSize(java.awt.Dimension)

MULTISELECTABLE

public static final AccessibleState MULTISELECTABLE
指示此对象允许同时选定多个子级。

另请参见:
Accessible.getAccessibleContext(), AccessibleContext.getAccessibleSelection(), AccessibleSelection

SELECTABLE

public static final AccessibleState SELECTABLE
指示此对象是某个允许选择子级的对象的子对象,并且此子对象就是这些可以被选择的子对象之一。

另请参见:
SELECTED, Accessible.getAccessibleContext(), AccessibleContext.getAccessibleSelection(), AccessibleSelection

SELECTED

public static final AccessibleState SELECTED
指示此对象是某个允许选择子级的对象的子对象,且此子对象是已被选定的子对象之一。

另请参见:
SELECTABLE, Accessible.getAccessibleContext(), AccessibleContext.getAccessibleSelection(), AccessibleSelection

SHOWING

public static final AccessibleState SHOWING
指示此对象、此对象的父对象、其父对象的父对象等都是可见的。注意,这不一定意味着在屏幕上绘制此对象。它可能包括在其他正在显示的对象中。

另请参见:
VISIBLE

VISIBLE

public static final AccessibleState VISIBLE
指示此对象是可见的。注:这意味着该对象是可见的;但是,它实际上不显示在屏幕上,因为包含此对象的对象中的一个对象不可见。

另请参见:
SHOWING

VERTICAL

public static final AccessibleState VERTICAL
指示此对象的方向为垂直方向。这通常与滚动条、滑块和进度条之类的对象关联。

另请参见:
VERTICAL, AccessibleRole.SCROLL_BAR, AccessibleRole.SLIDER, AccessibleRole.PROGRESS_BAR

HORIZONTAL

public static final AccessibleState HORIZONTAL
指示此对象的方向为水平方向。这通常与滚动条、滑块和进度条之类的对象关联。

另请参见:
HORIZONTAL, AccessibleRole.SCROLL_BAR, AccessibleRole.SLIDER, AccessibleRole.PROGRESS_BAR

SINGLE_LINE

public static final AccessibleState SINGLE_LINE
指示此(文本)对象只能包含单行文本


MULTI_LINE

public static final AccessibleState MULTI_LINE
指示此(文本)对象可以包含多行文本


TRANSIENT

public static final AccessibleState TRANSIENT
指示此对象是临时的。辅助技术不应将 PropertyChange 侦听器添加到具有临时状态的对象中 ,因为该对象永远不会生成任何事件。 创建临时对象的目的通常是为了应答 Java Accessibility 方法查询,否则不保持到底层对象的链接(例如,Swing 中的列表、表和树的下级对象,这里只有一个实际的 UI Component 为实际列表/表/树元素下的所有数据对象执行共享呈现职责)。

从以下版本开始:
1.5

MANAGES_DESCENDANTS

public static final AccessibleState MANAGES_DESCENDANTS
指示此对象负责管理其子组件。这通常用于带有大量子组件的树和表,并且只在需要对象时才创建对象,否则保持虚拟的状态。应用程序不应直接管理子组件。

从以下版本开始:
1.5

INDETERMINATE

public static final AccessibleState INDETERMINATE
指示对象状态是不确定的。例如,部分为粗体,部分不为粗体的选定文本。在这种情况下,与选定文本关联的属性是不确定的。

从以下版本开始:
1.5

TRUNCATED

public static final AccessibleState TRUNCATED
该状态指示文本被边界矩形截取,并且有些文本不显示在屏幕上。例如电子表格单元格中被单元格边界所截取的文本。

从以下版本开始:
1.5
构造方法详细信息

AccessibleState

protected AccessibleState(String key)
使用给定的与语言环境无关的键创建新的 AccessibleState。此方法不应该是公共方法。相反,它用于创建此文件中的常量以使其成为强类型的枚举。此类的子类应强制执行类似的策略。

String 键应该是针对状态的与语言环境无关的键。它不打算用作实际的 String 显示给用户。要获得本地化字符串,请使用 toDisplayString。

参数:
key - 状态的与语言环境无关的名称。
另请参见:
AccessibleBundle.toDisplayString(java.lang.String, java.util.Locale)

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策