Component.AccessibleAWTComponent

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt
类 Component.AccessibleAWTComponent

java.lang.Object
  javax.accessibility.AccessibleContext
      java.awt.Component.AccessibleAWTComponent

所有已实现的接口：: Serializable, AccessibleComponent

直接已知子类：: Box.Filler.AccessibleBoxFiller, Button.AccessibleAWTButton, Canvas.AccessibleAWTCanvas, Checkbox.AccessibleAWTCheckbox, Choice.AccessibleAWTChoice, Container.AccessibleAWTContainer, Label.AccessibleAWTLabel, List.AccessibleAWTList, List.AccessibleAWTList.AccessibleAWTListChild, Scrollbar.AccessibleAWTScrollBar, TextComponent.AccessibleAWTTextComponent

正在封闭类：: Component

protected abstract class Component.AccessibleAWTComponent
extends AccessibleContext
implements Serializable, AccessibleComponent

用来为可访问性提供默认支持的 Component 的内部类。此类不是专门供应用程序开发人员直接使用的，而是供组件开发人员创建子类的。

可以使用该类来获得此对象的可访问功能。

从以下版本开始：: 1.3
另请参见：: 序列化表格

嵌套类摘要
`protected class`	`Component.AccessibleAWTComponent.AccessibleAWTComponentHandler` 当发生显示/隐藏操作时，激活 PropertyChange 侦听器（如果注册了该侦听器）
`protected class`	`Component.AccessibleAWTComponent.AccessibleAWTFocusHandler` 当发生焦点事件时，激活 PropertyChange 侦听器（如果注册了该侦听器）

字段摘要
`protected ComponentListener`	`accessibleAWTComponentHandler`
`protected FocusListener`	`accessibleAWTFocusHandler`

从类 javax.accessibility.AccessibleContext 继承的字段
ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_COMPONENT_BOUNDS_CHANGED, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, ACCESSIBLE_INVALIDATE_CHILDREN, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TABLE_CAPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED, ACCESSIBLE_TABLE_MODEL_CHANGED, ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_ROW_HEADER_CHANGED, ACCESSIBLE_TABLE_SUMMARY_CHANGED, ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent

从类 javax.accessibility.AccessibleContext 继承的字段

ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_COMPONENT_BOUNDS_CHANGED, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, ACCESSIBLE_INVALIDATE_CHILDREN, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TABLE_CAPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED, ACCESSIBLE_TABLE_MODEL_CHANGED, ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_ROW_HEADER_CHANGED, ACCESSIBLE_TABLE_SUMMARY_CHANGED, ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent

构造方法摘要
`protected`	`Component.AccessibleAWTComponent()` 虽然该类是抽象的，但其所有子类都应该能够调用此方法。

