Module java.desktop

软件包 java.awt

Class Component.AccessibleAWTComponent

java.lang.Object

javax.accessibility.AccessibleContext

java.awt.Component.AccessibleAWTComponent

All Implemented Interfaces:

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

Enclosing class:

Component

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

组件的内部类用于为辅助功能提供默认支持。 这个类不是由应用程序开发人员直接使用，而是意味着仅由组件开发人员进行子类化。

该类用于获取此对象的可访问角色。

从以下版本开始：

1.3

另请参见：

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	描述
protected class	Component.AccessibleAWTComponent.AccessibleAWTComponentHandler	Fire PropertyChange监听器，如果已注册，显示/隐藏..
protected class	Component.AccessibleAWTComponent.AccessibleAWTFocusHandler	Fire PropertyChange监听器，如果有注册，焦点事件发生时

Field Summary

Fields

Modifier and Type	Field	描述
protected ComponentListener	accessibleAWTComponentHandler	组件侦听器，用于跟踪show / hide / resize事件并将其转换为PropertyChange事件。
protected FocusListener	accessibleAWTFocusHandler	监听焦点事件并将其转换为PropertyChange事件的侦听器。

Fields inherited from class 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

构造方法摘要

构造方法

Modifier	Constructor	描述
protected	AccessibleAWTComponent()	虽然这个类是抽象的，但这应该由所有子类调用。

方法摘要

Modifier and Type	方法	描述
void	addFocusListener(FocusListener l)	新新新200新新新200新新新200新新新200新新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新
void	addPropertyChangeListener(PropertyChangeListener listener)	添加一个 PropertyChangeListener到侦听器列表。
boolean	contains(Point p)	检查指定点是否在该对象的边界内，其中该点的x和y坐标被定义为相对于该对象的坐标系。
Accessible	getAccessibleAt(Point p)	返回 Accessible小孩（如果存在），包含在本地坐标 Point 。
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)	设置对象的可见状态。

Methods inherited from class javax.accessibility.AccessibleContext

firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

accessibleAWTComponentHandler

protected ComponentListener accessibleAWTComponentHandler

组件侦听器，用于跟踪show / hide / resize事件并将其转换为PropertyChange事件。

accessibleAWTFocusHandler

protected FocusListener accessibleAWTFocusHandler

监听焦点事件并将其转换为PropertyChange事件的侦听器。

构造方法详细信息

AccessibleAWTComponent

protected AccessibleAWTComponent()

虽然这个类是抽象的，但这应该由所有子类调用。

方法详细信息

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

添加 PropertyChangeListener到侦听器列表。

重写：

addPropertyChangeListener在 AccessibleContext

参数

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。

重写：

removePropertyChangeListener在类 AccessibleContext

参数

listener - 要删除的PropertyChangeListener

getAccessibleName

public String getAccessibleName()

获取此对象的可访问名称。 这几乎永远不会返回java.awt.Component.getName() ，因为这通常不是本地化的名称，对用户没有意义。 如果对象基本上是文本对象（例如菜单项），可访问名称应该是对象的文本（例如“保存”）。 如果对象有一个工具提示，工具提示文本也可能是一个适当的String返回。

重写：

getAccessibleName在 AccessibleContext

结果

对象的本地化名称 - 如果此对象没有名称，则可以是 null

另请参见：

AccessibleContext.setAccessibleName(java.lang.String)

getAccessibleDescription

public String getAccessibleDescription()

获取此对象的可访问描述。 这应该是对这个对象的简明的本地化描述 - 它对用户的意义。 如果对象具有工具提示，则工具提示文本可能是要返回的适当字符串，假设它包含对象的简明描述（而不仅仅是对象的名称），例如工具栏上的“保存”图标，该对象具有“保存“因为工具提示文本不应该返回工具提示文本作为说明，而是像”保存当前文本文档“一样。

重写：

getAccessibleDescription在 AccessibleContext

结果

对象的本地化描述可以是 null如果该对象没有描述

另请参见：

AccessibleContext.setAccessibleDescription(java.lang.String)

getAccessibleRole

public AccessibleRole getAccessibleRole()

获得此对象的作用。

Specified by:

getAccessibleRole在 AccessibleContext

结果

描述对象的作用的一个 AccessibleRole的实例

另请参见：

AccessibleRole

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

获取此对象的状态。

Specified by:

getAccessibleStateSet在 AccessibleContext

结果

一个 AccessibleStateSet的实例包含对象的当前状态集

另请参见：

AccessibleState

getAccessibleParent

public Accessible getAccessibleParent()

