Java プラットフォーム 1.2

javax.accessibility
クラス AccessibleContext

java.lang.Object
  |
  +--javax.accessibility.AccessibleContext
直接の既知のサブクラス:
Box.AccessibleBox, Box.Filler.AccessibleBoxFiller, CellRendererPane.AccessibleCellRendererPane, JApplet.AccessibleJApplet, JComponent.AccessibleJComponent, JDialog.AccessibleJDialog, JFrame.AccessibleJFrame, JList.AccessibleJList.AccessibleJListChild, JTable.AccessibleJTable.AccessibleJTableCell, JTableHeader.AccessibleJTableHeader.AccessibleJTableHeaderEntry, JTree.AccessibleJTree.AccessibleJTreeNode, JWindow.AccessibleJWindow
public abstract class AccessibleContext
extends Object

AccessibleContext は、すべてのユーザ補助機能を実装するオブジェクトが返す共通の最小情報を表します。この情報には、ユーザ補助機能名、説明、機能、およびオブジェクトの状態や、オブジェクトの親および子についての情報などがあります。また、AccessibleContext には、あるコンポーネントについての、より詳細なユーザ補助機能の情報を取得するためのメソッドがあります。このコンポーネントが AccessibleContext をサポートしている場合、これらのメソッドは、以下の 1 つ以上のインタフェースを実装するオブジェクトを返します。

今後、さらにインタフェース (たとえば AccessibleTable) が追加される可能性があり、それに伴って abstract クラス AccessibleContext が更新される予定です。

フィールドの概要
static String ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY
          コンポーネントのアクティブな子孫がいつ変更されたかを判定するために使用する定数です。
static String ACCESSIBLE_CARET_PROPERTY
          accessibleText のキャレットがいつ変更されたかを判定するのに使用する定数です。
static String ACCESSIBLE_CHILD_PROPERTY
          ユーザ補助機能を実装する子がいつオブジェクトで追加または削除されたかを判定するのに使用する定数です。
static String ACCESSIBLE_DESCRIPTION_PROPERTY
          accessibleDescription プロパティがいつ変更されたかを判定するのに使用する定数です。
static String ACCESSIBLE_NAME_PROPERTY
          accessibleName プロパティがいつ変更されたかを判定するのに使用する定数です。
static String ACCESSIBLE_SELECTION_PROPERTY
          accessibleSelection がいつ変更されたかを判定するのに使用する定数です。
static String ACCESSIBLE_STATE_PROPERTY
          accessibleStateSet プロパティがいつ変更されたかを判定するのに使用する定数です。
static String ACCESSIBLE_TEXT_PROPERTY
          accessibleText がいつ変更されたかを判定するのに使用する定数です。
static String ACCESSIBLE_VALUE_PROPERTY
          accessibleValue プロパティがいつ変更されたかを判定するのに使用する定数です。
static String ACCESSIBLE_VISIBLE_DATA_PROPERTY
          オブジェクトの視覚表現がいつ変更されたかを判定するのに使用する定数です。
protected  String accessibleDescription
          オブジェクトの説明を格納する地域対応された String です。
protected  String accessibleName
          オブジェクトの名前を格納する地域対応された String です。
protected  Accessible accessibleParent
          オブジェクトのユーザ補助機能を実装する親です。
 
コンストラクタの概要
AccessibleContext()
           
 
メソッドの概要
 void addPropertyChangeListener(PropertyChangeListener listener)
          リスナーリストに PropertyChangeListener を追加します。
 void firePropertyChange(String propertyName, Object oldValue, Object newValue)
          バウンドプロパティ変更のレポートをサポートします。
 AccessibleAction getAccessibleAction()
          1 つ以上のアクションをサポートするこのオブジェクトに関連付けられている AccessibleAction を取得します。
abstract  Accessible getAccessibleChild(int i)
          オブジェクトの、指定されたユーザ補助機能を実装する子を返します。
abstract  int getAccessibleChildrenCount()
          オブジェクトの、ユーザ補助機能を実装する子の数を返します。
 AccessibleComponent getAccessibleComponent()
          グラフィカルな表現を持つこのオブジェクトに関連付けられている AccessibleComponent を取得します。
 String getAccessibleDescription()
          オブジェクトの accessibleDescription プロパティを取得します。
abstract  int getAccessibleIndexInParent()
          ユーザ補助機能を実装する親での、このオブジェクトのゼロから始まるインデックスを取得します。
 String getAccessibleName()
          オブジェクトの accessibleName プロパティを取得します。
 Accessible getAccessibleParent()
          オブジェクトのユーザ補助機能を実装する親を取得します。
abstract  AccessibleRole getAccessibleRole()
          オブジェクトのユーザ補助機能を取得します。
 AccessibleSelection getAccessibleSelection()
          ユーザ補助機能を実装する子の選択を許可するこのオブジェクトに関連付けられている AccessibleSelection を取得します。
