Module java.desktop

Package java.awt

Class 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的内部类，用于为辅助功能提供默认支持。这个类不应该直接被应用程序开发人员使用，而是只应该由菜单组件开发人员进行子类化。

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

自JDK版本:

1.3

参见:

• 序列化形式

Field Summary

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	AccessibleAWTMenuComponent()	虽然该类是抽象的，但所有子类都应该调用此方法。

Method Summary

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

Methods declared in class javax.accessibility.AccessibleContext

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

Methods declared in class java.lang.Object

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

Constructor Details

AccessibleAWTMenuComponent

             protected AccessibleAWTMenuComponent()
            

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

Method Details

getAccessibleSelection

             public AccessibleSelection getAccessibleSelection()
            

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

覆盖:

getAccessibleSelection 在类 AccessibleContext中

返回:

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

参见:

• AccessibleSelection

getAccessibleName

             public String getAccessibleName()
            

获取此对象的可访问名称。这几乎不应该返回java.awt.MenuComponent.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个可访问子项

参见:

• 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 - 指定对象新大小的Dimension

参见:

• AccessibleComponent.getSize()

getAccessibleAt

             public Accessible getAccessibleAt(Point p)
            

返回Accessible子级（如果存在），该子级包含在本地坐标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)

getAccessibleSelectionCount

             public int getAccessibleSelectionCount()
            

返回当前选定的Accessible子项的数量。如果没有选定子项，则返回值为0。

指定由:

getAccessibleSelectionCount 在接口 AccessibleSelection中

返回:

当前选定的项目数量

getAccessibleSelection

             public Accessible getAccessibleSelection(int i)
            

返回表示对象中指定选定子项的Accessible。如果没有选择，或者选定的子项少于传入的整数，则返回值将为null。

请注意，索引表示第i个选定的子项，这与第i个子项不同。

指定由:

getAccessibleSelection 在接口 AccessibleSelection中

参数:

i - 选定子项的从零开始的索引

返回:

第i个选定的子项

参见:

• getAccessibleSelectionCount()

isAccessibleChildSelected

             public boolean isAccessibleChildSelected(int i)
            

确定此对象的当前子项是否被选中。

指定由:

isAccessibleChildSelected 在接口 AccessibleSelection中

参数:

i - 此Accessible对象中子项的从零开始的索引

返回:

如果此对象的当前子项被选中，则为true；否则为false

参见:

• AccessibleContext.getAccessibleChild(int)

addAccessibleSelection

             public void addAccessibleSelection(int i)
            

将对象的指定Accessible子项添加到对象的选择中。如果对象支持多个选择，则将指定的子项添加到任何现有选择中，否则将替换对象中的任何现有选择。如果指定的子项已被选中，则此方法不起作用。

指定由:

addAccessibleSelection 在接口 AccessibleSelection中

参数:

i - 子项的从零开始的索引

参见:

• AccessibleContext.getAccessibleChild(int)

removeAccessibleSelection

             public void removeAccessibleSelection(int i)
            

从对象的选择中移除指定的子项。如果指定的项目当前未被选中，则此方法不起作用。

指定由:

removeAccessibleSelection 在接口 AccessibleSelection中

参数:

i - 子项的从零开始的索引

参见:

• AccessibleContext.getAccessibleChild(int)

clearAccessibleSelection

             public void clearAccessibleSelection()
            

清除对象中的选择，以便对象中没有子项被选中。

指定由:

clearAccessibleSelection 在接口 AccessibleSelection中

selectAllAccessibleSelection

             public void selectAllAccessibleSelection()
            

如果对象支持多个选择，则使对象的每个子项都被选中。

指定由:

selectAllAccessibleSelection 在接口 AccessibleSelection中