JavaTM Platform
Standard Ed. 6

javax.accessibility
类 AccessibleRole

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

public class AccessibleRole
extends AccessibleBundle

AccessibleRole 类确定组件的职责。组件职责描述组件的一般功能。(例如,"push button"、"table" 或 "list")。

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

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


字段摘要
static AccessibleRole ALERT
          可用于就某事向用户报警的对象。
static AccessibleRole AWT_COMPONENT
          一个 AWT 组件,但关于它的其他信息都是未知的。
static AccessibleRole CANVAS
          可用于绘制和捕获事件的对象。
static AccessibleRole CHECK_BOX
          可以被选中或不被选中的选项,它针对当前状态提供了单独的指示符。
static AccessibleRole COLOR_CHOOSER
          允许用户选择颜色的专用窗格。
static AccessibleRole COLUMN_HEADER
          数据列的头。
static AccessibleRole COMBO_BOX
          用户可以从中进行选择的选项列表。
static AccessibleRole DATE_EDITOR
          DATE_EDITOR 是允许用户编辑 java.util.Date 和 java.util.Time 对象的组件。
static AccessibleRole DESKTOP_ICON
          DESKTOP_PANE 中的图标化的内部 frame。
static AccessibleRole DESKTOP_PANE
          支持内部窗体和这些内部窗体的图标化形式的窗格。
static AccessibleRole DIALOG
          带有标题栏和边框的顶层窗口。
static AccessibleRole DIRECTORY_PANE
          允许用户在目录内容中导航并进行选择的窗格。
static AccessibleRole EDITBAR
          该职责表示充当一个求值公式的对象。
static AccessibleRole FILE_CHOOSER
          一个专用的对话框,它显示目录中的文件,并允许用户选择文件、浏览不同的目录,或指定一个文件名。
static AccessibleRole FILLER
          填补用户界面空间的对象。
static AccessibleRole FONT_CHOOSER
          FONT_CHOOSER 是允许用户选择各种字体属性的组件。
static AccessibleRole FOOTER
          文本脚注
static AccessibleRole FRAME
          带有标题栏、边框、菜单栏等的顶层窗口。
static AccessibleRole GLASS_PANE
          一个窗格,保证此窗格在其所有下级窗格之上进行绘制。
static AccessibleRole GROUP_BOX
          GROUP_BOX 是包含它周围的边框及其内部组件的简单容器。
static AccessibleRole HEADER
          文本标题
static AccessibleRole HTML_CONTAINER
          包含一起能表示 HTML 内容的 Accessible 集合的对象。
static AccessibleRole HYPERLINK
          超文本锚
static AccessibleRole ICON
          一个固定大小的小图片,通常用于装饰组件。
static AccessibleRole INTERNAL_FRAME
          通过桌面窗格剪切的类似于窗体的对象。
static AccessibleRole LABEL
          用于在界面中显示图标或短字符串的对象。
static AccessibleRole LAYERED_PANE
          允许其子级在各层中进行绘制的专用窗格,提供堆栈顺序的形式。
static AccessibleRole LIST
          呈现给用户一个对象列表的对象,它还允许用户从中选择一个或多个对象。
static AccessibleRole LIST_ITEM
          呈现列表元素的对象。
static AccessibleRole MENU
          通常出现在菜单栏中的对象,它包含一个用户可以从中选择的动作列表。
static AccessibleRole MENU_BAR
          通常被绘制在应用程序的主对话框顶部的对象,它包含用户可以从中进行选择的菜单列表。
static AccessibleRole MENU_ITEM
          通常包含在菜单中的对象,该对象呈现用户可以选择的动作。
static AccessibleRole OPTION_PANE
          主要用于 DIALOG 内部的专用窗格
static AccessibleRole PAGE_TAB
          作为页选项卡列表子级的对象。
static AccessibleRole PAGE_TAB_LIST
          通过所提供的某种机制一次可呈现一系列窗格(或页选项卡)的对象。
static AccessibleRole PANEL
          通常用于对对象进行分组的一般容器。
