モジュール java.desktop

パッケージ javax.accessibility

AccessibleStateクラス

java.lang.Object

javax.accessibility.AccessibleBundle

javax.accessibility.AccessibleState

public class AccessibleState extends AccessibleBundle

クラスAccessibleStateは、コンポーネントの特定の状態を示します。 コンポーネントの実際の状態は、AccessibleStateSetとして定義されます。これは、AccessibleStatesの合成されたセットです。

AccessibleBundle.toDisplayString()メソッドを使用すると、このクラスで定義されているキーのResourceBundleからロケールに依存しないキーのローカライズされた文字列を取得できます。

このクラスの定数は、一般的なオブジェクト役割の、強く型付けされた列挙を示します。 このクラスのpublicコンストラクタは意図的に省略されており、アプリケーションはこのクラスから定数の1つを使用する必要があります。 このクラスの定数が、オブジェクトの役割を記述するのに十分でない場合は、このクラスからサブクラスを生成して、同じようにして定数を提供する必要があります。

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final AccessibleState	ACTIVE	ウィンドウが現在アクティブであることを示します。
static final AccessibleState	ARMED	オブジェクトの作動準備が完了していることを示します。
static final AccessibleState	BUSY	現在のオブジェクトがビジーであることを示します。
static final AccessibleState	CHECKED	オブジェクトが現在オンであることを示します。
static final AccessibleState	COLLAPSED	オブジェクトが折りたたまれていることを示します。
static final AccessibleState	EDITABLE	オブジェクトの内容をユーザーが変更できることを示します。
static final AccessibleState	ENABLED	オブジェクトが有効であることを示します。
static final AccessibleState	EXPANDABLE	オブジェクトの子を少しずつ展開できることを示します。
static final AccessibleState	EXPANDED	オブジェクトが展開されていることを示します。
static final AccessibleState	FOCUSABLE	オブジェクトがキーボード・フォーカスを受け取ることができることを示します。オブジェクトにフォーカスがあるときは、キーボード入力によって起こるすべてのイベントがそのオブジェクトに渡されます。
static final AccessibleState	FOCUSED	現在このオブジェクトにキーボード・フォーカスがあることを示します。
static final AccessibleState	HORIZONTAL	オブジェクトの方向が水平方向であることを示します。
static final AccessibleState	ICONIFIED	オブジェクトが最小化され、アイコン表示されていることを示します。
static final AccessibleState	INDETERMINATE	オブジェクトの状態が不確定であることを示します。
static final AccessibleState	MANAGES_DESCENDANTS	オブジェクトがそのサブコンポーネントの管理を担当することを示します。
static final AccessibleState	MODAL	オブジェクトで何か処理を行わないと、ユーザーは別のウィンドウのオブジェクトを操作できないことを示します。
static final AccessibleState	MULTI_LINE	(テキスト)オブジェクトが、テキストを複数行格納できることを示します。
static final AccessibleState	MULTISELECTABLE	オブジェクトで、複数の子を同時に選択できることを示します。
static final AccessibleState	OPAQUE	オブジェクトが矩形領域のすべてのピクセルをペイントすることを示します。
static final AccessibleState	PRESSED	オブジェクトが現在押されていることを示します。
static final AccessibleState	RESIZABLE	オブジェクトのサイズが変更できることを示します。
static final AccessibleState	SELECTABLE	このオブジェクトは、子を選択できるオブジェクトの子で、選択できる子の1つであることを示します。
static final AccessibleState	SELECTED	このオブジェクトは、子を選択できるオブジェクトの子で、選択された子の1つであることを示します。
static final AccessibleState	SHOWING	オブジェクト、オブジェクトの親、オブジェクトの親の親などがすべて可視であることを示します。
static final AccessibleState	SINGLE_LINE	(テキスト)オブジェクトが、テキストを1行だけ格納できることを示します。
static final AccessibleState	TRANSIENT	オブジェクトが一時オブジェクトであることを示します。
static final AccessibleState	TRUNCATED	境界の矩形によってテキストが切り詰められており、テキストの一部が画面に表示されていないことを示します。
static final AccessibleState	VERTICAL	オブジェクトの方向が垂直方向であることを示します。
static final AccessibleState	VISIBLE	オブジェクトが可視であることを示します。

クラスjavax.accessibility.AccessibleBundleで宣言されたフィールド

key

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	AccessibleState(String key)	指定されたロケールに依存しないキーを使用して、新しいAccessibleStateを作成します。

メソッドのサマリー

クラスjavax.accessibility.AccessibleBundleで宣言されたメソッド

toDisplayString, toDisplayString, toDisplayString, toString

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールド詳細

ACTIVE

public static final AccessibleState ACTIVE

ウィンドウが現在アクティブであることを示します。 これにはウィンドウ、ダイアログ、フレームなどが含まれます。この状態は、リスト、表、ツリーなどのコンポーネントの現在アクティブな子を示すためにも使われます。 たとえば、周囲に矩形が描画されている子が、リスト内のアクティブな子です。

関連項目:

