JavaTM 2 Platform
Std. Ed. v1.3

パッケージ javax.accessibility

コンポーネントにアクセスできるユーザ補助機能とユーザインタフェースコンポーネント間の規則を定義します。

参照:
          説明

インタフェースの概要
Accessible インタフェース Accessible は、ユーザ補助機能パッケージのメインインタフェースです。
AccessibleAction AccessibleAction インタフェースは、1 つ以上のアクションを実行できるすべてのオブジェクトによってサポートされる必要があります。
AccessibleComponent AccessibleComponent インタフェースは、画面に描画されるすべてのオブジェクトによってサポートされる必要があります。
AccessibleHypertext AccessibleHypertext クラスは、画面にハイパーテキスト情報を表示するすべてのクラスの基底クラスです。
AccessibleIcon AccessibleIcon インタフェースは、関連したアイコン (ボタンなど) を持つすべてのオブジェクトによってサポートされる必要があります。
AccessibleSelection この AccessibleSelection インタフェースは、現在選択されている子を判定したり、選択されているセットを変更するための標準的な機構を提供します。
AccessibleTable クラス AccessibleTable は、2 次元テーブル形式でデータを提示するユーザインタフェースコンポーネントを記述します。
AccessibleTableModelChange AccessibleTableModelChange インタフェースはテーブルモデルへの変更を記述します。
AccessibleText AccessibleText インタフェースは、テキスト情報を画面に表示するすべてのクラスによって実装される必要があります。
AccessibleValue AccessibleValue インタフェースは、数値をサポートするすべてのオブジェクト (スクロールバーなど) によってサポートされる必要があります。
 

クラスの概要
AccessibleBundle データ型の変更不可能な列挙を維持するために使用する基底クラスです。
AccessibleContext AccessibleContext は、すべてのユーザ補助機能を実装するオブジェクトが返す共通の最小情報を表します。
AccessibleHyperlink ハイパーテキストドキュメント内のリンクまたはリンクのセット (たとえば、クライアント側イメージマップなど) のカプセル化です。
AccessibleRelation Class AccessibleRelation は、AccessibleRelation を実装しているオブジェクトと、その他の 1 つ以上のオブジェクトとの間のリレーションを記述します。
AccessibleRelationSet AccessibleRelationSet クラスはコンポーネントのリレーションセットを判定します。
AccessibleResourceBundle 推奨されていません。 Java 2 プラットフォームのバージョン 1.3 では、このクラスは推奨されません。
AccessibleRole クラス AccessibleRole は、コンポーネントのユーザ補助機能を指定します。
AccessibleState クラス AccessibleState は、コンポーネントの個々の状態を記述します。
AccessibleStateSet クラス AccessibleStateSet は、コンポーネントの状態セットを指定します。
 

パッケージ javax.accessibility の説明

コンポーネントにアクセスできるユーザ補助機能とユーザインタフェースコンポーネント間の規則を定義します。Java アプリケーションが Java Accessibility API を完全にサポートしている場合、画面リーダ、画面拡大機能などのユーザ補助機能と互換性があり、そうさしやすいものでなければなりません。Java Accessibility API を完全にサポートしている Java アプリケーションを使用する場合、API がオフ画面モデルに通常含まれるすべての情報を提供するので、オフ画面モデルの画面リーダは不要です。

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

インタフェース Accessible

インタフェース Accessible が Java Accessibility API の主なインタフェースです。Java Accessibility API をサポートするすべてのコンポーネントはこのインタフェースを実装している必要があります。これには 1 つのメソッド getAccessibleContext があり、クラス AccessibleContext のインスタンスを返します。Sun では、プログラムがユーザ補助機能と互換性がある場合、このインタフェースの実装が Java アプリケーションのユーザインタフェースの一部であるすべてのオブジェクトの絶対的な最低必用条件であると考えています。

クラス AccessibleContext

AccessibleContext は、すべてのユーザ補助機能を実装するオブジェクトが返す最小情報を表し、Accessible インタフェースを実装するオブジェクトで getAccessibleContext メソッドを呼び出すと取得できます。この情報にはユーザ補助機能名、説明、役割とオブジェクトの状態や、オブジェクトの親や子に関する情報があります。 また、ユーザ補助プロパティ値が変更される時に、ユーザ補助機能で確認できるように、JavaBeans TM プロパティ変更サポートも取り入れられています。AccessibleContext には、コンポーネントに関するより詳細なユーザ補助機能の情報を取得するためのメソッドがあります。このコンポーネントが AccessibleContext をサポートしている場合、これらのメソッドは、以下の 1 つ以上のインタフェースを実装するオブジェクトを返します。