static AccessibleRole PARAGRAPH
          文本段落
static AccessibleRole PASSWORD_TEXT
          用于密码或文本内容不显示给用户的其他地方的文本对象。
static AccessibleRole POPUP_MENU
          一个临时窗口,通常用于为用户提供选项列表,当用户选中其中某个选项后,此窗口隐藏。
static AccessibleRole PROGRESS_BAR
          用于指示某项任务已完成多少的对象。
static AccessibleRole PROGRESS_MONITOR
          该职责表示监视某个操作进度的对象。
static AccessibleRole PUSH_BUTTON
          用户可以操作以通知应用程序执行某任务的对象。
static AccessibleRole RADIO_BUTTON
          一个专用复选框,当选中此复选框时,将导致取消选中同一组中的其他单选按钮。
static AccessibleRole ROOT_PANE
          一个专用窗格,带有玻璃窗格和作为其子窗格的分层窗格。
static AccessibleRole ROW_HEADER
          数据行的头。
static AccessibleRole RULER
          RULER 是用于测量距离的对象
static AccessibleRole SCROLL_BAR
          通常用于允许用户逐渐查看大量数据的对象。
static AccessibleRole SCROLL_PANE
          允许用户逐渐查看大量信息的对象。
static AccessibleRole SEPARATOR
          通常包含在菜单中的对象,它对菜单中的内容进行可视和逻辑分离。
static AccessibleRole SLIDER
          允许用户在有限范围内进行选择的对象。
static AccessibleRole SPIN_BOX
          SPIN_BOX 是简单的微调器组件,它主要用于简单数字。
static AccessibleRole SPLIT_PANE
          同时呈现两个其他窗格的专用窗格。
static AccessibleRole STATUS_BAR
          STATUS_BAR 是可以包含多个用户状态信息标签的简单组件。
static AccessibleRole SWING_COMPONENT
          一个 Swing 组件,但关于它的其他信息都是未知的。
static AccessibleRole TABLE
          用于根据行和列来呈现信息的对象。
static AccessibleRole TEXT
          将文本呈现给用户的对象。
static AccessibleRole TOGGLE_BUTTON
          可以被选中或不被选中的专用按钮,但不针对当前状态提供单独的指示符。
static AccessibleRole TOOL_BAR
          通常由普通按钮或切换按钮组成的工具栏或调色板。
static AccessibleRole TOOL_TIP
          提供关于另一个对象信息的对象。
static AccessibleRole TREE
          用于将层次结构信息呈现给用户的对象。
static AccessibleRole UNKNOWN
          该对象包含某些 Accessible 信息,但其职责是未知的。
static AccessibleRole VIEWPORT
          通常在滚动窗格中使用的对象。
static AccessibleRole WINDOW
          不带标题或边框的顶层窗口。
 
从类 javax.accessibility.AccessibleBundle 继承的字段
key
 
构造方法摘要
protected AccessibleRole(String key)
          使用与语言环境无关的给定键创建新的 AccessibleRole。
 
方法摘要
 
从类 javax.accessibility.AccessibleBundle 继承的方法
toDisplayString, toDisplayString, toDisplayString, toString
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

ALERT

public static final AccessibleRole ALERT
可用于就某事向用户报警的对象。


COLUMN_HEADER

public static final AccessibleRole COLUMN_HEADER
数据列的头。


CANVAS

public static final AccessibleRole CANVAS
可用于绘制和捕获事件的对象。

另请参见:
FRAME, GLASS_PANE, LAYERED_PANE

COMBO_BOX

public static final AccessibleRole COMBO_BOX
用户可以从中进行选择的选项列表。还允许用户输入他们自己的选项(可选)。


DESKTOP_ICON

public static final AccessibleRole DESKTOP_ICON
DESKTOP_PANE 中的图标化的内部 frame。

另请参见:
DESKTOP_PANE, INTERNAL_FRAME

HTML_CONTAINER