方法摘要
`void`	`addFocusListener(FocusListener l)` 添加指定的焦点侦听器，以接收发自此组件的焦点事件。
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` 将 `PropertyChangeListener` 添加到侦听器列表中。
`boolean`	`contains(Point p)` 检查指定的点是否在此对象的边界内，该点的 x 坐标和 y 坐标是相对于该对象的坐标系来定义的。
`Accessible`	`getAccessibleAt(Point p)` 返回包含在局部坐标 `Point` 上的 `Accessible` 子对象（如果存在这样的对象）。
`Accessible`	`getAccessibleChild(int i)` 返回该对象的第 n 个 `Accessible` 子对象。
`int`	`getAccessibleChildrenCount()` 返回此对象中可访问的子对象数。
`AccessibleComponent`	`getAccessibleComponent()` 获取与此对象相关的 `AccessibleComponent`（如果存在一个这样的组件）。
`String`	`getAccessibleDescription()` 获取此对象的可访问描述。
`int`	`getAccessibleIndexInParent()` 获取此对象在其可访问父对象中的索引。
`String`	`getAccessibleName()` 获取此对象的可访问名称。
`Accessible`	`getAccessibleParent()` 获取此对象的 `Accessible` 父对象。
`AccessibleRole`	`getAccessibleRole()` 获取此对象的职责。
`AccessibleStateSet`	`getAccessibleStateSet()` 获取此对象的状态。
`Color`	`getBackground()` 获取此对象的背景色。
`Rectangle`	`getBounds()` 获取此对象的边界，用 Rectangle 对象的形式表示它。
`Cursor`	`getCursor()` 获取此对象的 `Cursor`。
`Font`	`getFont()` 获取此对象的 `Font`。
`FontMetrics`	`getFontMetrics(Font f)` 获取此对象的 `FontMetrics`。
`Color`	`getForeground()` 获取此对象的前景色。
`Locale`	`getLocale()` 返回此对象的区域。
`Point`	`getLocation()` 通过用一个点指定该对象的左上角在屏幕坐标空间中的位置的形式，获取此对象相对于父对象的位置。
`Point`	`getLocationOnScreen()` 返回对象在屏幕上的位置。
`Dimension`	`getSize()` 返回此对象的大小，用 `Dimension` 对象的形式表示它。
`boolean`	`isEnabled()` 确定是否启用了此对象。
`boolean`	`isFocusTraversable()` 返回对此对象是否可以接受焦点的判断。
`boolean`	`isShowing()` 确定是否正在显示该对象。
`boolean`	`isVisible()` 确定对象是否可见。
`void`	`removeFocusListener(FocusListener l)` 移除指定的焦点侦听器，以便它不再接收发自此组件的焦点事件。
`void`	`removePropertyChangeListener(PropertyChangeListener listener)` 将 PropertyChangeListener 从侦听器列表中移除。
`void`	`requestFocus()` 请求使此对象拥有焦点。
`void`	`setBackground(Color c)` 设置此对象的背景色。
`void`	`setBounds(Rectangle r)` 设置此对象的边界，用 `Rectangle` 对象的形式表示它。
`void`	`setCursor(Cursor cursor)` 设置此对象的 `Cursor`。
`void`	`setEnabled(boolean b)` 设置此对象的启用状态。
`void`	`setFont(Font f)` 设置此对象的 `Font`。
`void`	`setForeground(Color c)` 设置此对象的前景色。
`void`	`setLocation(Point p)` 设置对象相对父对象的位置。
`void`	`setSize(Dimension d)` 调整此对象的大小，使它具有宽度和高度。
`void`	`setVisible(boolean b)` 设置此对象的可见状态。

从类 javax.accessibility.AccessibleContext 继承的方法
`firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

字段详细信息

accessibleAWTComponentHandler

protected ComponentListener accessibleAWTComponentHandler

accessibleAWTFocusHandler

protected FocusListener accessibleAWTFocusHandler

构造方法详细信息

protected Component.AccessibleAWTComponent()

虽然该类是抽象的，但其所有子类都应该能够调用此方法。

方法详细信息

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

将 PropertyChangeListener 添加到侦听器列表中。

覆盖：: 类 AccessibleContext 中的 addPropertyChangeListener

参数：: listener - 要添加的属性更改侦听器
另请参见：: AccessibleContext.ACCESSIBLE_NAME_PROPERTY, AccessibleContext.ACCESSIBLE_DESCRIPTION_PROPERTY, AccessibleContext.ACCESSIBLE_STATE_PROPERTY, AccessibleContext.ACCESSIBLE_VALUE_PROPERTY, AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY, AccessibleContext.ACCESSIBLE_TEXT_PROPERTY, AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

将 PropertyChangeListener 从侦听器列表中移除。此方法移除了一个为所有属性注册的 PropertyChangeListener。

覆盖：: 类 AccessibleContext 中的 removePropertyChangeListener

参数：: listener - 要移除的 PropertyChangeListener

getAccessibleName

public String getAccessibleName()

获取此对象的可访问名称。此方法几乎从不返回 java.awt.Component.getName() 获取的名称，因为该名称通常不是一个本地化名称，并且对用户没有任何意义。如果对象根本就是一个文本对象（例如，一个菜单项），则可访问名称应该是该对象的文本（例如 "save"）。如果对象有一个工具提示，则工具提示文本还可以是要返回的适当 String。

