JavaTM Platform
Standard Ed. 6

javax.accessibility
接口 AccessibleComponent

所有已知子接口:
AccessibleExtendedComponent
所有已知实现类:
AbstractButton.AccessibleAbstractButton, Applet.AccessibleApplet, Box.AccessibleBox, Box.Filler.AccessibleBoxFiller, Button.AccessibleAWTButton, Canvas.AccessibleAWTCanvas, CellRendererPane.AccessibleCellRendererPane, Checkbox.AccessibleAWTCheckbox, CheckboxMenuItem.AccessibleAWTCheckboxMenuItem, Choice.AccessibleAWTChoice, Component.AccessibleAWTComponent, Container.AccessibleAWTContainer, Dialog.AccessibleAWTDialog, Frame.AccessibleAWTFrame, JApplet.AccessibleJApplet, JButton.AccessibleJButton, JCheckBox.AccessibleJCheckBox, JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem, JColorChooser.AccessibleJColorChooser, JComboBox.AccessibleJComboBox, JComponent.AccessibleJComponent, JDesktopPane.AccessibleJDesktopPane, JDialog.AccessibleJDialog, JEditorPane.AccessibleJEditorPane, JEditorPane.AccessibleJEditorPaneHTML, JEditorPane.JEditorPaneAccessibleHypertextSupport, JFileChooser.AccessibleJFileChooser, JFrame.AccessibleJFrame, JInternalFrame.AccessibleJInternalFrame, JInternalFrame.JDesktopIcon.AccessibleJDesktopIcon, JLabel.AccessibleJLabel, JLayeredPane.AccessibleJLayeredPane, JList.AccessibleJList, JList.AccessibleJList.AccessibleJListChild, JMenu.AccessibleJMenu, JMenuBar.AccessibleJMenuBar, JMenuItem.AccessibleJMenuItem, JOptionPane.AccessibleJOptionPane, JPanel.AccessibleJPanel, JPasswordField.AccessibleJPasswordField, JPopupMenu.AccessibleJPopupMenu, JProgressBar.AccessibleJProgressBar, JRadioButton.AccessibleJRadioButton, JRadioButtonMenuItem.AccessibleJRadioButtonMenuItem, JRootPane.AccessibleJRootPane, JScrollBar.AccessibleJScrollBar, JScrollPane.AccessibleJScrollPane, JSeparator.AccessibleJSeparator, JSlider.AccessibleJSlider, JSpinner.AccessibleJSpinner, JSplitPane.AccessibleJSplitPane, JTabbedPane.AccessibleJTabbedPane, JTable.AccessibleJTable, JTable.AccessibleJTable.AccessibleJTableCell, JTableHeader.AccessibleJTableHeader, JTableHeader.AccessibleJTableHeader.AccessibleJTableHeaderEntry, JTextArea.AccessibleJTextArea, JTextComponent.AccessibleJTextComponent, JTextField.AccessibleJTextField, JToggleButton.AccessibleJToggleButton, JToolBar.AccessibleJToolBar, JToolTip.AccessibleJToolTip, JTree.AccessibleJTree, JTree.AccessibleJTree.AccessibleJTreeNode, JViewport.AccessibleJViewport, JWindow.AccessibleJWindow, Label.AccessibleAWTLabel, List.AccessibleAWTList, List.AccessibleAWTList.AccessibleAWTListChild, Menu.AccessibleAWTMenu, MenuBar.AccessibleAWTMenuBar, MenuComponent.AccessibleAWTMenuComponent, MenuItem.AccessibleAWTMenuItem, Panel.AccessibleAWTPanel, PopupMenu.AccessibleAWTPopupMenu, Scrollbar.AccessibleAWTScrollBar, ScrollPane.AccessibleAWTScrollPane, TextArea.AccessibleAWTTextArea, TextComponent.AccessibleAWTTextComponent, TextField.AccessibleAWTTextField, Window.AccessibleAWTWindow

public interface AccessibleComponent

屏幕上呈现的任何对象都应该支持 AccessibleComponent 接口。此接口为辅助技术提供了标准机制,以确定和设置对象的图形表示形式。应用程序通过先获取某个对象的 AccessibleContext,然后调用 AccessibleContext.getAccessibleComponent() 方法,能够确定该对象是否支持 AccessibleComponent 接口。如果返回值不为 null,则该对象支持此接口。