public static final AccessibleRole HTML_CONTAINER
包含一起能表示 HTML 内容的 Accessible 集合的对象。子 Accessible 可能包括实现 AccessibleTextAccessibleHypertextAccessibleIcon 和其他接口的对象。

从以下版本开始:
1.6
另请参见:
HYPERLINK, AccessibleText, AccessibleHypertext, AccessibleHyperlink, AccessibleIcon

INTERNAL_FRAME

public static final AccessibleRole INTERNAL_FRAME
通过桌面窗格剪切的类似于窗体的对象。桌面窗格、内部窗体和桌面图标对象通常用来在应用程序中创建多文档界面。

另请参见:
DESKTOP_ICON, DESKTOP_PANE, FRAME

DESKTOP_PANE

public static final AccessibleRole DESKTOP_PANE
支持内部窗体和这些内部窗体的图标化形式的窗格。

另请参见:
DESKTOP_ICON, INTERNAL_FRAME

OPTION_PANE

public static final AccessibleRole OPTION_PANE
主要用于 DIALOG 内部的专用窗格

另请参见:
DIALOG

WINDOW

public static final AccessibleRole WINDOW
不带标题或边框的顶层窗口。

另请参见:
FRAME, DIALOG

FRAME

public static final AccessibleRole FRAME
带有标题栏、边框、菜单栏等的顶层窗口。它通常用作应用程序的主窗口。

另请参见:
DIALOG, CANVAS, WINDOW

DIALOG

public static final AccessibleRole DIALOG
带有标题栏和边框的顶层窗口。对话框类似于窗体,但它属性较少,通常用作应用程序的二级窗口。

另请参见:
FRAME, WINDOW

COLOR_CHOOSER

public static final AccessibleRole COLOR_CHOOSER
允许用户选择颜色的专用窗格。


DIRECTORY_PANE

public static final AccessibleRole DIRECTORY_PANE
允许用户在目录内容中导航并进行选择的窗格。文件选择器可以使用此窗格。

另请参见:
FILE_CHOOSER

FILE_CHOOSER

public static final AccessibleRole FILE_CHOOSER
一个专用的对话框,它显示目录中的文件,并允许用户选择文件、浏览不同的目录,或指定一个文件名。可以使用目录窗格来显示目录的内容。

另请参见:
DIRECTORY_PANE

FILLER

public static final AccessibleRole FILLER
填补用户界面空间的对象。它通常用于在界面中调整组件之间的空间,并无其他用途。


HYPERLINK

public static final AccessibleRole HYPERLINK
超文本锚


ICON

public static final AccessibleRole ICON
一个固定大小的小图片,通常用于装饰组件。


LABEL

public static final AccessibleRole LABEL
用于在界面中显示图标或短字符串的对象。


ROOT_PANE

public static final AccessibleRole ROOT_PANE
一个专用窗格,带有玻璃窗格和作为其子窗格的分层窗格。

另请参见:
GLASS_PANE, LAYERED_PANE

GLASS_PANE

public static final AccessibleRole GLASS_PANE
一个窗格,保证此窗格在其所有下级窗格之上进行绘制。

另请参见:
ROOT_PANE, CANVAS

LAYERED_PANE

public static final AccessibleRole LAYERED_PANE
允许其子级在各层中进行绘制的专用窗格,提供堆栈顺序的形式。这通常是保存菜单栏的窗格,以及包含窗口中大多数可见组件的窗格。

另请参见:
GLASS_PANE, ROOT_PANE

LIST

public static final AccessibleRole LIST
呈现给用户一个对象列表的对象,它还允许用户从中选择一个或多个对象。列表通常包含在滚动窗格中。

另请参见:
SCROLL_PANE, LIST_ITEM

LIST_ITEM

public static final AccessibleRole LIST_ITEM
呈现列表元素的对象。列表通常包含在滚动窗格中。

另请参见:
SCROLL_PANE, LIST

MENU_BAR

public static final AccessibleRole MENU_BAR
通常被绘制在应用程序的主对话框顶部的对象,它包含用户可以从中进行选择的菜单列表。例如,菜单栏可以包含 "File"、"Edit" 和 "Help" 菜单。

