軟體套件 javax.accessibility

定義了使用者介面元件與提供對這些元件進行存取的輔助技術之間的協定。

請參見：
描述

介面摘要

Accessible	Accessible 介面是可存取性套件的主介面。
AccessibleAction	任何能夠執行一個或多個動作的物件都應該支持 AccessibleAction 介面。
AccessibleComponent	螢幕上呈現的任何對象都應該支持 AccessibleComponent 介面。
AccessibleEditableText	在顯示器上顯示可編輯文本資訊的全部類別都應該實作 AccessibleEditableText 介面。
AccessibleExtendedComponent	螢幕上呈現的任何對象都應該支持 AccessibleExtendedComponent 介面。
AccessibleExtendedTable	AccessibleExtendedTable 類別提供了有關以二維表的格式呈現資料的使用者介面元件的擴展資訊。
AccessibleExtendedText	AccessibleExtendedText 介面包含 AccessibleText 介面所未提供的其他方法 應用程序通過先獲取某個物件的 AccessibleContext（參見 Accessible），然後調用 AccessibleContext 的 AccessibleContext.getAccessibleText() 方法，能夠確定該物件是否支持 AccessibleExtendedText 介面。
AccessibleHypertext	AccessibleHypertext 類別是在顯示器上顯示超文本資訊的全部類別的基礎類別。
AccessibleIcon	任何具有關聯圖標（例如按鈕）的物件都應支持 AccessibleIcon 介面。
AccessibleKeyBinding	任何具有鍵盤綁定（例如可用於選擇物件的鍵盤助記符和/或鍵盤快捷鍵）功能的物件都應支持 AccessibleKeyBinding 介面。
AccessibleSelection	此 AccessibleSelection 介面提供了輔助技術的標準機制，以確定當前選定了哪些子級，以及修改選項集合。
AccessibleStreamable	任何表示顯示屏元件背後原始串流的元件的 AccessibleContext 都必須實作 AccessibleStreamable 介面。
AccessibleTable	AccessibleTable 類別描述了以二維表格式呈現資料的使用者介面元件。
AccessibleTableModelChange	AccessibleTableModelChange 介面描述了表模型的更改。
AccessibleText	所有在顯示器上顯示文本資訊的類別都應該實作 AccessibleText 介面。
AccessibleValue	任何支持數字值的物件（例如滾動條）都應支持 AccessibleValue 介面。

類別摘要

AccessibleAttributeSequence	此類別彙集共享相同連續屬性集的文本的跨度，以及該屬性集。
AccessibleBundle	用於維護強型別列舉的基礎類別。
AccessibleContext	AccessibleContext 表示所有可存取物件返回的最少資訊。
AccessibleHyperlink	Hypertext 文檔中的某個連接或一組連接（例如客戶端 imagemap）的封裝。
AccessibleRelation	AccessibleRelation 類別描述了實作 AccessibleRelation 的物件與一個或多個其他物件之間的關係。
AccessibleRelationSet	AccessibleRelationSet 類別確定了元件的關係集。
AccessibleResourceBundle	已過時。 從 Java Platform 的 1.3 版開始，此類別已廢棄。
AccessibleRole	AccessibleRole 類別確定元件的職責。
AccessibleState	AccessibleState 類別描述了元件的特殊狀態。
AccessibleStateSet	AccessibleStateSet 類別確定元件的狀態集。
AccessibleTextSequence	此類別彙集文本區域的關鍵細節。

軟體套件 javax.accessibility 的描述

定義了使用者介面元件與提供對這些元件進行存取的輔助技術之間的協定。如果 Java 應用程序完全支持 Java Accessibility API，則它應該與螢幕讀取器、螢幕放大器這樣的輔助技術保持相容和友好。使用完全支持 Java Accessibility API 的 Java 應用程序，將不再需要離屏模型的螢幕讀取器 ，因為該 API 提供了離屏模型中通常所包含的所有資訊。

Java Accessibility API 套件由 8 個 Java 程式語言介面和 6 個 Java 程式語言類別組成。以下是對這些介面和類別的描述。

Interface Accessible

Interface Accessible 是 Java Accessibility API 的主介面。所有支持 Java Accessibility API 的元件都必須實作此介面。它包含單個方法 getAccessibleContext，此方法返回 AccessibleContext 類別的一個實例。Sun 認為，如果 Java 應用程序要與輔助技術相容，則對於作為該程序使用者介面的一部分的每個物件來說，實作此介面是絕對的最低需求。