abstract  AccessibleStateSet getAccessibleStateSet()
          オブジェクトのセットの状態を取得します。
 AccessibleText getAccessibleText()
          画面で現在編集可能なテキストであるこのオブジェクトに関連付けられている AccessibleText を取得します。
 AccessibleValue getAccessibleValue()
          数値をサポートするこのオブジェクトに関連付けられている AccessibleValue を取得します。
abstract  Locale getLocale()
          コンポーネントのロケールを取得します。
 void removePropertyChangeListener(PropertyChangeListener listener)
          リスナーリストから PropertyChangeListener を削除します。
 void setAccessibleDescription(String s)
          オブジェクトについてのユーザ補助機能の説明を設定します。
 void setAccessibleName(String s)
          オブジェクトの地域対応されたユーザ補助のための名前を設定します。
 void setAccessibleParent(Accessible a)
          オブジェクトのユーザ補助機能を実装する親を設定します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

ACCESSIBLE_NAME_PROPERTY

public static final String ACCESSIBLE_NAME_PROPERTY
accessibleName プロパティがいつ変更されたかを判定するのに使用する定数です。PropertyChangeEvent の旧値は以前の accessibleName、新値は新しい accessibleName です。
関連項目:
getAccessibleName(), addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_DESCRIPTION_PROPERTY

public static final String ACCESSIBLE_DESCRIPTION_PROPERTY
accessibleDescription プロパティがいつ変更されたかを判定するのに使用する定数です。PropertyChangeEvent の旧値は以前の accessibleDescription、新値は新しい accessibleDescription です。
関連項目:
getAccessibleDescription(), addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_STATE_PROPERTY

public static final String ACCESSIBLE_STATE_PROPERTY
accessibleStateSet プロパティがいつ変更されたかを判定するのに使用する定数です。旧値は以前の AccessibleState、新値は accessibleStateSet の新しい AccessibleState です。たとえば、垂直および水平方向の状態をサポートするコンポーネントが方向を垂直から水平へ変更した場合は、旧値は AccessibleState.VERTICAL で 新値は AccessibleState.HORIZONTAL です。どちらかの値が null になることもあります。たとえば、コンポーネントが有効から無効に変更されたときに、旧値は AccessibleState.ENABLED、新値は null になります。
関連項目:
getAccessibleStateSet(), AccessibleState, AccessibleStateSet, addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_VALUE_PROPERTY

public static final String ACCESSIBLE_VALUE_PROPERTY
accessibleValue プロパティがいつ変更されたかを判定するのに使用する定数です。PropertyChangeEvent の旧値は以前の値を表す Number、新値は新しい値を表す Number です。
関連項目:
getAccessibleValue(), addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_SELECTION_PROPERTY

public static final String ACCESSIBLE_SELECTION_PROPERTY
accessibleSelection がいつ変更されたかを判定するのに使用する定数です。PropertyChangeEvent の旧値と新値は、現時点では、今後使用するために予約されています。
関連項目:
getAccessibleSelection(), addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_TEXT_PROPERTY

public static final String ACCESSIBLE_TEXT_PROPERTY
accessibleText がいつ変更されたかを判定するのに使用する定数です。PropertyChangeEvent の旧値と新値は、現時点では、今後使用するために予約されています。
関連項目:
getAccessibleText(), addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_CARET_PROPERTY

public static final String ACCESSIBLE_CARET_PROPERTY
accessibleText のキャレットがいつ変更されたかを判定するのに使用する定数です。ChangeEvent の旧値は以前のキャレット位置を表す整数値、新値は新しいかまたは現在のキャレット位置を表す整数値です。
関連項目:
addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_VISIBLE_DATA_PROPERTY

public static final String ACCESSIBLE_VISIBLE_DATA_PROPERTY
オブジェクトの視覚表現がいつ変更されたかを判定するのに使用する定数です。PropertyChangeEvent の旧値と新値は、現時点では未使用です。
関連項目:
addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_CHILD_PROPERTY

public static final String ACCESSIBLE_CHILD_PROPERTY
ユーザ補助機能を実装する子がいつオブジェクトで追加または削除されたかを判定するのに使用する定数です。ユーザ補助機能を実装する子が追加される場合は、旧値は null、新値はユーザ補助機能を実装する子です。ユーザ補助機能を実装する子が削除される場合は、旧値はユーザ補助機能を実装する子、新値は null です。
関連項目:
addPropertyChangeListener(java.beans.PropertyChangeListener)

ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY

public static final String ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY
コンポーネントのアクティブな子孫がいつ変更されたかを判定するために使用する定数です。アクティブな子孫は、リスト、ツリー、テーブルなどの一時的な子を持つ可能性のあるオブジェクトに使用されます。アクティブな子孫が変更された場合、プロパティ変更イベントの旧値は以前のアクティブな子を表す Accessible、新値は現在のアクティブな子を表す Accessible になります。
関連項目:
addPropertyChangeListener(java.beans.PropertyChangeListener)

accessibleParent

protected Accessible accessibleParent
オブジェクトのユーザ補助機能を実装する親です。
関連項目:
getAccessibleParent(), setAccessibleParent(javax.accessibility.Accessible)

accessibleName

protected String accessibleName
オブジェクトの名前を格納する地域対応された String です。
関連項目:
getAccessibleName(), setAccessibleName(java.lang.String)

accessibleDescription

protected String accessibleDescription
オブジェクトの説明を格納する地域対応された String です。
関連項目:
getAccessibleDescription(), setAccessibleDescription(java.lang.String)
コンストラクタの詳細

AccessibleContext

public AccessibleContext()
メソッドの詳細

getAccessibleName

public String getAccessibleName()
オブジェクトの accessibleName プロパティを取得します。オブジェクトの accessibleName プロパティは、オブジェクトの目的を示す地域対応された String です。たとえば、ラベルまたはボタンの accessibleName プロパティの場合、ラベルまたはボタン自体のテキストである場合もあります。名前を表示しないオブジェクトの場合でも、accessibleName を設定する必要があります。たとえば、市の名前を入力するのに使用するテキストフィールドの場合、en_US ロケールの accessibleName は「city」になります。
戻り値:
オブジェクトの地域対応された名前。このオブジェクトに名前がない場合は null
関連項目:
setAccessibleName(java.lang.String)

setAccessibleName

public void setAccessibleName(String s)
オブジェクトの地域対応されたユーザ補助のための名前を設定します。名前を変更すると、ACCESSIBLE_NAME_PROPERTY プロパティで PropertyChangeEvent がトリガーされます。
パラメータ:
s - オブジェクトの新しい地域対応された名前
関連項目:
getAccessibleName(), addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleDescription

public String getAccessibleDescription()
オブジェクトの accessibleDescription プロパティを取得します。このオブジェクトの accessibleDescription プロパティは、オブジェクトの目的を説明する地域対応された短いテキストです。たとえば、「Cancel」ボタンの場合、accessibleDescription は「Ignore changes and close dialog box」などのようになります。
戻り値:
オブジェクトについて説明する地域対応されたテキスト。このオブジェクトに説明がない場合は null
関連項目:
setAccessibleDescription(java.lang.String)

setAccessibleDescription

public void setAccessibleDescription(String s)
オブジェクトについてのユーザ補助機能の説明を設定します。名前を変更すると、ACCESSIBLE_DESCRIPTION_PROPERTY プロパティで PropertyChangeEvent がトリガーされます。
パラメータ:
s - オブジェクトについて説明する地域対応された新しいテキスト
関連項目:
setAccessibleName(java.lang.String), addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleRole

public abstract AccessibleRole getAccessibleRole()
オブジェクトのユーザ補助機能を取得します。オブジェクトのユーザ補助機能は、包括的な目的、またはこのオブジェクトのクラスの使用です。たとえば、プッシュボタンのユーザ補助機能は AccessibleRole.PUSH_BUTTON です。AccessibleRole でのユーザ補助機能は、コンポーネント開発者が事前に定義された機能のセットから選択できるように提供されています。これにより、ユーザ補助機能はコンポーネントのさまざまに修正されたサブクラスに一貫したインタフェースを提供したり (たとえば、プッシュボタンのように動作するすべてのコンポーネントで AccessibleRole.PUSH_BUTTON を使用するなど)、異なる動作をするサブクラスを区別 (たとえば、チェックボックスでは AccessibleRole.CHECK_BOX、ラジオボタンでは AccessibleRole.RADIO_BUTTON など) することができます。

AccessibleRole クラスは拡張可能でもあるので、カスタムコンポーネントの開発者は、事前に定義されたユーザ補助機能のセットでは不十分な場合に、独自の AccessibleRole を定義できます。

戻り値:
オブジェクトのユーザ補助機能を説明する AccessibleRole のインスタンス
関連項目:
AccessibleRole

getAccessibleStateSet

public abstract AccessibleStateSet getAccessibleStateSet()
オブジェクトのセットの状態を取得します。オブジェクトの AccessibleStateSet は、一意の AccessibleState のセットです。オブジェクトの AccessibleStateSet を変更すると、ACCESSIBLE_STATE_PROPERTY プロパティで PropertyChangeEvent がトリガーされます。
戻り値:
現在の状態のオブジェクトのセットを格納する AccessibleStateSet のインスタンス
関連項目:
AccessibleStateSet, AccessibleState, addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleParent

public Accessible getAccessibleParent()
オブジェクトのユーザ補助機能を実装する親を取得します。
戻り値:
このオブジェクトのユーザ補助を実装する親。このオブジェクトにユーザ補助機能を実装する親がない場合は null

setAccessibleParent

public void setAccessibleParent(Accessible a)
オブジェクトのユーザ補助機能を実装する親を設定します。このメソッドでは、実際のコンポーネントの親をコンポーネントのユーザ補助機能を実装する親として扱えない状況でのみ使用され、ユーザ補助機能を実装する子の親によってのみ呼び出されます。
パラメータ:
a - 親として設定される Accessible

getAccessibleIndexInParent

public abstract int getAccessibleIndexInParent()
ユーザ補助機能を実装する親での、このオブジェクトのゼロから始まるインデックスを取得します。
戻り値:
親での、このオブジェクトのゼロから始まるインデックス。このオブジェクトにユーザ補助機能を実装する親がない場合は -1
関連項目:
getAccessibleParent(), getAccessibleChildrenCount(), getAccessibleChild(int)

getAccessibleChildrenCount

public abstract int getAccessibleChildrenCount()
オブジェクトの、ユーザ補助機能を実装する子の数を返します。
戻り値:
オブジェクトの、ユーザ補助機能を実装する子の数

getAccessibleChild

public abstract Accessible getAccessibleChild(int i)
オブジェクトの、指定されたユーザ補助機能を実装する子を返します。ユーザ補助オブジェクトのユーザ補助機能を実装する子はゼロから始まるインデックスが割り当てられているので、ユーザ補助機能を実装する最初の子はインデックス 0、2 番目の子は 1 のようになります。
パラメータ:
i - 子のゼロから始まるインデックス
戻り値:
オブジェクトのユーザ補助機能を実装する子
関連項目:
getAccessibleChildrenCount()

getLocale

public abstract Locale getLocale()
                          throws IllegalComponentStateException
コンポーネントのロケールを取得します。コンポーネントにロケールがない場合は、親のロケールが返されます。
戻り値:
コンポーネントのロケール。コンポーネントにロケールがない場合は、親のロケール
例外:
IllegalComponentStateException - Component に独自のロケールがなく、包含している親からロケールを判定できる包含関係の階層にまだ追加されていない場合

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
リスナーリストに PropertyChangeListener を追加します。リスナーは、すべての Accessible プロパティで登録され、それらのプロパティが変更されたときに呼び出されます。
パラメータ:
listener - 追加する PropertyChangeListener
関連項目:
ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
リスナーリストから PropertyChangeListener を削除します。すべてのプロパティで登録された PropertyChangeListener が削除されます。
パラメータ:
listener - 削除する PropertyChangeListener

getAccessibleAction

public AccessibleAction getAccessibleAction()
1 つ以上のアクションをサポートするこのオブジェクトに関連付けられている AccessibleAction を取得します。
戻り値:
オブジェクトによってサポートされている場合は AccessibleAction、そうでない場合は null
関連項目:
AccessibleAction

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()
グラフィカルな表現を持つこのオブジェクトに関連付けられている AccessibleComponent を取得します。
戻り値:
オブジェクトによってサポートされている場合は AccessibleComponent、そうでない場合は null
関連項目:
AccessibleComponent

getAccessibleSelection

public AccessibleSelection getAccessibleSelection()
ユーザ補助機能を実装する子の選択を許可するこのオブジェクトに関連付けられている AccessibleSelection を取得します。
戻り値:
オブジェクトによってサポートされている場合は AccessibleSelection、そうでない場合は null
関連項目:
AccessibleSelection

getAccessibleText

public AccessibleText getAccessibleText()
画面で現在編集可能なテキストであるこのオブジェクトに関連付けられている AccessibleText を取得します。
戻り値:
オブジェクトによってサポートされている場合は AccessibleText、そうでない場合は null
関連項目:
AccessibleText

getAccessibleValue

public AccessibleValue getAccessibleValue()
数値をサポートするこのオブジェクトに関連付けられている AccessibleValue を取得します。
戻り値:
オブジェクトによってサポートされている場合は AccessibleValue、そうでない場合は null
関連項目:
AccessibleValue

firePropertyChange

public void firePropertyChange(String propertyName,
                               Object oldValue,
                               Object newValue)
バウンドプロパティ変更のレポートをサポートします。oldValue と newValue が同じでなく、PropertyChangeEvent リスナーリストが空でない場合は、各リスナーに PropertyChange イベントをトリガーします。通常、このメソッドは Accessible オブジェクト自体によって使用され、アプリケーションプログラムから呼び出してはなりません。
パラメータ:
propertyName - 変更されたプロパティのプログラム名
oldValue - プロパティの旧値
newValue - プロパティの新値
関連項目:
PropertyChangeSupport, addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY
Java プラットフォーム 1.2
バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.