另请参见:
Accessible, Accessible.getAccessibleContext(), AccessibleContext, AccessibleContext.getAccessibleComponent()

方法摘要
 void addFocusListener(FocusListener l)
          添加指定的焦点侦听器,以接收来自此组件的焦点事件。
 boolean contains(Point p)
          检查指定点是否位于此对象的边界内,其中该点的 X 坐标和 Y 坐标是相对于对象的坐标系统定义的。
 Accessible getAccessibleAt(Point p)
          返回本地坐标 Point 包含的可访问子级(如果存在)。
 Color getBackground()
          获取此对象的背景色。
 Rectangle getBounds()
          获取 Rectangle 对象形式的此对象的边界。
 Cursor getCursor()
          获取此对象的 Cursor。
 Font getFont()
          获取此对象的 Font。
 FontMetrics getFontMetrics(Font f)
          获取此对象的 FontMetrics。
 Color getForeground()
          获取此对象的前景色。
 Point getLocation()
          获得此对象相对于父对象的位置,返回值是一个点对象,它指定对象左上角在屏幕坐标空间内的位置。
 Point getLocationOnScreen()
          返回对象在屏幕上的位置。
 Dimension getSize()
          以 Dimension 对象的形式返回此对象的大小。
 boolean isEnabled()
          确定是否已启用该对象。
 boolean isFocusTraversable()
          返回此对象是否可以接受焦点。
 boolean isShowing()
          确定是否正显示对象。
 boolean isVisible()
          确定此对象是否可见。
 void removeFocusListener(FocusListener l)
          移除指定的焦点侦听器,使其不再接收来自此组件的焦点事件。
 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)
          设置对象的可见状态。
 

方法详细信息

getBackground

Color getBackground()
获取此对象的背景色。

返回:
如果支持的话,返回对象的背景色;否则返回 null
另请参见:
setBackground(java.awt.Color)

setBackground

void setBackground(Color c)
设置此对象的背景色。

参数:
c - 新的背景 Color
另请参见:
setBackground(java.awt.Color)

getForeground

Color getForeground()
获取此对象的前景色。

返回:
如果支持的话,返回对象的前景色;否则返回 null
另请参见:
setForeground(java.awt.Color)

setForeground

void setForeground(Color c)
设置此对象的前景色。

参数:
c - 新的前景 Color
另请参见:
getForeground()

getCursor

Cursor getCursor()
获取此对象的 Cursor。

返回:
如果支持的话,返回对象的 Cursor;否则返回 null
另请参见:
setCursor(java.awt.Cursor)

setCursor

void setCursor(Cursor cursor)
设置此对象的 Cursor。

参数:
cursor - 对象的新 Cursor
另请参见:
getCursor()

getFont

Font getFont()
获取此对象的 Font。

返回:
如果支持的话,返回对象的 Font;否则返回 null
另请参见:
setFont(java.awt.Font)

setFont

void setFont(Font f)
设置此对象的 Font。

参数:
f - 对象的新 Font
另请参见:
getFont()

getFontMetrics

FontMetrics getFontMetrics(Font f)
获取此对象的 FontMetrics。

参数:
f - Font
返回:
如果支持的话,返回对象的 FontMetrics;否则返回 null
另请参见:
getFont()

isEnabled

boolean isEnabled()
确定是否已启用该对象。启用的对象在其 AccessibleStateSet 中也将具有 AccessibleState.ENABLED 状态设置。

返回:
如果已启用对象,则返回 true;否则返回 false
另请参见:
setEnabled(boolean), AccessibleContext.getAccessibleStateSet(), AccessibleState.ENABLED, AccessibleStateSet

setEnabled

void setEnabled(boolean b)
设置对象的启用状态。

参数:
b - 如果为 true,则启用此对象;否则禁用它
另请参见:
isEnabled()

isVisible

boolean isVisible()
确定此对象是否可见。注:这意味着该对象多半是可见的;但是因为包含此对象的对象之一目前不可见,所以可能在屏幕上不显示它。要确定对象是否在屏幕上显示,需要使用 isShowing()。

可见的对象在其 AccessibleStateSet 中也将具有 AccessibleState.VISIBLE 状态设置。