覆盖：: 类 AccessibleContext 中的 getAccessibleName

返回：: 对象的本地化名称——如果此对象没有名称，则可以返回 null
另请参见：: AccessibleContext.setAccessibleName(java.lang.String)

getAccessibleDescription

public String getAccessibleDescription()

获取此对象的可访问描述。此描述应该是一个关于此对象是什么（即此对象对用户的意义）的简单本地化描述。如果对象有一个工具提示，则工具提示文本还可以是要返回的适当字符串，假定它包含对该对象的简单描述（而不仅仅只包含对象的名称，例如，工具栏上用 "save" 作为工具提示文本的 "Save" 图标不能将其工具提示文本作为描述返回，但像 "Saves the current text document" 之类的文本则可以作为描述返回）。

覆盖：: 类 AccessibleContext 中的 getAccessibleDescription

返回：: 对象的本地化描述——如果此对象没有描述，则可以返回 null
另请参见：: AccessibleContext.setAccessibleDescription(java.lang.String)

getAccessibleRole

public AccessibleRole getAccessibleRole()

获取此对象的职责。

指定者：: 类 AccessibleContext 中的 getAccessibleRole

返回：: 描述该对象职责的 AccessibleRole 的一个实例
另请参见：: AccessibleRole

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

获取此对象的状态。

指定者：: 类 AccessibleContext 中的 getAccessibleStateSet

返回：: 包含对象当前状态设置的 AccessibleStateSet 的一个实例
另请参见：: AccessibleState

getAccessibleParent

public Accessible getAccessibleParent()

获取此对象的 Accessible 父对象。如果此对象的父对象实现 Accessible，则此方法应该仅返回 getParent。

覆盖：: 类 AccessibleContext 中的 getAccessibleParent

返回：: 此对象的 Accessible 父对象——如果此对象没有 Accessible 父对象，则可以返回 null

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

获取此对象在其可访问父对象中的索引。

指定者：: 类 AccessibleContext 中的 getAccessibleIndexInParent

返回：: 此对象在其可访问父对象中的索引；如果此对象没有可访问的父对象，则返回 -1
另请参见：: getAccessibleParent()

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

返回此对象中可访问的子对象数。如果此对象的所有子对象都实现了 Accessible，那么此方法应该返回该对象的子对象数。

指定者：: 类 AccessibleContext 中的 getAccessibleChildrenCount

返回：: 返回此对象中可访问的子对象数

getAccessibleChild

public Accessible getAccessibleChild(int i)

返回该对象的第 n 个 Accessible 子对象。

指定者：: 类 AccessibleContext 中的 getAccessibleChild

参数：: i - 子对象的基于 0 的索引
返回：: 对象的第 n 个 Accessible 子对象
另请参见：: AccessibleContext.getAccessibleChildrenCount()

getLocale

public Locale getLocale()

返回此对象的区域。

指定者：: 类 AccessibleContext 中的 getLocale

返回：: 此对象的区域

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()

获取与此对象相关的 AccessibleComponent（如果存在一个这样的组件）。否则返回 null。

覆盖：: 类 AccessibleContext 中的 getAccessibleComponent

返回：: 组件
另请参见：: AccessibleComponent

getBackground

public Color getBackground()

获取此对象的背景色。

指定者：: 接口 AccessibleComponent 中的 getBackground

返回：: 该对象的背景色（如果受支持）；否则返回 null
另请参见：: AccessibleComponent.setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)

设置此对象的背景色。（有关透明度的信息，请参阅 isOpaque。）

指定者：: 接口 AccessibleComponent 中的 setBackground

参数：: c - 新的背景 Color
另请参见：: Component.isOpaque()

getForeground

public Color getForeground()

获取此对象的前景色。

指定者：: 接口 AccessibleComponent 中的 getForeground

返回：: 该对象的前景色（如果受支持）；否则返回 null
另请参见：: AccessibleComponent.setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)

设置此对象的前景色。

指定者：: 接口 AccessibleComponent 中的 setForeground

参数：: c - 新的前景 Color
另请参见：: AccessibleComponent.getForeground()