Class AccessibleContext

AccessibleContext 表示所有可存取物件所返回的最少資訊，它是通過調用實作 Accessible 介面的物件上的 getAccessibleContext 方法獲得的。此資訊包括物件的可存取名稱、描述、職責和狀態，以及關於該物件的父物件和子物件的資訊。此外，還包括對 JavaBeans ^TM 屬性更改的支持，從而當可存取的屬性值發生更改時，輔助技術能夠獲悉。AccessibleContext 還包含用於獲取更多關於元件的特定可存取資訊的方法。如果元件支持它，則這些方法將返回實作以下一個或多個介面的物件：

• AccessibleAction － 可以執行一個或多個動作的物件。此介面為輔助技術提供了標準機制，以確定這些動作並通知物件執行它們。當調用 AccessibleContext 上的 getAccessibleAction 方法時，任何可以操作的物件都應返回實作此介面的物件。
• AccessibleComponent － 具有圖形表示形式的物件。此介面為輔助技術提供了標準機制，以確定和設置物件的圖形表示形式。當調用 AccessibleContext 上的 getAccessibleComponent 方法時，任何在螢幕上呈現的物件都應返回實作此介面的物件。
• AccessibleSelection － 允許選擇其子物件的物件。此介面為輔助技術提供了標準機制，以確定當前選定的子物件，並修改選擇設置。當調用 AccessibleContext 上的 getAccessibleSelection 方法時，任何具有可選子物件的對象都應返回實作此介面的物件。
• AccessibleText － 在顯示器上顯示可編輯文本資訊的物件。此介面為輔助技術提供了標準機制，用於通過文本的內容、屬性和空間位置來存取該文本。當調用 AccessibleContext 上的 getAccessibleText 方法時，任何包含可編輯文本的物件都應返回實作此介面的物件。
• AccessibleHypertext － 在顯示器上顯示超文本資訊的物件。此介面為輔助技術提供了標準機制，用於通過超文本的內容、屬性和空間位置來存取該超文本。當調用 AccessibleContext 上的 getAccessibleText 方法時，任何包含超文本的物件都應返回實作此介面的物件。
• AccessibleValue － 支持數字值的物件。此介面為輔助技術提供了標準機制，以確定和設置物件的當前值，以及最小值和最大值。當調用 AccessibleContext 上的 getAccessibleValue 方法時，任何支持數字值的物件都應返回實作此介面的物件。

Class AccessibleRole

此類別封裝了 Accessible 物件職責，該類別通過調用 AccessibleContext 上的 getAccessibleRole 方法獲得。可存取的職責包括 “複選框”、“選單項”、“面板”等等。這些職責由此類別中的常數（如 AccessibleRole.CHECK_BOX、AccessibleRole.MENU_ITEM 和 AccessibleRole.PANEL）來標識。此類別中的常數存在一個公共物件職責的強型別的列舉。我們有意忽略了此類別的公共建構子，應用程序應使用此類別的一個常數。雖然此類別預定義了一個大的標準職責列表，但它是可擴展的，這樣可以在將來添加其他開發人員所定義的職責，而無需修改基礎類別。

Class AccessibleState

此類別封裝了 Accessible 物件的特殊狀態。可存取的狀態包括 "Armed"、"Busy"、"Checked"、"Focused"等等。這些職責由此類別的常數（如 AccessibleState.ARMED、AccessibleState.BUSY、AccessibleState.CHECKED 和 AccessibleState.FOCUSED）來標識。Accessible 物件的所有狀態的集合稱為 AccessibleStateSet，它可以通過調用 AccessibleContext 上的 getAccessibleStateSet 方法獲得。

此類別中的常數存在一個公共物件職責的強型別的列舉。我們有意忽略了此類別的公共建構子，應用程序應使用此類別的一個常數。雖然此類別預定義了一個大的標準職責列表，但它是可擴展的，這樣可以在將來添加其他開發人員所定義的職責，而無需修改基礎類別。

Class AccessibleStateSet

