Module java.desktop

Package 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

封装类:

Component

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

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

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

自JDK版本:

1.3

参见:

• 序列化形式

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	Component.AccessibleAWTComponent.AccessibleAWTComponentHandler	当显示/隐藏时，触发PropertyChange监听器（如果已注册）。
protected class	Component.AccessibleAWTComponent.AccessibleAWTFocusHandler	当焦点事件发生时，触发PropertyChange监听器（如果已注册）。

Field Summary

Fields

Modifier and Type	Field	Description
protected ComponentListener	accessibleAWTComponentHandler	用于跟踪显示/隐藏/调整大小事件并将其转换为PropertyChange事件的组件监听器。
protected FocusListener	accessibleAWTFocusHandler	用于跟踪焦点事件并将其转换为PropertyChange事件的监听器。

Fields declared in 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

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AccessibleAWTComponent()	尽管该类是抽象的，但所有子类都应该调用此方法。

Method Summary

Modifier and Type	Method	Description
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)	设置对象的可见状态。

Methods declared in class javax.accessibility.AccessibleContext

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

Methods declared in class java.lang.Object

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

Field Details

accessibleAWTComponentHandler

             protected ComponentListener accessibleAWTComponentHandler
            

用于跟踪显示/隐藏/调整大小事件并将其转换为PropertyChange事件的组件监听器。

accessibleAWTFocusHandler

             protected FocusListener accessibleAWTFocusHandler
            

用于跟踪焦点事件并将其转换为PropertyChange事件的监听器。

Constructor Details

AccessibleAWTComponent

             protected AccessibleAWTComponent()
            

尽管该类是抽象的，但所有子类都应该调用此方法。

Method Details

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

获取此对象的角色。

指定由:

getAccessibleRole 在类 AccessibleContext中

返回:

描述对象角色的AccessibleRole实例

另请参阅:

• AccessibleRole

getAccessibleStateSet

             public AccessibleStateSet getAccessibleStateSet()
            

获取此对象的状态。

指定由:

getAccessibleStateSet 在类 AccessibleContext中

返回:

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

另请参阅:

• AccessibleState

getAccessibleParent

             public Accessible getAccessibleParent()
            

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

覆盖:

getAccessibleParent 在类 AccessibleContext中

返回:

此对象的Accessible父级 -- 如果此对象没有Accessible父级，则可以为null

getAccessibleIndexInParent

             public int getAccessibleIndexInParent()
            

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

指定由:

getAccessibleIndexInParent 在类 AccessibleContext中

返回:

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

另请参阅:

• getAccessibleParent()

getAccessibleChildrenCount

             public int getAccessibleChildrenCount()
            

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

指定由:

getAccessibleChildrenCount 在类 AccessibleContext中

返回:

对象中可访问的子对象数

getAccessibleChild

             public Accessible getAccessibleChild(int i)
            

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

指定由:

getAccessibleChild 在类 AccessibleContext中

参数:

i - 子对象的从零开始的索引

返回:

对象的第n个Accessible子对象

另请参阅:

• AccessibleContext.getAccessibleChildrenCount()

getLocale

             public Locale getLocale()
            

返回此对象的区域设置。

指定由:

getLocale 在类 AccessibleContext中

返回:

此对象的区域设置

getAccessibleComponent

             public AccessibleComponent getAccessibleComponent()
            

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

覆盖:

getAccessibleComponent 在类 AccessibleContext中

返回:

组件

另请参阅:

• AccessibleComponent

getBackground

             public Color getBackground()
            

获取此对象的背景颜色。

指定由:

getBackground 在接口 AccessibleComponent中

返回:

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

另请参阅:

• AccessibleComponent.setBackground(java.awt.Color)

setBackground

             public void setBackground(Color c)
            

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

指定由:

setBackground 在接口 AccessibleComponent中

参数:

c - 背景的新Color

另请参阅:

• Component.isOpaque()

getForeground

             public Color getForeground()
            

获取此对象的前景颜色。

指定由:

getForeground 在接口 AccessibleComponent中

返回:

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

另请参阅:

• AccessibleComponent.setForeground(java.awt.Color)

setForeground

             public void setForeground(Color c)
            

设置此对象的前景颜色。

指定由:

setForeground 在接口 AccessibleComponent中

参数:

c - 前景的新Color

另请参阅:

• AccessibleComponent.getForeground()

getCursor

             public Cursor getCursor()
            

获取此对象的Cursor。

指定由:

getCursor 在接口 AccessibleComponent中

返回:

对象的Cursor（如果支持）；否则为null

另请参阅:

• AccessibleComponent.setCursor(java.awt.Cursor)

setCursor

             public void setCursor(Cursor cursor)
            

设置此对象的Cursor。

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

指定由:

setCursor 在接口 AccessibleComponent中

参数:

cursor - 对象的新Cursor

另请参阅:

• AccessibleComponent.getCursor()

getFont

             public Font getFont()
            

获取此对象的Font。

指定由:

getFont 在接口 AccessibleComponent中

返回:

对象的Font（如果支持）；否则为null

另请参阅:

• AccessibleComponent.setFont(java.awt.Font)