另请参见:
MENU, POPUP_MENU, LAYERED_PANE

POPUP_MENU

public static final AccessibleRole POPUP_MENU
一个临时窗口,通常用于为用户提供选项列表,当用户选中其中某个选项后,此窗口隐藏。

另请参见:
MENU, MENU_ITEM

MENU

public static final AccessibleRole MENU
通常出现在菜单栏中的对象,它包含一个用户可以从中选择的动作列表。菜单可以使用任何对象作为其子级,但这些对象通常都是菜单项、其他菜单或单选按钮、复选框或分隔栏这样的基本对象。例如,应用程序可能有 "Edit" 菜单,它包含 "Cut" 和 "Paste" 菜单项。

另请参见:
MENU_BAR, MENU_ITEM, SEPARATOR, RADIO_BUTTON, CHECK_BOX, POPUP_MENU

MENU_ITEM

public static final AccessibleRole MENU_ITEM
通常包含在菜单中的对象,该对象呈现用户可以选择的动作。例如,"Edit" 菜单中的 "Cut" 菜单项就是一个用户可以选择的动作,用于剪切文档中的选定文本区域。

另请参见:
MENU_BAR, SEPARATOR, POPUP_MENU

SEPARATOR

public static final AccessibleRole SEPARATOR
通常包含在菜单中的对象,它对菜单中的内容进行可视和逻辑分离。例如,应用程序的 "File" 菜单可能包含菜单项 "Open"、"Close" 和 "Exit",在 "Close" 和 "Exit" 菜单项之间将有一个分隔符。

另请参见:
MENU, MENU_ITEM

PAGE_TAB_LIST

public static final AccessibleRole PAGE_TAB_LIST
通过所提供的某种机制一次可呈现一系列窗格(或页选项卡)的对象。最常见的机制是位于窗格顶部的选项卡列表。页选项卡列表的子级是所有页选项卡。

另请参见:
PAGE_TAB

PAGE_TAB

public static final AccessibleRole PAGE_TAB
作为页选项卡列表子级的对象。它的唯一子级是用户从页选项卡列表中选则页选项卡时,要呈现给用户的窗格。

另请参见:
PAGE_TAB_LIST

PANEL

public static final AccessibleRole PANEL
通常用于对对象进行分组的一般容器。


PROGRESS_BAR

public static final AccessibleRole PROGRESS_BAR
用于指示某项任务已完成多少的对象。


PASSWORD_TEXT

public static final AccessibleRole PASSWORD_TEXT
用于密码或文本内容不显示给用户的其他地方的文本对象。


PUSH_BUTTON

public static final AccessibleRole PUSH_BUTTON
用户可以操作以通知应用程序执行某任务的对象。

另请参见:
CHECK_BOX, TOGGLE_BUTTON, RADIO_BUTTON

TOGGLE_BUTTON

public static final AccessibleRole TOGGLE_BUTTON
可以被选中或不被选中的专用按钮,但不针对当前状态提供单独的指示符。

另请参见:
PUSH_BUTTON, CHECK_BOX, RADIO_BUTTON

CHECK_BOX

public static final AccessibleRole CHECK_BOX
可以被选中或不被选中的选项,它针对当前状态提供了单独的指示符。

另请参见:
PUSH_BUTTON, TOGGLE_BUTTON, RADIO_BUTTON

RADIO_BUTTON

public static final AccessibleRole RADIO_BUTTON
一个专用复选框,当选中此复选框时,将导致取消选中同一组中的其他单选按钮。

另请参见:
PUSH_BUTTON, TOGGLE_BUTTON, CHECK_BOX

ROW_HEADER

public static final AccessibleRole ROW_HEADER
数据行的头。


SCROLL_PANE

public static final AccessibleRole SCROLL_PANE
允许用户逐渐查看大量信息的对象。其子级可以包括滚动条和视口。

另请参见:
SCROLL_BAR, VIEWPORT

SCROLL_BAR