• AccessibleRole.WINDOW
• AccessibleRole.FRAME
• AccessibleRole.DIALOG

PRESSED

public static final AccessibleState PRESSED

オブジェクトが現在押されていることを示します。 通常はボタンに関連付けられていて、マウス・ポインタがボタンの上にあったときに、ユーザーがマウス・ボタンを押し、まだマウス・ボタンを離していないことを示します。

関連項目:

• AccessibleRole.PUSH_BUTTON

ARMED

public static final AccessibleState ARMED

オブジェクトの作動準備が完了していることを示します。 通常は、押されてまだ離されていないボタンで使用されます。マウス・ポインタはまだそのボタンの上にあります。

関連項目:

• AccessibleRole.PUSH_BUTTON

BUSY

public static final AccessibleState BUSY

現在のオブジェクトがビジーであることを示します。 通常は、進捗バー、スライダ、またはスクロール・バーなどのオブジェクトで使用され、それらが遷移中であることを示します。

関連項目:

• AccessibleRole.PROGRESS_BAR
• AccessibleRole.SCROLL_BAR
• AccessibleRole.SLIDER

CHECKED

public static final AccessibleState CHECKED

オブジェクトが現在オンであることを示します。 通常は、トグル・ボタン、ラジオ・ボタン、チェックボックスなどのオブジェクトで使用されます。

関連項目:

• AccessibleRole.TOGGLE_BUTTON
• AccessibleRole.RADIO_BUTTON
• AccessibleRole.CHECK_BOX

EDITABLE

public static final AccessibleState EDITABLE

オブジェクトの内容をユーザーが変更できることを示します。 通常は、主にユーザーがテキストを入力できるオブジェクトで使用されます。 また、スクロール・バーやスライダなどのオブジェクトは、有効になると自動的に編集可能になります。

関連項目:

• ENABLED

EXPANDABLE

public static final AccessibleState EXPANDABLE

オブジェクトの子を少しずつ展開できることを示します。 これは、通常、ツリーなどの階層オブジェクトで使用され、多くの場合、EXPANDEDまたはCOLLAPSEDの状態とペアになります。

関連項目:

• EXPANDED
• COLLAPSED
• AccessibleRole.TREE

COLLAPSED

public static final AccessibleState COLLAPSED

オブジェクトが折りたたまれていることを示します。 これは通常、EXPANDABLE状態とペアになり、ツリーのような漸進的な情報を提供するオブジェクトで使用されます。

関連項目:

• EXPANDABLE
• EXPANDED
• AccessibleRole.TREE

EXPANDED

public static final AccessibleState EXPANDED

オブジェクトが展開されていることを示します。 これは通常、EXPANDABLE状態とペアになり、ツリーのような漸進的な情報を提供するオブジェクトで使用されます。

関連項目:

• EXPANDABLE
• COLLAPSED
• AccessibleRole.TREE

ENABLED

public static final AccessibleState ENABLED

オブジェクトが有効であることを示します。 オブジェクトの状態セットにこの状態がない場合は、このオブジェクトは有効ではありません。 有効でないオブジェクトは、ユーザーは操作できません。 グラフィカルな表示では、通常、グレーで表示されます。

FOCUSABLE

public static final AccessibleState FOCUSABLE

オブジェクトがキーボード・フォーカスを受け取ることができることを示します。オブジェクトにフォーカスがあるときは、キーボード入力によって起こるすべてのイベントがそのオブジェクトに渡されます。

関連項目:

• FOCUSED

FOCUSED

public static final AccessibleState FOCUSED

現在このオブジェクトにキーボード・フォーカスがあることを示します。

関連項目:

• FOCUSABLE

ICONIFIED

public static final AccessibleState ICONIFIED

オブジェクトが最小化され、アイコン表示されていることを示します。 通常は、フレームおよび内部フレームだけに関連付けられます。

関連項目:

• AccessibleRole.FRAME
• AccessibleRole.INTERNAL_FRAME

MODAL

public static final AccessibleState MODAL

オブジェクトで何か処理を行わないと、ユーザーは別のウィンドウのオブジェクトを操作できないことを示します。 通常は、ダイアログだけに関連付けられます。

関連項目:

• AccessibleRole.DIALOG

OPAQUE

public static final AccessibleState OPAQUE

オブジェクトが矩形領域のすべてのピクセルをペイントすることを示します。 不透明でないコンポーネントは、一部のピクセルだけをペイントし、その下のピクセルが透けて見えるようにします。 ピクセルを完全にペイントしないコンポーネントはある程度の透明度があります。

関連項目:

• Accessible.getAccessibleContext()
• AccessibleContext.getAccessibleComponent()
• AccessibleComponent.getBounds()

RESIZABLE

public static final AccessibleState RESIZABLE

オブジェクトのサイズが変更できることを示します。

関連項目:

• Accessible.getAccessibleContext()
• AccessibleContext.getAccessibleComponent()
• AccessibleComponent.getSize()
• AccessibleComponent.setSize(java.awt.Dimension)

MULTISELECTABLE