setFont

             public void setFont(Font f)
            

设置此对象的Font。

指定由:

setFont 在接口 AccessibleComponent中

参数:

f - 对象的新Font

另请参阅:

• AccessibleComponent.getFont()

getFontMetrics

             public FontMetrics getFontMetrics(Font f)
            

获取此对象的FontMetrics。

指定者:

getFontMetrics 在接口 AccessibleComponent中

参数:

f - 字体Font

返回值:

如果支持，则返回FontMetrics对象；否则返回null

参见:

• getFont()

isEnabled

             public boolean isEnabled()
            

确定对象是否已启用。

指定者:

isEnabled 在接口 AccessibleComponent中

返回值:

如果对象已启用，则返回true；否则返回false

参见:

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

setEnabled

             public void setEnabled(boolean b)
            

设置对象的启用状态。

指定者:

setEnabled 在接口 AccessibleComponent中

参数:

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

参见:

• AccessibleComponent.isEnabled()

isVisible

             public boolean isVisible()
            

确定对象是否可见。注意：这意味着对象打算可见；但实际上可能不会显示在屏幕上，因为包含此对象的某个对象不可见。要确定对象是否显示在屏幕上，请使用isShowing。

指定者:

isVisible 在接口 AccessibleComponent中

返回值:

如果对象可见，则返回true；否则返回false

参见:

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

setVisible

             public void setVisible(boolean b)
            

设置对象的可见状态。

指定者:

setVisible 在接口 AccessibleComponent中

参数:

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

参见:

• AccessibleComponent.isVisible()

isShowing

             public boolean isShowing()
            

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

指定者:

isShowing 在接口 AccessibleComponent中

返回值:

如果对象正在显示，则返回true；否则返回false

contains

             public boolean contains(Point p)
            

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

指定者:

contains 在接口 AccessibleComponent中

参数:

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

返回值:

如果对象包含Point，则返回true；否则返回false

参见:

• AccessibleComponent.getBounds()

getLocationOnScreen

             public Point getLocationOnScreen()
            

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

指定者:

getLocationOnScreen 在接口 AccessibleComponent中

返回值:

对象在屏幕上的位置 -- 如果此对象不在屏幕上，则可能为null

参见:

• AccessibleComponent.getBounds()
• AccessibleComponent.getLocation()

getLocation

             public Point getLocation()
            

以指定点作为对象相对于父级的位置返回一个指定对象的左上角在屏幕坐标空间中的点。

指定者:

getLocation 在接口 AccessibleComponent中

返回值:

一个表示对象边界左上角在屏幕坐标空间中的点的Point实例；如果此对象或其父级不在屏幕上，则返回null

参见:

• AccessibleComponent.getBounds()
• AccessibleComponent.getLocationOnScreen()

setLocation

             public void setLocation(Point p)
            

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

指定者:

setLocation 在接口 AccessibleComponent中

参数:

p - 对象的坐标

参见:

• AccessibleComponent.getLocation()

getBounds

             public Rectangle getBounds()
            

以Rectangle对象的形式返回此对象的边界。边界指定此对象相对于其父级的宽度、高度和位置。

指定者:

getBounds 在接口 AccessibleComponent中

返回值:

指示此组件边界的矩形；如果此对象不在屏幕上，则返回null

参见:

• AccessibleComponent.contains(java.awt.Point)

setBounds

             public void setBounds(Rectangle r)
            

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

指定者:

setBounds 在接口 AccessibleComponent中

参数:

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

参见:

• AccessibleComponent.getBounds()

getSize

             public Dimension getSize()
            

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

指定者:

getSize 在接口 AccessibleComponent中

返回值:

一个指示此组件大小的Dimension对象；如果此对象不在屏幕上，则返回null

参见:

• AccessibleComponent.setSize(java.awt.Dimension)

setSize

             public void setSize(Dimension d)
            

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

指定者:

setSize 在接口 AccessibleComponent中

参数:

d - 指定对象新尺寸的维度

参见:

• AccessibleComponent.getSize()

getAccessibleAt

             public Accessible getAccessibleAt(Point p)
            

返回本地坐标Point处包含的Accessible子级（如果存在）。否则返回null。

指定者:

getAccessibleAt 在接口 AccessibleComponent中

参数:

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

返回:

指定位置处的Accessible（如果存在）；否则null

isFocusTraversable

             public boolean isFocusTraversable()
            

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

指定者:

isFocusTraversable 在接口 AccessibleComponent中

返回:

如果对象可以接受焦点，则为true；否则为false

参见:

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

requestFocus

             public void requestFocus()
            

为此对象请求焦点。

指定者:

requestFocus 在接口 AccessibleComponent中

参见:

• AccessibleComponent.isFocusTraversable()

addFocusListener

             public void addFocusListener(FocusListener l)
            

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

指定者:

addFocusListener 在接口 AccessibleComponent中

参数:

l - 焦点侦听器

参见:

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

removeFocusListener

             public void removeFocusListener(FocusListener l)
            

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

指定者:

removeFocusListener 在接口 AccessibleComponent中

参数:

l - 焦点侦听器

参见:

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