java.awt
类 MenuComponent.AccessibleAWTMenuComponent

java.lang.Object
  javax.accessibility.AccessibleContext
      java.awt.MenuComponent.AccessibleAWTMenuComponent

所有已实现的接口：

Serializable, AccessibleComponent, AccessibleSelection

直接已知子类：

MenuBar.AccessibleAWTMenuBar, MenuItem.AccessibleAWTMenuItem

正在封闭类：

MenuComponent

protected abstract class MenuComponent.AccessibleAWTMenuComponent
     

      extends 
      AccessibleContext
     
     

      implements 
      Serializable, 
      AccessibleComponent, 
      AccessibleSelection
     

用于为可访问性提供默认支持的 MenuComponent 的内部类。此类不能由应用程序开发人员直接使用，只能由菜单组件开发人员为其创建子类。

可以使用该类来获得此对象的可访问功能。

从以下版本开始：

1.3

另请参见：

序列化表格

字段摘要

从类 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

MenuComponent.AccessibleAWTMenuComponent() 尽管该类是抽象的，但是应该可以通过所有子类调用它。

方法摘要

void	addAccessibleSelection(int i) 将该对象的指定 Accessible 子对象添加到该对象的选择中。
void	addFocusListener(FocusListener l) 添加指定的焦点侦听器，以从此组件接收焦点事件。
void	clearAccessibleSelection() 清除该对象中的选择，使该对象中没有子对象被选择。
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() 获取此对象的职责。
AccessibleSelection	getAccessibleSelection() 获取与此对象关联的 AccessibleSelection，该对象允许选择其 Accessible 子对象。
Accessible	getAccessibleSelection(int i) 返回 Accessible，它表示该对象中指定的已选择的子对象。
int	getAccessibleSelectionCount() 返回当前选择的 Accessible 子对象数。
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	isAccessibleChildSelected(int i) 确定是否选择此对象的当前子对象。
boolean	isEnabled() 确定是否启用该对象。
boolean	isFocusTraversable() 返回此对象是否可以接受焦点。
boolean	isShowing() 确定该对象是否正在显示。
boolean	isVisible() 确定该对象是否可见。
void	removeAccessibleSelection(int i) 从对象的选择中移除该对象的指定子对象。
void	removeFocusListener(FocusListener l) 移除指定的焦点侦听器，使之不再从此组件接收焦点事件。
void	requestFocus() 请求此对象的焦点。
void	selectAllAccessibleSelection() 如果该对象支持多个选择，则会导致该对象的每个子对象都被选择。
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 继承的方法

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

从类 java.lang.Object 继承的方法

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

构造方法详细信息

MenuComponent.AccessibleAWTMenuComponent

protected MenuComponent.AccessibleAWTMenuComponent()

尽管该类是抽象的，但是应该可以通过所有子类调用它。

方法详细信息

getAccessibleSelection

public AccessibleSelection getAccessibleSelection()

获取与此对象关联的 AccessibleSelection，该对象允许选择其 Accessible 子对象。

覆盖：

类 AccessibleContext 中的 getAccessibleSelection

返回：

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

另请参见：

AccessibleSelection

getAccessibleName

public String getAccessibleName()

获取此对象的可访问的名称。几乎永远不应返回 java.awt.MenuComponent.getName，因为它通常不是一个本地化的名称，对用户来说，该名称没有任何意义。如果该对象从根本上说是一个文本对象（例如，菜单项），那么可访问的名称应是该对象的文本（例如，“保存”）。如果该对象有工具提示，则工具提示文本还可以是要返回的适当的 String。

覆盖：

类 AccessibleContext 中的 getAccessibleName

返回：

如果此对象没有名称，则返回该对象的本地化名称——可以为 null

另请参见：

AccessibleContext.setAccessibleName(java.lang.String)

getAccessibleDescription

public String getAccessibleDescription()

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

覆盖：

类 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 - 从零开始的子对象索引

返回：

该对象的第 n 个可访问子对象

另请参见：

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

返回：

该对象的 Curso（如果受支持）；否则返回 null

另请参见：

AccessibleComponent.setCursor(java.awt.Cursor)

setCursor

public void setCursor(Cursor cursor)

设置此对象的 Cursor。

如果 Java 平台实现和/或本机系统不支持更改鼠标光标形状，则该方法可能不会产生任何视觉效果。

指定者：

接口 AccessibleComponent 中的 setCursor

参数：

cursor - 该对象的新 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

返回：

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

另请参见：

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

setEnabled

public void setEnabled(boolean b)

设置该对象的启用状态。

指定者：

接口 AccessibleComponent 中的 setEnabled

参数：

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

另请参见：

AccessibleComponent.isEnabled()

isVisible

public boolean isVisible()

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

指定者：

接口 AccessibleComponent 中的 isVisible

返回：

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

另请参见：

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

setVisible

public void setVisible(boolean b)

