模块 java.desktop

软件包 java.awt

Class 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

Enclosing class:

Component

protected abstract class Component.AccessibleAWTComponentextends AccessibleContextimplements Serializable, AccessibleComponent

用于为可访问性提供默认支持的Component的内部类。 此类不应由应用程序开发人员直接使用，而是仅由组件开发人员进行子类化。

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

从以下版本开始：

1.3

另请参见：

Serialized Form

嵌套类汇总

嵌套类

变量和类型	类	描述
protected class	Component.AccessibleAWTComponent.AccessibleAWTComponentHandler	Fire PropertyChange侦听器，如果已注册，则显示/隐藏时
protected class	Component.AccessibleAWTComponent.AccessibleAWTFocusHandler	Fire PropertyChange侦听器（如果已注册）在焦点事件发生时

字段汇总

字段

变量和类型	字段	描述
protected ComponentListener	accessibleAWTComponentHandler	用于跟踪显示/隐藏/调整大小事件并将其转换为PropertyChange事件的组件侦听器。
protected FocusListener	accessibleAWTFocusHandler	侦听器，用于跟踪焦点事件并将其转换为PropertyChange事件。

声明的属性在类 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	AccessibleAWTComponent()	虽然该类是抽象的，但应该由所有子类调用。

方法摘要

变量和类型	方法	描述
void	addFocusListener(FocusListener l)	添加指定的焦点侦听器以从此组件接收焦点事件。
void	addPropertyChangeListener(PropertyChangeListener listener)	将 PropertyChangeListener添加到侦听器列表中。
boolean	contains(Point p)	检查指定的点是否在此对象的边界内，其中点的x和y坐标定义为相对于对象的坐标系。
Accessible	getAccessibleAt(Point p)	返回 Accessible子 Accessible （如果存在），包含在本地坐标 Point 。
Accessible	getAccessibleChild(int i)	返回对象的第n个 Accessible子 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

用于跟踪显示/隐藏/调整大小事件并将其转换为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() ，因为它通常不是本地化名称，并且对用户没有意义。 如果对象基本上是文本对象（例如菜单项），则可访问的名称应该是对象的文本（例如“保存”）。 如果对象具有工具提示，则工具提示文本也可能是要返回的适当字符串。

重写：

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此对象的父级 - 如果此对象没有 Accessible父 null则可以是 null

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

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

Specified by:

getAccessibleIndexInParent在课程 AccessibleContext

结果

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

另请参见：

getAccessibleParent()

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

返回对象中可访问的子级数。 如果此对象的所有子项都实现Accessible ，则此方法应返回此对象的子项数。

Specified by:

getAccessibleChildrenCount在课程 AccessibleContext

结果

对象中可访问的子项数

getAccessibleChild

public Accessible getAccessibleChild(int i)

返回对象的第n个 Accessible子 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 - 如果为true，则显示此对象; 否则，隐藏它

另请参见：

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 ， Point true;否则为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对象的高度字段包含此对象的高度， Dimension对象的宽度字段包含此对象的宽度。

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子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)

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

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)