JavaTM 2 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 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only