パッケージ javax.accessibility
コンポーネントにアクセスできるユーザ補助機能とユーザインタフェースコンポーネント間の規則を定義します。
参照:
説明
インタフェースの概要 |
Accessible |
インタフェース Accessible は、ユーザ補助機能パッケージのメインインタフェースです。 |
AccessibleAction |
AccessibleAction インタフェースは、1 つ以上のアクションを実行できるすべてのオブジェクトによってサポートされる必要があります。 |
AccessibleComponent |
AccessibleComponent インタフェースは、画面に描画されるすべてのオブジェクトによってサポートされる必要があります。 |
AccessibleHypertext |
AccessibleHypertext クラスは、画面にハイパーテキスト情報を表示するすべてのクラスの基底クラスです。 |
AccessibleIcon |
AccessibleIcon インタフェースは、関連したアイコン (ボタンなど) を持つすべてのオブジェクトによってサポートされる必要があります。 |
AccessibleSelection |
この AccessibleSelection インタフェースは、現在選択されている子を判定したり、選択されているセットを変更するための標準的な機構を提供します。 |
AccessibleTable |
クラス AccessibleTable は、2 次元テーブル形式でデータを提示するユーザインタフェースコンポーネントを記述します。 |
AccessibleTableModelChange |
AccessibleTableModelChange インタフェースはテーブルモデルへの変更を記述します。 |
AccessibleText |
AccessibleText インタフェースは、テキスト情報を画面に表示するすべてのクラスによって実装される必要があります。 |
AccessibleValue |
AccessibleValue インタフェースは、数値をサポートするすべてのオブジェクト (スクロールバーなど) によってサポートされる必要があります。 |
パッケージ javax.accessibility の説明
コンポーネントにアクセスできるユーザ補助機能とユーザインタフェースコンポーネント間の規則を定義します。Java アプリケーションが Java Accessibility API を完全にサポートしている場合、画面リーダ、画面拡大機能などのユーザ補助機能と互換性があり、そうさしやすいものでなければなりません。Java Accessibility API を完全にサポートしている Java アプリケーションを使用する場合、API がオフ画面モデルに通常含まれるすべての情報を提供するので、オフ画面モデルの画面リーダは不要です。
Java Accessibility API パッケージは 8 つの Java プログラミング言語インタフェースと 6 つの Java プログラミング言語クラスで構成されています。これらについては下記で説明します。
インタフェース Accessible が Java Accessibility API の主なインタフェースです。Java Accessibility API をサポートするすべてのコンポーネントはこのインタフェースを実装している必要があります。これには 1 つのメソッド getAccessibleContext があり、クラス AccessibleContext のインスタンスを返します。Sun では、プログラムがユーザ補助機能と互換性がある場合、このインタフェースの実装が Java アプリケーションのユーザインタフェースの一部であるすべてのオブジェクトの絶対的な最低必用条件であると考えています。
AccessibleContext は、すべてのユーザ補助機能を実装するオブジェクトが返す最小情報を表し、Accessible インタフェースを実装するオブジェクトで getAccessibleContext メソッドを呼び出すと取得できます。この情報にはユーザ補助機能名、説明、役割とオブジェクトの状態や、オブジェクトの親や子に関する情報があります。 また、ユーザ補助プロパティ値が変更される時に、ユーザ補助機能で確認できるように、JavaBeans TM プロパティ変更サポートも取り入れられています。AccessibleContext には、コンポーネントに関するより詳細なユーザ補助機能の情報を取得するためのメソッドがあります。このコンポーネントが AccessibleContext をサポートしている場合、これらのメソッドは、以下の 1 つ以上のインタフェースを実装するオブジェクトを返します。
- AccessibleAction - オブジェクトは 1 つ以上のアクションを実行できます。このインタフェースは、実行するアクションを決定し、オブジェクトにそれらのアクションを実行するように指示するための標準機構をユーザ補助機能に提供します。操作可能なオブジェクトはすべて、getAccessibleAction メソッドが AccessibleContext で呼び出される時に、このインタフェースを実装するオブジェクトを返します。
- AccessibleComponent - オブジェクトはグラフィカルな表現を持ちます。このインタフェースは、オブジェクトのグラフィカルな表現を判定および設定するための標準機構をユーザ補助機能に提供します。画面に描画されるオブジェクトはすべて、getAccessibleComponent メソッドが AccessibleContext で呼び出される時に、このインタフェースを実装するオブジェクトを返します。
- AccessibleSelection - オブジェクトにより子の選択が可能になります。このインタフェースは、現在選択されているオブジェクトの子を判定したり、その選択範囲の設定を変更したりするための標準機構をユーザ補助機能に提供します。選択可能な子を持つオブジェクトはすべて、getAccessibleSelection メソッドが AccessibleContext で呼び出される時に、このインタフェースを実装するオブジェクトを返します。
- AccessibleText - オブジェクトは編集可能なテキスト情報を画面に表示します。このインタフェースは、内容、属性、および空間位置を使ってそのテキストにアクセスするための標準の機構をユーザ補助機能に提供します。編集可能なテキストを含むオブジェクトはすべて、getAccessibleText メソッドが AccessibleContext で呼び出される時に、このインタフェースを実装するオブジェクトを返します。
- AccessibleHypertext - オブジェクトはハイパーテキスト情報を画面に表示します。このインタフェースは、内容、属性、および空間位置を使ってそのハイパーテキストにアクセスするための標準の機構をユーザ補助機能に提供します。ハイパーテキストを含むオブジェクトはすべて、getAccessibleText メソッドが AccessibleContext で呼び出される時に、このインタフェースを実装するオブジェクトを返します。
- AccessibleValue - オブジェクトは数値をサポートします。このインタフェースは、オブジェクトの現在の値や最大値や最小値を判定および設定するための標準の機構をユーザ補助機能に提供します。数値をサポートするオブジェクトはすべて、getAccessibleValue メソッドが AccessibleContext で呼び出される時に、このインタフェースを実装するするオブジェクトを返します。
このクラスは、ユーザ補助機能を実装するオブジェクトの役割をユーザインタフェースにカプセル化し、getAccessibleRole メソッドを AccessibleContext で呼び出すことによって得られます。 ユーザ補助機能の役割には「チェックボックス」、「メニュー項目」、「パネル」などがあります。これらの役割は AccessibleRole.CHECK_BOX、AccessibleRole.MENU_ITEM、 および AccessibleRole.PANEL などのクラスの定数によって識別されます。このクラスの定数は、オブジェクトに共通のユーザ補助機能のデータ型の変更不可能な列挙を示します。このクラスの public コンストラクタは意図的に省略されており、アプリケーションはこのクラスから定数の 1 つを使用する必要があります。このクラスは標準の役割の大規模リストを事前定義していますが、拡張可能であるため、基底クラスを変更することなく、将来プログラマが定義した役割をさらに追加することができます。
このクラスはユーザ補助オブジェクトの個々の状態をカプセル化します。ユーザ補助機能の状態には、「準備状態 (Armed)」、「ビジー (Busy)」、「チェック済み (Checked)」、「フォーカス (Focused)」などがあります。これらの役割は、AccessibleState.ARMED、AccessibleState.BUSY、AccessibleState.CHECKED、と AccessibleState.FOCUSED などこのクラスの定数によって識別されます。ユーザ補助オブジェクトすべての状態の合計は AccessibleStateSet と呼ばれ、getAccessibleStateSet メソッドを AccessibleContext で呼び出すと取得できます。
このクラスの定数はオブジェクトに共通のユーザ補助機能のデータ型の列挙を示します。このクラスの public コンストラクタは意図的に省略されており、アプリケーションはこのクラスから定数の 1 つを使用する必要があります。このクラスは標準の役割の大規模リストを事前定義していますが、拡張可能であるため、基底クラスを変更することなく、将来プログラマが定義した役割をさらに追加することができます。
このクラスはユーザ補助オブジェクトの状態のコレクションをカプセル化し、getAccessibleStateSet メソッドを AccessibleContext で呼び出すと取得できます。オブジェクトが複数の状態 (たとえば「チェック済み (Checked) と 「フォーカス (Focused)」両方) を持つ可能性があるので、このクラスはこれらの状態のコレクションをカプセル化する必要があります。クラスのメソッドは、状態セットの個々の AccessibleStates の取り出し用に提供されています。
このクラスは強く型付けされた列挙を保持するために使われます。これは AccessibleRole と AccessibleState クラス両方のスーパークラスです。プログラマは通常このクラスと直接対話しませんが、その代わりに AccessibleRole や AccessibleState クラスを使用します。
AccessibleAction インタフェースは、1 つ以上のアクションを実行できるオブジェクトによってサポートされる必要があります。このインタフェースは、実行するアクションを決定し、オブジェクトにそれらのアクションを実行するように指示するための標準的な機構をユーザ補助機能に提供します。操作可能なオブジェクトはすべてこのインタフェースをサポートしている必要があります。
アプリケーションは、最初に AccessibleContext (Accessible を参照) を取得し、次に AccessibleContext の getAccessibleAction メソッドを呼び出すと、オブジェクトが AccessibleAction インタフェースをサポートしているか判断できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。
AccessibleComponent インタフェースは、画面上に描画されているオブジェクトによってサポートされている必要があります。このインタフェースは、オブジェクトのグラフィカルな表現を決定し、設定するための標準的な機構をユーザ補助機能に提供します。
アプリケーションは、最初に AccessibleContext (Accessible を参照) を取得し、次に AccessibleContext の getAccessibleComponent メソッドを呼び出すと、オブジェクトが AccessibleComponent インタフェースをサポートしているか判断できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。
AccessibleSelection インタフェースは、現在選択されている子を決めたり、選択セットを変更するための標準的な機構をユーザ補助機能に提供します。選択できる子を持つオブジェクトはすべてこの AccessibleSelection インタフェースをサポートしている必要があります。
アプリケーションは、最初に AccessibleContext (Accessible を参照) を取得し、次に AccessibleContext の getAccessibleSelection メソッドを呼び出すと、オブジェクトが AccessibleSelection インタフェースをサポートしているか判断できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。
インタフェース AccessibleText は、リッチで編集可能なテキストのユーザ補助機能の構成を請け負います。画面に表示されているすべてのテキストがリッチで編集可能とは限りません (たとえば、ボタン、ラベル、メニューに含まれるテキストで、ユーザーの操作が予想されていないテキスト)。しかし、ユーザ補助機能と共に使用する予定の場合、編集可能なテキストを含むオブジェクトはインタフェース AccessibleText を実装する必要があります。
このインタフェースは、指定したピクセル座標のテキストとピクセル座標の変換、テキスト内の指定した位置前後で文字、語および文の取り出しをサポートします。このインタフェースはテキスト内の指定した位置で文字の属性 (フォント、フォントサイズ、スタイルなど) の取り出しや、選択したテキスト (あれば) 、テキストの長さ、およびテキストキャレットの位置の取得をサポートします。
アプリケーションは、最初に AccessibleContext (Accessible を参照) を取得し、次に AccessibleContext の getAccessibleText メソッドを呼び出すと、オブジェクトが AccessibleText インタフェースをサポートしているか判断できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。
AccessibleHypertext インタフェースは、画面にハイパーテキスト情報を表示するすべてのオブジェクトによりサポートされる必要があります。このインタフェースは、コンテンツ、属性、および空間位置を使ってそのテキストにアクセスするための標準的な機構をユーザ補助機能に提供します。また、このインタフェースは、ハイパーリンクを操作するための標準的な機構も提供します。アプリケーションは、AccessibleContext (Accessible を参照) を取得してから、AccessibleContext の AccessibleContext.getAccessibleText() メソッドを呼び出すと、オブジェクトが AccessibleHypertext インタフェースをサポートするかどうかを判定できます。戻り値が AccessibleHypertext を拡張するクラスの場合は、そのオブジェクトは AccessibleHypertext をサポートしています。
ハイパーリンクであるオブジェクトは、AccessibleHyperlink インタフェースをサポートする必要があります。 このインタフェースを実装するオブジェクトは、AccessibleHypertext オブジェクトで getLink メソッドを呼び出すと返されます。
AccessibleValue インタフェースは、数値をサポートするすべてのオブジェクト (たとえば、スクロールバー) によってサポートされる必要があります。このインタフェースは数値を判定および設定したり、最小値および最大値を取得するための標準的な機構をユーザ補助機能に提供します。
アプリケーションは、最初に AccessibleContext (Accessible を参照) を取得し、次に AccessibleContext の getAccessibleValue メソッドを呼び出すと、オブジェクトが AccessibleValue インタフェースをサポートしているか判断できます。戻り値が null でなければ、そのオブジェクトはこのインタフェースをサポートしています。
- 導入されたバージョン:
- JDK1.2
バグや機能要求の報告
さらに詳しい 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.