获取此对象的Accessible父项。 如果这个对象的父对象实现了Accessible ，这个方法应该简单地返回getParent 。

重写：

getAccessibleParent在 AccessibleContext

结果

该对象的 Accessible父对象可以是 null如果此对象没有 Accessible父项

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

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

Specified by:

getAccessibleIndexInParent在 AccessibleContext

结果

该对象在其父项中的索引; 如果此对象没有可访问的父对象，则为-1

另请参见：

getAccessibleParent()

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

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

Specified by:

getAccessibleChildrenCount在 AccessibleContext

结果

对象中可访问的孩子的数量

getAccessibleChild

public Accessible getAccessibleChild(int i)

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

Specified by:

getAccessibleChild在 AccessibleContext

参数

i - 基于零的儿童索引

结果

对象的第n个 Accessible孩子

另请参见：

AccessibleContext.getAccessibleChildrenCount()

getLocale

public Locale getLocale()

返回此对象的区域设置。

Specified by:

getLocale在 AccessibleContext

结果

该对象的区域设置

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()

获取与此对象关联的AccessibleComponent如果存在）。 否则返回null 。

重写：

getAccessibleComponent在 AccessibleContext

结果

组件

另请参见：

AccessibleComponent

getBackground

public Color getBackground()

获取此对象的背景颜色。

Specified by:

getBackground在接口 AccessibleComponent

结果

对象的背景颜色（如果支持）; 否则， null

另请参见：

AccessibleComponent.setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)

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

Specified by:

setBackground在接口 AccessibleComponent

参数

c - 新的 Color为背景

另请参见：

Component.isOpaque()

getForeground

public Color getForeground()

获取此对象的前景色。

Specified by:

getForeground在接口 AccessibleComponent

结果

对象的前景颜色（如果支持）; 否则， null

另请参见：

AccessibleComponent.setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)

设置此对象的前景色。

Specified by:

setForeground在接口 AccessibleComponent

参数

c - 新的 Color为前景

另请参见：

AccessibleComponent.getForeground()

getCursor

public Cursor getCursor()

获取此对象的 Cursor 。

Specified by:

getCursor在接口 AccessibleComponent

结果

Cursor ，如果支持，则该对象; 否则， null

另请参见：

AccessibleComponent.setCursor(java.awt.Cursor)

setCursor

public void setCursor(Cursor cursor)

设置此对象的Cursor 。

如果Java平台实现和/或本地系统不支持更改鼠标光标的形状，该方法可能没有视觉效果。

Specified by:

setCursor在接口 AccessibleComponent

参数

cursor - 新的 Cursor为对象

另请参见：

AccessibleComponent.getCursor()

getFont

public Font getFont()

获取此对象的 Font 。

Specified by:

getFont在接口 AccessibleComponent

结果

Font ，如果支持，则为该对象; 否则， null

另请参见：

AccessibleComponent.setFont(java.awt.Font)

setFont

public void setFont(Font f)

设置该对象的 Font 。

Specified by:

setFont在接口 AccessibleComponent

参数

f - 新的 Font的对象

另请参见：

AccessibleComponent.getFont()

getFontMetrics

public FontMetrics getFontMetrics(Font f)

获取此对象的 FontMetrics 。

Specified by:

getFontMetrics在接口 AccessibleComponent

参数

f - Font

结果

FontMetrics ，如果支持，则该对象; 否则， null

另请参见：

getFont()

isEnabled

public boolean isEnabled()

确定对象是否已启用。

Specified by:

isEnabled在接口 AccessibleComponent

结果

如果对象启用，则为true; 否则，假

另请参见：

AccessibleComponent.setEnabled(boolean) ， AccessibleContext.getAccessibleStateSet() ， AccessibleState.ENABLED ， AccessibleStateSet

setEnabled

public void setEnabled(boolean b)

设置对象的已启用状态。

Specified by:

setEnabled在接口 AccessibleComponent

参数

b - 如果为true，则启用此对象; 否则，禁用它

另请参见：

AccessibleComponent.isEnabled()

isVisible

public boolean isVisible()

确定对象是否可见。 注意：这意味着该对象意图可见; 然而，它可能不会在屏幕上显示，因为该对象包含的对象之一是不可见的。 要确定对象是否在屏幕上显示，请使用isShowing 。

Specified by:

isVisible在接口 AccessibleComponent

结果

如果对象可见，则为true; 否则，假

另请参见：

AccessibleComponent.setVisible(boolean) ， AccessibleContext.getAccessibleStateSet() ， AccessibleState.VISIBLE ， AccessibleStateSet

setVisible