クラス AccessibleRole

このクラスは、ユーザ補助機能を実装するオブジェクトの役割をユーザインタフェースにカプセル化し、getAccessibleRole メソッドを AccessibleContext で呼び出すことによって得られます。 ユーザ補助機能の役割には「チェックボックス」、「メニュー項目」、「パネル」などがあります。これらの役割は AccessibleRole.CHECK_BOX、AccessibleRole.MENU_ITEM、 および AccessibleRole.PANEL などのクラスの定数によって識別されます。このクラスの定数は、オブジェクトに共通のユーザ補助機能のデータ型の変更不可能な列挙を示します。このクラスの public コンストラクタは意図的に省略されており、アプリケーションはこのクラスから定数の 1 つを使用する必要があります。このクラスは標準の役割の大規模リストを事前定義していますが、拡張可能であるため、基底クラスを変更することなく、将来プログラマが定義した役割をさらに追加することができます。

クラス AccessibleState

このクラスはユーザ補助オブジェクトの個々の状態をカプセル化します。ユーザ補助機能の状態には、「準備状態 (Armed)」、「ビジー (Busy)」、「チェック済み (Checked)」、「フォーカス (Focused)」などがあります。これらの役割は、AccessibleState.ARMEDAccessibleState.BUSYAccessibleState.CHECKED、と AccessibleState.FOCUSED などこのクラスの定数によって識別されます。ユーザ補助オブジェクトすべての状態の合計は AccessibleStateSet と呼ばれ、getAccessibleStateSet メソッドを AccessibleContext で呼び出すと取得できます。

このクラスの定数はオブジェクトに共通のユーザ補助機能のデータ型の列挙を示します。このクラスの public コンストラクタは意図的に省略されており、アプリケーションはこのクラスから定数の 1 つを使用する必要があります。このクラスは標準の役割の大規模リストを事前定義していますが、拡張可能であるため、基底クラスを変更することなく、将来プログラマが定義した役割をさらに追加することができます。

クラス AccessibleStateSet

このクラスはユーザ補助オブジェクトの状態のコレクションをカプセル化し、getAccessibleStateSet メソッドを AccessibleContext で呼び出すと取得できます。オブジェクトが複数の状態 (たとえば「チェック済み (Checked) と 「フォーカス (Focused)」両方) を持つ可能性があるので、このクラスはこれらの状態のコレクションをカプセル化する必要があります。クラスのメソッドは、状態セットの個々の AccessibleStates の取り出し用に提供されています。

クラス AccessibleBundle

このクラスは強く型付けされた列挙を保持するために使われます。これは AccessibleRoleAccessibleState クラス両方のスーパークラスです。プログラマは通常このクラスと直接対話しませんが、その代わりに AccessibleRoleAccessibleState クラスを使用します。

インタフェース AccessibleAction

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

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

インタフェース AccessibleComponent

AccessibleComponent インタフェースは、画面上に描画されているオブジェクトによってサポートされている必要があります。このインタフェースは、オブジェクトのグラフィカルな表現を決定し、設定するための標準的な機構をユーザ補助機能に提供します。

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

インタフェース AccessibleSelection

AccessibleSelection インタフェースは、現在選択されている子を決めたり、選択セットを変更するための標準的な機構をユーザ補助機能に提供します。選択できる子を持つオブジェクトはすべてこの AccessibleSelection インタフェースをサポートしている必要があります。

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

インタフェース AccessibleText

インタフェース AccessibleText は、リッチで編集可能なテキストのユーザ補助機能の構成を請け負います。画面に表示されているすべてのテキストがリッチで編集可能とは限りません (たとえば、ボタン、ラベル、メニューに含まれるテキストで、ユーザーの操作が予想されていないテキスト)。しかし、ユーザ補助機能と共に使用する予定の場合、編集可能なテキストを含むオブジェクトはインタフェース AccessibleText を実装する必要があります。

このインタフェースは、指定したピクセル座標のテキストとピクセル座標の変換、テキスト内の指定した位置前後で文字、語および文の取り出しをサポートします。このインタフェースはテキスト内の指定した位置で文字の属性 (フォント、フォントサイズ、スタイルなど) の取り出しや、選択したテキスト (あれば) 、テキストの長さ、およびテキストキャレットの位置の取得をサポートします。

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

インタフェース AccessibleHypertext

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

インタフェース AccessibleHyperlink

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

インタフェース AccessibleValue

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

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

導入されたバージョン:
JDK1.2

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.