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

构造方法摘要

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

构造方法详细信息

Component.AccessibleAWTComponent

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)