public static final AccessibleRole SCROLL_BAR
通常用于允许用户逐渐查看大量数据的对象。通常只供滚动窗格使用。

另请参见:
SCROLL_PANE

VIEWPORT

public static final AccessibleRole VIEWPORT
通常在滚动窗格中使用的对象。它表示用户能够看到的整个数据的一部分。当用户操作滚动条时,视口的内容可以发生更改。

另请参见:
SCROLL_PANE

SLIDER

public static final AccessibleRole SLIDER
允许用户在有限范围内进行选择的对象。例如,滑块可用于选择 0 到 100 之间的某个数字。


SPLIT_PANE

public static final AccessibleRole SPLIT_PANE
同时呈现两个其他窗格的专用窗格。两个窗格之间有一个分隔栏,用户可以操作分隔栏使一个窗格变大,并使另一个窗格变小。


TABLE

public static final AccessibleRole TABLE
用于根据行和列来呈现信息的对象。例如电子表格应用程序。


TEXT

public static final AccessibleRole TEXT
将文本呈现给用户的对象。与标签不同,文本通常可以由用户编辑。

另请参见:
LABEL

TREE

public static final AccessibleRole TREE
用于将层次结构信息呈现给用户的对象。可以将树中的各个节点折叠和展开,以选择性地显示树的内容。


TOOL_BAR

public static final AccessibleRole TOOL_BAR
通常由普通按钮或切换按钮组成的工具栏或调色板。它通常用于提供应用程序最常用的功能。


TOOL_TIP

public static final AccessibleRole TOOL_TIP
提供关于另一个对象信息的对象。当用户将鼠标停在与工具提示文本关联的对象上时,该工具提示文本的 accessibleDescription 属性通常以一个很小的 "help bubble" 的形式显示给用户。


AWT_COMPONENT

public static final AccessibleRole AWT_COMPONENT
一个 AWT 组件,但关于它的其他信息都是未知的。

另请参见:
SWING_COMPONENT, UNKNOWN

SWING_COMPONENT

public static final AccessibleRole SWING_COMPONENT
一个 Swing 组件,但关于它的其他信息都是未知的。

另请参见:
AWT_COMPONENT, UNKNOWN

UNKNOWN

public static final AccessibleRole UNKNOWN
该对象包含某些 Accessible 信息,但其职责是未知的。

另请参见:
AWT_COMPONENT, SWING_COMPONENT

STATUS_BAR

public static final AccessibleRole STATUS_BAR
STATUS_BAR 是可以包含多个用户状态信息标签的简单组件。


DATE_EDITOR

public static final AccessibleRole DATE_EDITOR
DATE_EDITOR 是允许用户编辑 java.util.Date 和 java.util.Time 对象的组件。


SPIN_BOX

public static final AccessibleRole SPIN_BOX
SPIN_BOX 是简单的微调器组件,它主要用于简单数字。


FONT_CHOOSER

public static final AccessibleRole FONT_CHOOSER
FONT_CHOOSER 是允许用户选择各种字体属性的组件。


GROUP_BOX

public static final AccessibleRole GROUP_BOX
GROUP_BOX 是包含它周围的边框及其内部组件的简单容器。


HEADER

public static final AccessibleRole HEADER
文本标题

从以下版本开始:
1.5

FOOTER

public static final AccessibleRole FOOTER
文本脚注

从以下版本开始:
1.5

PARAGRAPH

public static final AccessibleRole PARAGRAPH
文本段落

从以下版本开始:
1.5

RULER

public static final AccessibleRole RULER
RULER 是用于测量距离的对象

从以下版本开始:
1.5

EDITBAR

public static final AccessibleRole EDITBAR
该职责表示充当一个求值公式的对象。例如电子表格单元格中的公式。

从以下版本开始:
1.5

PROGRESS_MONITOR

public static final AccessibleRole PROGRESS_MONITOR
该职责表示监视某个操作进度的对象。

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

AccessibleRole

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

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

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

JavaTM Platform
Standard Ed. 6

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

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