返回:
如果对象可见,则返回 true;否则返回 false
另请参见:
setVisible(boolean), AccessibleContext.getAccessibleStateSet(), AccessibleState.VISIBLE, AccessibleStateSet

setVisible

void setVisible(boolean b)
设置对象的可见状态。

参数:
b - 如果为 true,则显示此对象;否则隐藏它
另请参见:
isVisible()

isShowing

boolean isShowing()
确定是否正显示对象。通过检查该对象和祖先的可见性可确定这一点。注:即使该对象被另一对象屏蔽(例如,它是下拉菜单的下级),仍然返回 true。

返回:
如果正在显示对象,则返回 true;否则,返回 false

contains

boolean contains(Point p)
检查指定点是否位于此对象的边界内,其中该点的 X 坐标和 Y 坐标是相对于对象的坐标系统定义的。

参数:
p - 相对于对象的坐标系统的 Point
返回:
如果对象包含 Point,则返回 true;否则返回 false
另请参见:
getBounds()

getLocationOnScreen

Point getLocationOnScreen()
返回对象在屏幕上的位置。

返回:
返回对象在屏幕上的位置;如果此对象不在屏幕上,则返回 null
另请参见:
getBounds(), getLocation()

getLocation

Point getLocation()
获得此对象相对于父对象的位置,返回值是一个点对象,它指定对象左上角在屏幕坐标空间内的位置。

返回:
Point 的实例,该点表示屏幕坐标空间中对象边界的左上角 ;如果此对象或其父级不在屏幕上,则返回 null
另请参见:
getBounds(), getLocationOnScreen()

setLocation

void setLocation(Point p)
设置对象相对于父级的位置。

参数:
p - 左上角的新位置
另请参见:
getLocation()

getBounds

Rectangle getBounds()
获取 Rectangle 对象形式的此对象的边界。该边界指定此对象的宽、高,以及相对于父对象的位置。

返回:
返回指示此组件的边界的矩形;如果此对象不在屏幕上,则返回 null。
另请参见:
contains(java.awt.Point)

setBounds

void setBounds(Rectangle r)
设置 Rectangle 对象形式的此对象的边界。该边界指定此对象的宽、高,以及相对于父对象的位置。

参数:
r - 指示此组件边界的矩形
另请参见:
getBounds()

getSize

Dimension getSize()
以 Dimension 对象的形式返回此对象的大小。Dimension 对象的 height 字段包含此对象的高度,Dimension 对象的 width 字段包含此对象的宽度。

返回:
返回指示此组件大小的 Dimension 对象;如果此对象不在屏幕上,则返回 null
另请参见:
setSize(java.awt.Dimension)

setSize

void setSize(Dimension d)
调整此对象,使其具有高度和宽度。

参数:
d - 指定对象新大小的维数。
另请参见:
getSize()

getAccessibleAt

Accessible getAccessibleAt(Point p)
返回本地坐标 Point 包含的可访问子级(如果存在)。

参数:
p - 相对于此对象坐标系统的 point。
返回:
如果存在,则返回指定位置处的 Accessible;否则返回 null

isFocusTraversable

boolean isFocusTraversable()
返回此对象是否可以接受焦点。可以接受焦点的对象也将具有在其 AccessibleStateSet 中设置的 AccessibleState.FOCUSABLE 状态。

返回:
如果对象可以接受焦点,则返回 true;否则返回 false
另请参见:
AccessibleContext.getAccessibleStateSet(), AccessibleState.FOCUSABLE, AccessibleState.FOCUSED, AccessibleStateSet

requestFocus

void requestFocus()
请求此对象的焦点。如果此对象不能接受焦点,则不执行任何操作。否则,对象将尝试接受焦点。

另请参见:
isFocusTraversable()

addFocusListener

void addFocusListener(FocusListener l)
添加指定的焦点侦听器,以接收来自此组件的焦点事件。

参数:
l - 焦点侦听器
另请参见:
removeFocusListener(java.awt.event.FocusListener)

removeFocusListener

void removeFocusListener(FocusListener l)
移除指定的焦点侦听器,使其不再接收来自此组件的焦点事件。

参数:
l - 焦点侦听器
另请参见:
addFocusListener(java.awt.event.FocusListener)

JavaTM Platform
Standard Ed. 6

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

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