getCursor

public Cursor getCursor()

获取此对象的 Cursor。

指定者：: 接口 AccessibleComponent 中的 getCursor

返回：: 对象的 Cursor（如果受支持）；否则返回 null
另请参见：: AccessibleComponent.setCursor(java.awt.Cursor)

setCursor

public void setCursor(Cursor cursor)

设置此对象的 Cursor。

如果 Java 平台实现和/或本机系统不支持更改鼠标光标形状，则该方法可能不会产生任何视觉效果。

指定者：: 接口 AccessibleComponent 中的 setCursor

参数：: c - 对象的新 Cursor
另请参见：: AccessibleComponent.getCursor()

getFont

public Font getFont()

获取此对象的 Font。

指定者：: 接口 AccessibleComponent 中的 getFont

返回：: 对象的 Font（如果受支持）；否则返回 null
另请参见：: AccessibleComponent.setFont(java.awt.Font)

setFont

public void setFont(Font f)

设置此对象的 Font。

指定者：: 接口 AccessibleComponent 中的 setFont

参数：: f - 对象的新 Font
另请参见：: AccessibleComponent.getFont()

getFontMetrics

public FontMetrics getFontMetrics(Font f)

获取此对象的 FontMetrics。

指定者：: 接口 AccessibleComponent 中的 getFontMetrics

参数：: f - Font
返回：: 对象的 FontMetrics（如果受支持）；否则返回 null
另请参见：: getFont()

isEnabled

public boolean isEnabled()

确定是否启用了此对象。

指定者：: 接口 AccessibleComponent 中的 isEnabled

返回：: 如果启用了此对象，则返回 ture；否则返回 false
另请参见：: AccessibleComponent.setEnabled(boolean), AccessibleContext.getAccessibleStateSet(), AccessibleState.ENABLED, AccessibleStateSet

setEnabled

public void setEnabled(boolean b)

设置此对象的启用状态。

指定者：: 接口 AccessibleComponent 中的 setEnabled

参数：: b - 如果此参数为 ture，则启用此对象；否则将禁用它
另请参见：: AccessibleComponent.isEnabled()

isVisible

public boolean isVisible()

确定对象是否可见。注：这意味该对象应该是可见的；但事实上，可能因为包含此对象的对象之一是不可见的，所以此对象无法在屏幕上显示出来。使用 isShowing 来确定某个对象是否正显示在屏幕上。

指定者：: 接口 AccessibleComponent 中的 isVisible

返回：: 如果对象是可见的，则返回 ture；否则返回 false
另请参见：: AccessibleComponent.setVisible(boolean), AccessibleContext.getAccessibleStateSet(), AccessibleState.VISIBLE, AccessibleStateSet

setVisible

public void setVisible(boolean b)

设置此对象的可见状态。

指定者：: 接口 AccessibleComponent 中的 setVisible

参数：: b - 如果此参数为 ture，则显示对象；否则将隐藏它
另请参见：: AccessibleComponent.isVisible()

isShowing

public boolean isShowing()

确定是否正在显示该对象。这是通过检查该对象的可见性及其祖先来确定的。注：即使另一个对象掩藏了该对象（例如，它碰巧在一个下拉的菜单下面），此方法也将返回 true。

指定者：: 接口 AccessibleComponent 中的 isShowing

返回：: 如果正在显示该对象，则返回 ture；否则返回 false

contains

public boolean contains(Point p)

检查指定的点是否在此对象的边界内，该点的 x 坐标和 y 坐标是相对于该对象的坐标系来定义的。

指定者：: 接口 AccessibleComponent 中的 contains

参数：: p - 相对于该对象的坐标系的 Point
返回：: 如果该对象包含 Point，则返回 ture；否则返回 false
另请参见：: AccessibleComponent.getBounds()

getLocationOnScreen

public Point getLocationOnScreen()

返回对象在屏幕上的位置。

指定者：: 接口 AccessibleComponent 中的 getLocationOnScreen

返回：: 对象在屏幕上的位置——如果此对象不在屏幕上，则可以返回 null
另请参见：: AccessibleComponent.getBounds(), AccessibleComponent.getLocation()

