JavaTM 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
 
构造方法摘要
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)

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策