パッケージ javax.accessibility

ユーザーインタフェースコンポーネントとそれらのコンポーネントへのアクセスを提供するユーザー補助テクノロジの間の規約を定義します。

参照: 説明

インタフェースのサマリー

インタフェース	説明
Accessible	インタフェース Accessible は、アクセシビリティーパッケージのメインインタフェースです。
AccessibleAction	AccessibleAction インタフェースは、1 つ以上のアクションを実行できるすべてのオブジェクトによってサポートされる必要があります。
AccessibleComponent	AccessibleComponent インタフェースは、画面に描画されるすべてのオブジェクトによってサポートされる必要があります。
AccessibleEditableText	AccessibleEditableText インタフェースは、編集可能なテキスト情報を画面に表示するすべてのクラスによって実装される必要があります。
AccessibleExtendedComponent	AccessibleExtendedComponent インタフェースは、画面に描画されるすべてのオブジェクトによってサポートされる必要があります。
AccessibleExtendedTable	AccessibleExtendedTable クラスは、2 次元テーブル形式でデータを提示するユーザーインタフェースコンポーネントについての拡張情報を提供します。
AccessibleExtendedText	AccessibleExtendedText インタフェースには、AccessibleText インタフェースでは提供されていない追加のメソッドが含まれています。 アプリケーションは、オブジェクトの AccessibleContext (Accessible を参照) を取得してから、AccessibleContext の AccessibleContext.getAccessibleText() メソッドを呼び出すと、オブジェクトが AccessibleExtendedText インタフェースをサポートするかどうかを判定できます。
AccessibleHypertext	AccessibleHypertext クラスは、画面にハイパーテキスト情報を表示するすべてのクラスの基底クラスです。
AccessibleIcon	AccessibleIcon インタフェースは、関連付けられたアイコン (ボタンなど) を持つすべてのオブジェクトによってサポートされる必要があります。
AccessibleKeyBinding	AccessibleKeyBinding インタフェースは、オブジェクトの選択に使用できるキーボードニーモニックまたはキーボードショートカットなどのキーボードバインディングを持つすべてのオブジェクトによってサポートされる必要があります。
AccessibleSelection	AccessibleSelection インタフェースは、現在選択されている子を判定したり、選択されているセットを変更するための標準メカニズムをユーザー補助テクノロジに提供します。
AccessibleStreamable	AccessibleStreamable インタフェースは、コンポーネントの背後にある raw ストリームを画面に表示するすべてのコンポーネントの AccessibleContext によってサポートされる必要があります。
AccessibleTable	AccessibleTable クラスは、2 次元テーブル形式でデータを提示するユーザーインタフェースコンポーネントを記述します。
AccessibleTableModelChange	AccessibleTableModelChange インタフェースはテーブルモデルへの変更を記述します。
AccessibleText	AccessibleText インタフェースは、テキスト情報を画面に表示するすべてのクラスによって実装される必要があります。
AccessibleValue	AccessibleValue インタフェースは、数値をサポートするすべてのオブジェクト (スクロールバーなど) によってサポートされる必要があります。

クラスのサマリー