getLocation

public Point getLocation()

通过用一个点指定该对象的左上角在屏幕坐标空间中的位置的形式，获取此对象相对于父对象的位置。

指定者：: 接口 AccessibleComponent 中的 getLocation

返回：: Point 的一个实例，这个 Point 表示了对象边界的左上角在屏幕坐标空间中的位置；如果此对象或其父对象不在屏幕上，则返回 null
另请参见：: AccessibleComponent.getBounds(), AccessibleComponent.getLocationOnScreen()

setLocation

public void setLocation(Point p)

设置对象相对父对象的位置。

指定者：: 接口 AccessibleComponent 中的 setLocation

参数：: p - 对象的坐标
另请参见：: AccessibleComponent.getLocation()

getBounds

public Rectangle getBounds()

获取此对象的边界，用 Rectangle 对象的形式表示它。这些边界了指定此对象的宽度、高度和相对其父对象的位置。

指定者：: 接口 AccessibleComponent 中的 getBounds

返回：: 指示该组件的边界的一个矩形；如果此对象不在屏幕上，则返回 null
另请参见：: AccessibleComponent.contains(java.awt.Point)

setBounds

public void setBounds(Rectangle r)

设置此对象的边界，用 Rectangle 对象的形式表示它。这些边界了指定此对象的宽度、高度和相对其父对象的位置。

指定者：: 接口 AccessibleComponent 中的 setBounds

参数：: r - 指示该组件的边界的一个矩形
另请参见：: AccessibleComponent.getBounds()

getSize

public Dimension getSize()

返回此对象的大小，用 Dimension 对象的形式表示它。Dimension 对象的 height 字段包含此对象的高度，Dimension 对象的 width 字段包含此对象的宽度。

指定者：: 接口 AccessibleComponent 中的 getSize

返回：: 指示此组件大小的一个 Dimension 对象；如果此对象不在屏幕上，则返回 null
另请参见：: AccessibleComponent.setSize(java.awt.Dimension)

setSize

public void setSize(Dimension d)

调整此对象的大小，使它具有宽度和高度。

指定者：: 接口 AccessibleComponent 中的 setSize

参数：: d - 指定对象新大小的尺寸
另请参见：: AccessibleComponent.getSize()

getAccessibleAt

public Accessible getAccessibleAt(Point p)

返回包含在局部坐标 Point 上的 Accessible 子对象（如果存在这样的对象）。否则返回 null。

指定者：: 接口 AccessibleComponent 中的 getAccessibleAt

参数：: p - 定义 Accessible 左上角的点，在该对象的父对象的坐标空间内给定此点
返回：: 如果存在 Accessible，则在指定的位置上返回这个点；否则返回 null

isFocusTraversable

public boolean isFocusTraversable()

返回对此对象是否可以接受焦点的判断。

指定者：: 接口 AccessibleComponent 中的 isFocusTraversable

返回：: 如果对象可以接受焦点，则返回 ture；否则返回 false
另请参见：: AccessibleContext.getAccessibleStateSet(), AccessibleState.FOCUSABLE, AccessibleState.FOCUSED, AccessibleStateSet

requestFocus

public void requestFocus()

请求使此对象拥有焦点。

指定者：: 接口 AccessibleComponent 中的 requestFocus

另请参见：: AccessibleComponent.isFocusTraversable()

addFocusListener

public void addFocusListener(FocusListener l)

添加指定的焦点侦听器，以接收发自此组件的焦点事件。

指定者：: 接口 AccessibleComponent 中的 addFocusListener

参数：: l - 焦点侦听器
另请参见：: AccessibleComponent.removeFocusListener(java.awt.event.FocusListener)

removeFocusListener

public void removeFocusListener(FocusListener l)

移除指定的焦点侦听器，以便它不再接收发自此组件的焦点事件。

指定者：: 接口 AccessibleComponent 中的 removeFocusListener

参数：: l - 焦点侦听器
另请参见：: AccessibleComponent.addFocusListener(java.awt.event.FocusListener)

概述