此類別封裝了 Accessible 物件的狀態集合，此類別通過調用 AccessibleContext 上的 getAccessibleStateSet 方法獲得。因為一個對象可能有多個狀態（例如，它可能同時處於 "Checked" 和 "Focused" 狀態），因此此類別需要封裝這些狀態的集合。此類別中的方法可以在狀態集上檢索單個 AccessibleStates 。

Class AccessibleBundle

此類別用於維護強型別列舉。它是 AccessibleRole 和 AccessibleState 類別的父級類別。開發人員一般不與此類別直接進行交互，而是使用 AccessibleRole 和 AccessibleState 類別。

Interface AccessibleAction

任何能夠執行一個或多個動作的物件都應支持 AccessibleAction 介面。此介面為輔助技術提供了標準機制，以確定這些動作並通知物件執行它們。任何可以操作的物件都應支持此介面。

應用程序通過先獲取某個物件的 AccessibleContext（參見 Accessible），然後調用 AccessibleContext 上的 getAccessibleAction 方法，能夠確定該物件是否支持 AccessibleAction 介面。如果返回值不為 null，則該物件支持此介面。

Interface AccessibleComponent

任何在螢幕上呈現的物件都應支持 AccessibleComponent 介面。此介面為輔助技術提供了標準機制，以確定和設置物件的圖形表示形式。

應用程序通過先調用某個物件的 AccessibleContext（參見 Accessible），然後調用 AccessibleContext 上的 getAccessibleComponent 方法，能夠確定該物件是否支持 AccessibleComponent 介面。如果返回值不為 null，則該物件支持此介面。

Interface AccessibleSelection

AccessibleSelection 介面為輔助技術提供了標準機制，以確定當前選定了哪些子物件，並修改選擇設置。任何具有可選子物件的對象都應支持 AccessibleSelection 介面。

應用程序通過先獲取某個物件的 AccessibleContext（參見 Accessible），然後調用 AccessibleContext 上的 getAccessibleSelection 方法，能夠確定該物件是否支持 AccessibleSelection 介面。如果返回值不為 null，則該物件支持此介面。

Interface AccessibleText

AccessibleText 介面是針對產生豐富的、可編輯的文本 Accessible 的協定。並不是螢幕上顯示的所有文本都是富文本和可編輯的（例如對於按鈕、標籤和選單中所包含的文本，使用者就不能對其進行操作）。但是，如果包含可編輯文本的物件要與輔助技術進行互操作，則它們必須實作 AccessibleText 介面。

此介面支持在像素坐標和給定像素坐標處的文本之間進行轉換，以及檢索文本中給定位置處、給定位置前或給定位置後的字母、單詞和句子。此介面支持對文本中給定位置處的字元屬性（字體、字體大小、樣式，等等）進行檢索，以及獲得選中的文本（如果有）、文本長度和文本插入符位置。

應用程序通過先獲取某個物件的 AccessibleContext（參見 Accessible），然後調用 AccessibleContext 的 getAccessibleText 方法，能夠確定該物件是否支持 AccessibleText 介面。如果返回值不為 null，則該物件支持此介面。

Interface AccessibleHypertext

任何在顯示器上顯示超文本資訊的物件都應支持 AccessibleHypertext 介面。此介面為輔助技術提供了標準機制，用於通過文本的內容、屬性和空間位置來存取該文本。它還提供了操作超連接的標準機制。應用程序通過先獲取某個物件的 AccessibleContext（參見 Accessible），然後調用 AccessibleContext 的 AccessibleContext.getAccessibleText() 方法，能夠確定該物件是否支持 AccessibleHypertext 介面。如果返回值是一個擴展了 AccessibleHypertext 的類別，則該物件支持 AccessibleHypertext。

Interface AccessibleHyperlink

超連接物件應支持 AccessibleHyperlink 介面。通過調用 AccessibleHypertext 物件上的 getLink 方法將返回實作此介面的物件。

Interface AccessibleValue

任何支持數字值的物件（例如滾動條）都應支持 AccessibleValue 介面。此介面為輔助技術提供了標準機制，以確定和設置數字值，以及獲取最小值和最大值。

應用程序通過先獲取某物件的 AccessibleContext（參見 Accessible），然後調用 AccessibleContext 的 getAccessibleValue 方法，能夠確定該物件是否支持 AccessibleValue 介面。如果返回值不為 null，則該物件支持此介面。

從以下版本開始：

1.2