public static final AccessibleState MULTISELECTABLE

オブジェクトで、複数の子を同時に選択できることを示します。

関連項目:

• Accessible.getAccessibleContext()
• AccessibleContext.getAccessibleSelection()
• AccessibleSelection

SELECTABLE

public static final AccessibleState SELECTABLE

このオブジェクトは、子を選択できるオブジェクトの子で、選択できる子の1つであることを示します。

関連項目:

• SELECTED
• Accessible.getAccessibleContext()
• AccessibleContext.getAccessibleSelection()
• AccessibleSelection

SELECTED

public static final AccessibleState SELECTED

このオブジェクトは、子を選択できるオブジェクトの子で、選択された子の1つであることを示します。

関連項目:

• SELECTABLE
• Accessible.getAccessibleContext()
• AccessibleContext.getAccessibleSelection()
• AccessibleSelection

SHOWING

public static final AccessibleState SHOWING

オブジェクト、オブジェクトの親、オブジェクトの親の親などがすべて可視であることを示します。 ただし、オブジェクトは必ずしも画面にペイントされているわけではありません。 表示されているほかのオブジェクトに隠れて見えない場合もあります。

関連項目:

• VISIBLE

VISIBLE

public static final AccessibleState VISIBLE

オブジェクトが可視であることを示します。 ノート: オブジェクトを可視にしようとしても、オブジェクトのコンテナが可視でない場合は、オブジェクトも画面に表示されないことがあります。

関連項目:

• SHOWING

VERTICAL

public static final AccessibleState VERTICAL

オブジェクトの方向が垂直方向であることを示します。 通常は、スクロール・バー、スライダ、進捗バーなどのオブジェクトに関連付けられます。

関連項目:

• HORIZONTAL
• AccessibleRole.SCROLL_BAR
• AccessibleRole.SLIDER
• AccessibleRole.PROGRESS_BAR

HORIZONTAL

public static final AccessibleState HORIZONTAL

オブジェクトの方向が水平方向であることを示します。 通常は、スクロール・バー、スライダ、進捗バーなどのオブジェクトに関連付けられます。

関連項目:

• VERTICAL
• AccessibleRole.SCROLL_BAR
• AccessibleRole.SLIDER
• AccessibleRole.PROGRESS_BAR

SINGLE_LINE

public static final AccessibleState SINGLE_LINE

(テキスト)オブジェクトが、テキストを1行だけ格納できることを示します。

MULTI_LINE

public static final AccessibleState MULTI_LINE

(テキスト)オブジェクトが、テキストを複数行格納できることを示します。

TRANSIENT

public static final AccessibleState TRANSIENT

オブジェクトが一時オブジェクトであることを示します。 補助技術は、トランジェント状態のオブジェクトにPropertyChangeリスナーを追加しないでください。そのリスナーはイベントを生成しないためです。 一時オブジェクトは、通常、Java Accessibilityのメソッド問合せに応答するために作成されますが、それ以外の場合は、基になるオブジェクト(たとえば、実際のlist/table/tree要素の下にあるすべてのデータ・オブジェクトに対して、1つの実際のUI Componentだけがレンダリング作業を行うSwingのリスト、表、ツリーの下にあるオブジェクト)にはリンクされません。

導入されたバージョン:

1.5

MANAGES_DESCENDANTS

public static final AccessibleState MANAGES_DESCENDANTS

オブジェクトがそのサブコンポーネントの管理を担当することを示します。 通常は、多数のサブコンポーネント(必要なときだけ作成され、そうでないときは仮想のまま)を持つツリーや表に使用されます。 アプリケーションではサブコンポーネントを直接管理しないようにしてください。

導入されたバージョン:

1.5

INDETERMINATE

public static final AccessibleState INDETERMINATE

オブジェクトの状態が不確定であることを示します。 たとえば、選択されたテキストの一部が太字で、一部は太字でない場合などです。 この場合、選択されたテキストに関連付けられた属性は不確定になります。

導入されたバージョン:

1.5

TRUNCATED

public static final AccessibleState TRUNCATED

境界の矩形によってテキストが切り詰められており、テキストの一部が画面に表示されていないことを示します。 たとえば、スプレッドシートのセル内のテキストがセルの境界によって切り詰められている場合などです。

導入されたバージョン:

1.5

コンストラクタの詳細

AccessibleState

protected AccessibleState(String key)

指定されたロケールに依存しないキーを使用して、新しいAccessibleStateを作成します。 このメソッドは、publicメソッドにはできません。 代わりに、このファイルで定数を作成して、強く型付けされた列挙にするために使用されます。 このクラスのサブクラスは同様のポリシーを適用する必要があります。

キーStringは、その状態のロケールに依存しないキーでなければなりません。 これは、ユーザーに表示する実際のStringとして使用するためのものではありません。 ローカライズされた文字列を取得するには、AccessibleBundle.toDisplayString()を使用します。

パラメータ:

key - ロケールに依存しない、状態の名前

関連項目:

• AccessibleBundle.toDisplayString(java.lang.String, java.util.Locale)