设置该对象的可见状态。

指定者：

接口 AccessibleComponent 中的 setVisible

参数：

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

另请参见：

AccessibleComponent.isVisible()

isShowing

public boolean isShowing()

确定该对象是否正在显示。通过检查该对象的可见性和祖先可确定这一点。注：这将返回 true，即使该对象被另一个对象遮掩（例如，该对象碰巧在下拉菜单的下面）。

指定者：

接口 AccessibleComponent 中的 isShowing

返回：

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

contains

public boolean contains(Point p)

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

指定者：

接口 AccessibleComponent 中的 contains

参数：

p - 与该对象的坐标系相关的 Point

返回：

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

另请参见：

AccessibleComponent.getBounds()

getLocationOnScreen

public Point getLocationOnScreen()

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

指定者：

接口 AccessibleComponent 中的 getLocationOnScreen

返回：

如果此对象不在屏幕上，则返回屏幕上对象的位置为 null

另请参见：

AccessibleComponent.getBounds(), AccessibleComponent.getLocation()

getLocation

public Point getLocation()

以点（指定屏幕坐标空间中对象的左上角）的形式获取该对象相对于父对象的位置。

指定者：

接口 AccessibleComponent 中的 getLocation

返回：

表示该屏幕坐标空间中对象边界的左上角的 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 对象的高度字段包含此对象的高度， Dimension 对象的宽度字段包含此对象的宽度。

指定者：

接口 AccessibleComponent 中的 getSize

返回：

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

另请参见：

AccessibleComponent.setSize(java.awt.Dimension)

setSize

public void setSize(Dimension d)

调整此对象的大小。

指定者：

接口 AccessibleComponent 中的 setSize

参数：

d - - 指定该对象新的大小的 Dimension

另请参见：

AccessibleComponent.getSize()

getAccessibleAt

public Accessible getAccessibleAt(Point p)

返回本地坐标 Point 包含的 Accessible 子对象（如果存在）。如果没有 Accessible 子对象，则返回 null。

指定者：

接口 AccessibleComponent 中的 getAccessibleAt

参数：

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

返回：

如果 Accessible 在指定的位置存在，则返回它；否则返回 null

isFocusTraversable

public boolean isFocusTraversable()

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

指定者：

接口 AccessibleComponent 中的 isFocusTraversable

返回：

如果对象可以接受焦点，则返回 true；否则返回 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)

getAccessibleSelectionCount

public int getAccessibleSelectionCount()

返回当前选择的 Accessible 子对象数。如果不选择子对象，那么返回的值将为 0。

指定者：

接口 AccessibleSelection 中的 getAccessibleSelectionCount

返回：

当前选择的项数

getAccessibleSelection

public Accessible getAccessibleSelection(int i)

返回 Accessible，它表示该对象中指定的已选择的子对象。如果没有选择，或选择的子对象数小于传入的整数，那么返回的值将为 null。

注意，该索引表示第 i 个已选择的子对象，它不同于第 i 个子对象。

指定者：

接口 AccessibleSelection 中的 getAccessibleSelection

参数：

i - 所选子对象的基于零的索引

返回：

第 i 个已选择的子对象

另请参见：

getAccessibleSelectionCount()

isAccessibleChildSelected

public boolean isAccessibleChildSelected(int i)

确定是否选择此对象的当前子对象。

指定者：

接口 AccessibleSelection 中的 isAccessibleChildSelected

参数：

i - 此 Accessible 对象中子对象的基于零的索引

返回：

如果选择此对象的当前子对象，则返回 true；否则返回 false

另请参见：

AccessibleContext.getAccessibleChild(int)

addAccessibleSelection

public void addAccessibleSelection(int i)

将该对象的指定 Accessible 子对象添加到该对象的选择中。如果该对象支持多个选择，则将指定的子对象添加到任何现有选择中，否则，它会替换该对象中的任何现有选择。如果指定的子对象已被选择，则此方法无效。

指定者：

接口 AccessibleSelection 中的 addAccessibleSelection

参数：

i - 子对象的基于零的索引

另请参见：

AccessibleContext.getAccessibleChild(int)

removeAccessibleSelection

public void removeAccessibleSelection(int i)

从对象的选择中移除该对象的指定子对象。如果当前没有选择指定的项，则此方法无效。

指定者：

接口 AccessibleSelection 中的 removeAccessibleSelection

参数：

i - 子对象的基于零的索引

另请参见：

AccessibleContext.getAccessibleChild(int)

clearAccessibleSelection

public void clearAccessibleSelection()

清除该对象中的选择，使该对象中没有子对象被选择。

指定者：

接口 AccessibleSelection 中的 clearAccessibleSelection

selectAllAccessibleSelection

public void selectAllAccessibleSelection()

如果该对象支持多个选择，则会导致该对象的每个子对象都被选择。

指定者：

接口 AccessibleSelection 中的 selectAllAccessibleSelection