クラス	説明
AccessibleAttributeSequence	このクラスは、連続した属性セットを共有するテキスト範囲を、その属性セットとともに収集します。
AccessibleBundle	強く型付けされた列挙を維持するために使用する基底クラスです。
AccessibleContext	AccessibleContext は、すべての Accessible オブジェクトが返す共通の最小情報を表します。
AccessibleHyperlink	リンクまたはリンクセットのカプセル化 (例:
AccessibleRelation	AccessibleRelation クラスは、AccessibleRelation を実装しているオブジェクトと、その他の 1 つ以上のオブジェクトとの間のリレーションを記述します。
AccessibleRelationSet	AccessibleRelationSet クラスはコンポーネントのリレーションセットを判定します。
AccessibleResourceBundle	非推奨 Java プラットフォームのバージョン 1.3 以降では、このクラスは推奨されません。
AccessibleRole	AccessibleRole クラスは、コンポーネントの役割を判定します。
AccessibleState	AccessibleState クラスは、コンポーネントの特定の状態を記述します。
AccessibleStateSet	AccessibleStateSet クラスは、コンポーネントの状態セットを判定します。
AccessibleTextSequence	このクラスは、テキスト範囲の主な詳細情報を収集します。

パッケージ javax.accessibility の説明

ユーザーインタフェースコンポーネントとそれらのコンポーネントへのアクセスを提供するユーザー補助テクノロジの間の規約を定義します。Java Accessibility API を完全にサポートしている Java アプリケーションであれば、画面リーダーや画面拡大機能などのユーザー補助テクノロジと互換性を持ち、簡単に対応できます。 画面リーダーのオフスクリーンモデルに通常含まれている情報はすべて Java Accessibility API で提供されるので、この API を完全にサポートしている Java アプリケーションでは、画面リーダーのオフスクリーンモデルは不要になります。

Java Accessibility API パッケージは、8 つの Java プログラミング言語インタフェースと、6 つの Java プログラミング言語クラスで構成されています。これらについて次に説明します。

インタフェース Accessible

インタフェース Accessible は、Java Accessibility API のメインインタフェースです。Java Accessibility API をサポートするコンポーネントは、すべてこのインタフェースを実装する必要があります。このインタフェースには、AccessibleContext クラスのインスタンスを返す getAccessibleContext というメソッドがあります。Java アプリケーションでユーザー補助テクノロジとの互換性を得るには、少なくとも、アプリケーションのユーザーインタフェースを構成するオブジェクトすべてにこのインタフェースを実装する必要があります。

AccessibleContext クラス

AccessibleContext は、すべての Accessible が返す共通の最小情報を表し、Accessible インタフェースを実装するオブジェクトに対して getAccessibleContext メソッドを呼び出すことで取得されます。この情報には、オブジェクトの Accessible 名、説明、役割、および状態や、オブジェクトの親および子についての情報などがあります。 さらに、JavaBeans ^TM プロパティー変更のサポートが含まれているので、ユーザー補助テクノロジプロパティーの値が変化するとそれをユーザー補助テクノロジで認識できます。また、AccessibleContext には、あるコンポーネントについての、より詳細なアクセシビリティー情報を取得するためのメソッドがあります。このコンポーネントが AccessibleContext をサポートしている場合、これらのメソッドは、次の 1 つ以上のインタフェースを実装するオブジェクトを返します。

• AccessibleAction - オブジェクトは 1 つ以上のアクションを実行できます。このインタフェースは、実行するアクションを決定し、オブジェクトにそれらのアクションを実行するように指示するための標準メカニズムをユーザー補助テクノロジに提供します。AccessibleContext に対して getAccessibleAction メソッドを呼び出すと、操作可能なオブジェクトであれば、このインタフェースを実装するオブジェクトが返されます。
• AccessibleComponent - オブジェクトはグラフィカルな表現を持ちます。このインタフェースは、オブジェクトのグラフィカルな表現を判定および設定するための標準メカニズムをユーザー補助テクノロジに提供します。AccessibleContext に対して getAccessibleComponent メソッドを呼び出すと、画面に描画されるオブジェクトであれば、このインタフェースを実装するオブジェクトが返されます。
• AccessibleSelection - オブジェクトは子の選択を許可します。このインタフェースは、現在選択されている子を判定したり、選択されているセットを変更したりするための標準メカニズムをユーザー補助テクノロジに提供します。AccessibleContext に対して getAccessibleSelection メソッドを呼び出すと、選択可能な子を持つオブジェクトであれば、このインタフェースを実装するオブジェクトが返されます。
• AccessibleText - オブジェクトは編集可能なテキスト情報を画面に表示します。このインタフェースは、内容、属性、および空間位置を使ってそのテキストにアクセスするための標準メカニズムをユーザー補助テクノロジに提供します。AccessibleContext に対して getAccessibleText メソッドを呼び出すと、編集可能なテキストを含むオブジェクトであれば、このインタフェースを実装するオブジェクトが返されます。
• AccessibleHypertext - オブジェクトはハイパーテキスト情報を画面に表示します。このインタフェースは、内容、属性、および空間位置を使ってそのハイパーテキストにアクセスするための標準メカニズムをユーザー補助テクノロジに提供します。AccessibleContext に対して getAccessibleText メソッドを呼び出すと、ハイパーテキストを含むオブジェクトであれば、このインタフェースを実装するオブジェクトが返されます。
• AccessibleValue - オブジェクトは数値をサポートします。このインタフェースは、オブジェクトの現在の値や最大値や最小値を判定および設定するための標準メカニズムをユーザー補助テクノロジに提供します。AccessibleContext に対して getAccessibleValue メソッドを呼び出すと、数値をサポートするオブジェクトであれば、このインタフェースを実装するオブジェクトが返されます。

AccessibleRole クラス

このクラスは、ユーザーインタフェースでの Accessible オブジェクトの役割をカプセル化します。AccessibleContext に対して getAccessibleRole メソッドを呼び出すことで取得されます。Accessible オブジェクトの役割には、「チェックボックス」、「メニュー項目」、「パネル」などがあります。これらの役割は、AccessibleRole.CHECK_BOX、AccessibleRole.MENU_ITEM、AccessibleRole.PANEL のように、このクラスの定数で識別されます。このクラスの定数は、一般的なオブジェクト役割の、強く型付けされた列挙を示します。このクラスの public コンストラクタは意図的に省略されており、アプリケーションはこのクラスから定数の 1 つを使用する必要があります。このクラスには、標準の役割が多数定義されていますが、将来このリストを拡張して、プログラマが定義した役割を追加することもできます。このとき、基底クラスを変更する必要はありません。

AccessibleState クラス

このクラスは、Accessible オブジェクトの個々の状態をカプセル化します。Accessible の状態には、「作動準備完了」、「ビジー」、「チェック」、「フォーカス」などがあります。これらの状態は、AccessibleState.ARMED、AccessibleState.BUSY、AccessibleState.CHECKED、AccessibleState.FOCUSED のように、このクラスの定数で識別されます。Accessible オブジェクトの状態の総和は AccessibleStateSet と呼ばれ、AccessibleContext に対して getAccessibleStateSet メソッドを呼び出すことで取得されます。

このクラスの定数は、一般的なオブジェクト役割の、強く型付けされた列挙を示します。このクラスの public コンストラクタは意図的に省略されており、アプリケーションはこのクラスから定数の 1 つを使用する必要があります。このクラスには、標準の状態が多数定義されていますが、将来このリストを拡張して、プログラマが定義した状態を追加することもできます。このとき、基底クラスを変更する必要はありません。

AccessibleStateSet クラス

このクラスは、Accessible オブジェクトの状態のコレクションをカプセル化します。AccessibleContext に対して getAccessibleStateSet メソッドを呼び出すことで取得されます。オブジェクトは複数の状態を持つことがあるので (「チェックされている」と「フォーカスされている」の両方など)、これらの状態のコレクションをカプセル化するためにこのクラスが必要になります。このクラスのメソッドを使用すると、状態セットから個々の AccessibleStates を取得できます。

AccessibleBundle クラス

このクラスは、強く型付けされた列挙を維持するために使用されます。このクラスは、AccessibleRole クラスおよび AccessibleState クラスのスーパークラスです。通常、プログラマはこのクラスを直接操作せず、AccessibleRole クラスや AccessibleState クラスを使用します。

インタフェース AccessibleAction

AccessibleAction インタフェースは、1 つ以上のアクションを実行できるすべてのオブジェクトによってサポートされる必要があります。このインタフェースは、実行するアクションを決定し、オブジェクトにそれらのアクションを実行するように指示するための標準メカニズムをユーザー補助テクノロジに提供します。操作可能なオブジェクトはすべてこのインタフェースをサポートする必要があります。

アプリケーションは、オブジェクトの AccessibleContext (Accessible を参照) を取得してから、AccessibleContext の getAccessibleAction メソッドを呼び出すと、オブジェクトが AccessibleAction インタフェースをサポートするかどうかを判定できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。

インタフェース AccessibleComponent

AccessibleComponent インタフェースは、画面に描画されるすべてのオブジェクトによってサポートされる必要があります。このインタフェースは、オブジェクトのグラフィカルな表現を判定および設定するための標準メカニズムをユーザー補助テクノロジに提供します。

アプリケーションは、オブジェクトの AccessibleContext (Accessible を参照) を取得してから、AccessibleContext の getAccessibleComponent メソッドを呼び出すと、オブジェクトが AccessibleComponent インタフェースをサポートするかどうかを判定できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。

インタフェース AccessibleSelection

AccessibleSelection インタフェースは、現在選択されている子を判定したり、選択されているセットを変更するための標準メカニズムをユーザー補助テクノロジに提供します。選択することができる子を持つすべてのオブジェクトは、この AccessibleSelection インタフェースをサポートする必要があります。

アプリケーションは、オブジェクトの AccessibleContext (Accessible を参照) を取得してから、AccessibleContext の getAccessibleSelection メソッドを呼び出すと、オブジェクトが AccessibleSelection インタフェースをサポートするかどうかを判定できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。

インタフェース AccessibleText

AccessibleText インタフェースは、編集可能なリッチテキストをアクセス可能にするための規約です。画面に表示されるすべてのテキストが編集可能なリッチテキストであるとは限りません (ボタン、ラベル、メニューなどに含まれている、ユーザーが操作することのないテキストなど)。ただし、編集可能なテキストを含んでいるオブジェクトをユーザー補助テクノロジと相互運用できるようにするには、これらのオブジェクトに AccessibleText インタフェースを実装する必要があります。

このインタフェースは、ピクセル座標間の移動や指定されたピクセル座標にあるテキストへの移動、テキスト内の指定された位置またはその前後にある文字、語、または文の取得、テキスト内の指定された位置にある文字の属性 (フォント、フォントサイズ、スタイルなど) の取得、選択されているテキストの取得 (存在する場合)、テキストの長さおよびテキストキャレット位置の取得をサポートします。

アプリケーションは、オブジェクトの AccessibleContext (Accessible を参照) を取得してから、AccessibleContext の getAccessibleText メソッドを呼び出すと、オブジェクトが AccessibleText インタフェースをサポートするかどうかを判定できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。

インタフェース AccessibleHypertext

AccessibleHypertext インタフェースは、ハイパーテキスト情報を画面に表示するすべてのオブジェクトによってサポートされる必要があります。このインタフェースは、内容、属性、および空間位置を使ってそのテキストにアクセスするための標準メカニズムをユーザー補助テクノロジに提供します。また、このクラスは、ハイパーリンクを操作するための標準メカニズムも提供します。アプリケーションは、オブジェクトの AccessibleContext (Accessible を参照) を取得してから、AccessibleContext の AccessibleContext.getAccessibleText() メソッドを呼び出すと、オブジェクトが AccessibleHypertext インタフェースをサポートするかどうかを判定できます。戻り値が AccessibleHypertext を継承するクラスの場合は、そのオブジェクトは AccessibleHypertext をサポートしています。

インタフェース AccessibleHyperlink

オブジェクトがハイパーリンクの場合、そのオブジェクトは AccessibleHyperlink インタフェースをサポートする必要があります。 AccessibleHypertext オブジェクトに対して getLink メソッドを呼び出すと、このインタフェースを実装するオブジェクトが返されます。

インタフェース AccessibleValue

AccessibleValue インタフェースは、数値をサポートするすべてのオブジェクト (スクロールバーなど) によってサポートされる必要があります。このインタフェースは、数値を判定および設定したり、最小値および最大値を取得するための標準メカニズムをユーザー補助テクノロジに提供します。

アプリケーションは、オブジェクトの AccessibleContext (Accessible を参照) を取得してから、AccessibleContext の getAccessibleValue メソッドを呼び出すと、オブジェクトが AccessibleValue インタフェースをサポートするかどうかを判定できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。

導入されたバージョン:

1.2