public void setVisible(boolean b)

设置对象的可见状态。

Specified by:

setVisible在接口 AccessibleComponent

参数

b - 如果为真，则显示此对象; 否则隐藏它

另请参见：

AccessibleComponent.isVisible()

isShowing

public boolean isShowing()

确定对象是否正在显示。 这是通过检查对象和对象的祖先的可见性来确定的。 注意：即使对象被另一个遮挡（例如，恰好在被拉下的菜单下方），这将返回true。

Specified by:

isShowing在接口 AccessibleComponent

结果

如果对象显示，则为true; 否则，假

contains

public boolean contains(Point p)

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

Specified by:

contains在接口 AccessibleComponent

参数

p - 相对于对象的坐标系的 Point

结果

如果对象包含Point ; 否则为虚假

另请参见：

AccessibleComponent.getBounds()

getLocationOnScreen

public Point getLocationOnScreen()

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

Specified by:

getLocationOnScreen在接口 AccessibleComponent

结果

屏幕上对象的位置 - 如果此对象不在屏幕上，可以是 null

另请参见：

AccessibleComponent.getBounds() ， AccessibleComponent.getLocation()

getLocation

public Point getLocation()

以指定对象的左上角的点的形式获取对象相对于父对象的位置。

Specified by:

getLocation在接口 AccessibleComponent

结果

Point的一个实例代表屏幕坐标空间中对象边界的左上角; 如果此对象或其父对象不在屏幕上， null

另请参见：

AccessibleComponent.getBounds() ， AccessibleComponent.getLocationOnScreen()

setLocation

public void setLocation(Point p)

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

Specified by:

setLocation在接口 AccessibleComponent

参数

p - 对象的坐标

另请参见：

AccessibleComponent.getLocation()

getBounds

public Rectangle getBounds()

以Rectangle对象的形式获取此对象的边界。 边界指定相对于其父对象的宽度，高度和位置。

Specified by:

getBounds在接口 AccessibleComponent

结果

表示该组件边界的矩形; null如果此对象不在屏幕上

另请参见：

AccessibleComponent.contains(java.awt.Point)

setBounds

public void setBounds(Rectangle r)

以Rectangle对象的形式设置此对象的边界。 边界指定相对于其父对象的宽度，高度和位置。

Specified by:

setBounds在接口 AccessibleComponent

参数

r - 表示此组件边界的矩形

另请参见：

AccessibleComponent.getBounds()

getSize

public Dimension getSize()

以Dimension对象的形式返回此对象的大小。 Dimension对象的height字段包含此对象的高度，而Dimension对象的width字段包含此对象的宽度。

Specified by:

getSize在接口 AccessibleComponent

结果

一个表示该组件大小的Dimension对象; 如果此对象不在屏幕上， null

另请参见：

AccessibleComponent.setSize(java.awt.Dimension)

setSize

public void setSize(Dimension d)

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

Specified by:

setSize在接口 AccessibleComponent

参数

d - 指定对象的新大小的维度

另请参见：

AccessibleComponent.getSize()

getAccessibleAt

public Accessible getAccessibleAt(Point p)

返回Accessible小孩（如果存在），包含在本地坐标Point 。 否则返回null 。

Specified by:

getAccessibleAt在接口 AccessibleComponent

参数

p -定义的左上角点 Accessible ，在对象的父对象的坐标空间中给出

结果

Accessible如果存在，在指定的位置; 其他null

isFocusTraversable

public boolean isFocusTraversable()

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

Specified by:

isFocusTraversable在接口 AccessibleComponent

结果

true如果对象可以接受焦点; 否则为虚假

另请参见：

AccessibleContext.getAccessibleStateSet() ， AccessibleState.FOCUSABLE ， AccessibleState.FOCUSED ， AccessibleStateSet

requestFocus

public void requestFocus()

请求关注此对象。

Specified by:

requestFocus在接口 AccessibleComponent

另请参见：

AccessibleComponent.isFocusTraversable()

addFocusListener

public void addFocusListener(FocusListener l)

新新新200新新新200新新新200新新新200新新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新200新新

Specified by:

addFocusListener在接口 AccessibleComponent

参数

l - 焦点侦听器

另请参见：

AccessibleComponent.removeFocusListener(java.awt.event.FocusListener)

removeFocusListener

public void removeFocusListener(FocusListener l)

删除指定的焦点侦听器，使其不再从此组件接收焦点事件。

Specified by:

removeFocusListener在接口 AccessibleComponent

参数

l - 焦点侦听器

另请参见：

AccessibleComponent.addFocusListener(java.awt.event.FocusListener)