モジュール java.desktop
パッケージ javax.accessibility

AccessibleContextクラス

java.lang.Object
javax.accessibility.AccessibleContext
直系の既知のサブクラス:
Component.AccessibleAWTComponent, ImageIcon.AccessibleImageIcon, JList.AccessibleJList.AccessibleJListChild, JTable.AccessibleJTable.AccessibleJTableCell, JTableHeader.AccessibleJTableHeader.AccessibleJTableHeaderEntry, JTree.AccessibleJTree.AccessibleJTreeNode, MenuComponent.AccessibleAWTMenuComponent, ProgressMonitor.AccessibleProgressMonitor, Translator
@JavaBean(description="Minimal information that all accessible objects return") public abstract class AccessibleContext extends Object
AccessibleContextは、すべてのアクセス可能なオブジェクトが返す最小限の情報を表します。 この情報には、Accessible名、説明、機能、およびオブジェクトの状態や、オブジェクトの親および子についての情報などがあります。 AccessibleContextには、コンポーネントに関するより具体的なアクセシビリティ情報を取得するためのメソッドも含まれています。 このコンポーネントがそれらをサポートしている場合、これらのメソッドは、次の1つ以上のインタフェースを実装するオブジェクトを返します。
  • AccessibleAction - オブジェクトは1つ以上のアクションを実行できます。 このインタフェースは、実行するアクションを決定し、オブジェクトにそれらのアクションを実行するように指示するための標準メカニズムをユーザー補助テクノロジに提供します。 操作可能なオブジェクトはすべてこのインタフェースをサポートする必要があります。
  • AccessibleComponent - オブジェクトはグラフィカルな表現を持ちます。 このインタフェースは、オブジェクトのグラフィカルな表現を判定および設定するための標準メカニズムをユーザー補助テクノロジに提供します。 画面に描画されるオブジェクトはすべてこのインタフェースをサポートする必要があります。
  • AccessibleSelection - オブジェクトは子の選択を許可します。 このインタフェースは、現在選択されているオブジェクトの子を判定したり、その選択範囲の設定を変更したりするための標準メカニズムをユーザー補助テクノロジに提供します。 選択可能な子を持つオブジェクトはすべてこのインタフェースをサポートする必要があります。
  • AccessibleText - オブジェクトは編集可能なテキスト情報を画面に表示します。 このインタフェースは、内容、属性、および空間位置を使ってそのテキストにアクセスするための標準メカニズムをユーザー補助テクノロジに提供します。 編集可能なテキストを含むオブジェクトはすべてこのインタフェースをサポートする必要があります。
  • AccessibleValue - オブジェクトは数値をサポートします。 このインタフェースは、オブジェクトの現在の値や最大値や最小値を判定および設定するための標準のメカニズムをユーザー補助テクノロジに提供します。 数値をサポートするオブジェクトはすべてこのインタフェースをサポートする必要があります。

  • フィールド詳細

    • ACCESSIBLE_NAME_PROPERTY

      public static final String ACCESSIBLE_NAME_PROPERTY
      accessibleNameプロパティが変更された時期を決定するために使用する定数です。 PropertyChangeEventの古い値は古いaccessibleNameになり、新しい値は新しいaccessibleNameになります。
      関連項目:

    • ACCESSIBLE_DESCRIPTION_PROPERTY

      public static final String ACCESSIBLE_DESCRIPTION_PROPERTY
      accessibleDescriptionプロパティが変更された時期を決定するために使用する定数です。 PropertyChangeEventの古い値は古いaccessibleDescriptionになり、新しい値は新しいaccessibleDescriptionになります。
      関連項目:

    • ACCESSIBLE_STATE_PROPERTY

      public static final String ACCESSIBLE_STATE_PROPERTY
      accessibleStateSetプロパティがいつ変更されたかを判別するために使用される定数です。 古い値は古いAccessibleStateになり、新しい値はaccessibleStateSetの新しいAccessibleStateになります。 たとえば、垂直および水平の状態をサポートするコンポーネントが垂直から水平に向きを変える場合、古い値はAccessibleState.VERTICALになり、新しい値はAccessibleState.HORIZONTALになります。 どちらの値もnullになることに注意してください。 たとえば、コンポーネントが有効化から無効化に変わると、古い値はAccessibleState.ENABLEDになり、新しい値はnullになります。
      関連項目:

    • ACCESSIBLE_VALUE_PROPERTY

      public static final String ACCESSIBLE_VALUE_PROPERTY
      accessibleValueプロパティがいつ変更されたかを判別するために使用される定数です。 PropertyChangeEventの古い値は古い値を表すNumberになり、新しい値は新しい値を表すNumberになります。
      関連項目:

    • ACCESSIBLE_SELECTION_PROPERTY

      public static final String ACCESSIBLE_SELECTION_PROPERTY
      accessibleSelectionがいつ変更されたかを決定するために使用される定数です。 PropertyChangeEventの古い値と新しい値は、将来の使用のために現在予約されています。
      関連項目:

    • ACCESSIBLE_CARET_PROPERTY

      public static final String ACCESSIBLE_CARET_PROPERTY
      accessibleTextキャレットがいつ変更されたかを判断するために使用する定数です。 PropertyChangeEventの古い値は古いキャレット位置を表す整数になり、新しい値は新しい/現在のキャレット位置を表す整数になります。
      関連項目:

    • ACCESSIBLE_VISIBLE_DATA_PROPERTY

      public static final String ACCESSIBLE_VISIBLE_DATA_PROPERTY
      オブジェクトのビジュアルな表現がいつ変更されたかを判定するのに使用する定数です。 PropertyChangeEventの古い値と新しい値は、将来の使用のために現在予約されています。
      関連項目:

    • ACCESSIBLE_CHILD_PROPERTY

      public static final String ACCESSIBLE_CHILD_PROPERTY
      Accessibleの子がオブジェクトに追加/削除される時期を決定するために使用する定数です。 Accessible子が追加されている場合、古い値はnullになり、新しい値はAccessible子になります。 Accessible子が削除されている場合、古い値はAccessible子になり、新しい値はnullになります。
      関連項目:

    • ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY

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

    • ACCESSIBLE_TABLE_CAPTION_CHANGED

      public static final String ACCESSIBLE_TABLE_CAPTION_CHANGED
      表のキャプションが変更されたことを示すために使用される定数です。 PropertyChangeEventの古い値は、前の表のキャプションを表すAccessibleになり、新しい値は新しい表キャプションを表すAccessibleになります。
      関連項目:

    • ACCESSIBLE_TABLE_SUMMARY_CHANGED

      public static final String ACCESSIBLE_TABLE_SUMMARY_CHANGED
      表サマリーが変更されたことを示すために使用する定数です。 PropertyChangeEventの古い値は、前の表サマリーを表すAccessibleになり、新しい値は新しい表サマリーを表すAccessibleになります。
      関連項目:

    • ACCESSIBLE_TABLE_MODEL_CHANGED

      public static final String ACCESSIBLE_TABLE_MODEL_CHANGED
      表のデータが変更されたことを示すのに使用する定数です。 PropertyChangeEventの古い値はnullになり、新しい値はテーブルの変更を表すAccessibleTableModelChangeになります。
      関連項目:

    • ACCESSIBLE_TABLE_ROW_HEADER_CHANGED

      public static final String ACCESSIBLE_TABLE_ROW_HEADER_CHANGED
      行ヘッダーが変更されたことを示すために使用する定数です。 PropertyChangeEventの古い値はnullになり、新しい値はヘッダーの変更を表すAccessibleTableModelChangeになります。
      関連項目:

    • ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED

      public static final String ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED
      行の記述が変更されたことを示すために使用する定数です。 PropertyChangeEventの古い値はnullになり、新しい値は行インデックスを表すIntegerになります。
      関連項目:

    • ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED

      public static final String ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED
      列ヘッダーが変更されたことを示すために使用する定数です。 PropertyChangeEventの古い値はnullになり、新しい値はヘッダーの変更を表すAccessibleTableModelChangeになります。
      関連項目:

    • ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED

      public static final String ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED
      列の記述が変更されたことを示すために使用される定数です。 PropertyChangeEventの古い値はnullになり、新しい値は列インデックスを表すIntegerになります。
      関連項目:

    • ACCESSIBLE_ACTION_PROPERTY

      public static final String ACCESSIBLE_ACTION_PROPERTY
      サポートされているアクションのセットが変更されたことを示すのに使用する定数です。 PropertyChangeEventの古い値は、サポートされているアクションの古い数を表すIntegerになり、新しい値は、サポートされるアクションの新しい数を表すIntegerになります。
      関連項目:

    • ACCESSIBLE_HYPERTEXT_OFFSET

      public static final String ACCESSIBLE_HYPERTEXT_OFFSET
      ハイパーテキスト要素がフォーカスを受け取ったことを示すのに使用する定数です。 PropertyChangeEventの古い値は、フォーカスを持っていた前の要素のドキュメント内の開始インデックスを表すIntegerになり、新しい値はフォーカスを持つ現在の要素のドキュメント内の開始インデックスを表すIntegerになります。 値 -1は、要素にフォーカスがない、あるいはなかったことを示します。
      関連項目:

    • ACCESSIBLE_TEXT_PROPERTY

      public static final String ACCESSIBLE_TEXT_PROPERTY
      テキストが変更されたことを示すPropertyChangeEvent。
      テキスト挿入の場合、oldValueはnullであり、newValueは挿入されたテキストを指定するAccessibleTextSequenceです。
      テキスト削除の場合、oldValueは削除されたテキストを指定するAccessibleTextSequenceであり、newValueはnullです。
      テキスト置換の場合、oldValueは古いテキストを指定するAccessibleTextSequenceであり、newValueは新しいテキストを指定するAccessibleTextSequenceです。
      関連項目:

    • ACCESSIBLE_INVALIDATE_CHILDREN

      public static final String ACCESSIBLE_INVALIDATE_CHILDREN
      PropertyChangeEventは、ツリーやテキストのようなコンポーネントの子に大きな変化が生じたことを示します。 この変更は、サブコンポーネントのステータスを再取得する必要があるイベント・リスナーに通知されます。 oldValueはnullであり、newValueは子供が無効になったコンポーネントです。
      導入されたバージョン:
      1.5
      関連項目:

    • ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED

      public static final String ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED
      テキスト属性が変更されたことを示すPropertyChangeEvent。
      属性挿入の場合、oldValueはnullであり、newValueは挿入された属性を指定するAccessibleAttributeSequenceです。
      属性の削除の場合、oldValueは削除された属性を指定するAccessibleAttributeSequenceであり、newValueはnullです。
      属性置換の場合、oldValueは古い属性を指定するAccessibleAttributeSequenceであり、newValueは新しい属性を指定するAccessibleAttributeSequenceです。
      導入されたバージョン:
      1.5
      関連項目:

    • ACCESSIBLE_COMPONENT_BOUNDS_CHANGED

      public static final String ACCESSIBLE_COMPONENT_BOUNDS_CHANGED
      PropertyChangeEvent:コンポーネントの境界内で変更が発生したことを示します。 oldValueは古いコンポーネント境界で、newValueは新しいコンポーネント境界です。
      導入されたバージョン:
      1.5
      関連項目:

    • accessibleParent

      protected Accessible accessibleParent
      このオブジェクトのAccessible親です。
      関連項目:

    • accessibleName

      protected String accessibleName
      オブジェクトの名前を格納するローカライズされたStringです。
      関連項目:

    • accessibleDescription

      protected String accessibleDescription
      オブジェクトの説明を格納するローカライズされたStringです。
      関連項目:

  • コンストラクタの詳細

    • AccessibleContext

      protected AccessibleContext()
      サブクラスが呼び出すためのコンストラクタ。

  • メソッドの詳細

    • getAccessibleName

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

    • setAccessibleName

      @BeanProperty(preferred=true, description="Sets the accessible name for the component.") public void setAccessibleName(String s)
      このオブジェクトのローカライズされたAccessible名を設定します。 名前を変更すると、ACCESSIBLE_NAME_PROPERTYプロパティに対してPropertyChangeEventが実行されます。
      パラメータ:
      s - オブジェクトのローカライズされた新しい名前
      関連項目:

    • getAccessibleDescription

      public String getAccessibleDescription()
      このオブジェクトのaccessibleDescriptionプロパティを取得します。 このオブジェクトのaccessibleDescriptionプロパティは、オブジェクトの目的を説明する短いローカライズされたフレーズです。 たとえば、「取消」ボタンの場合、accessibleDescriptionは「変更を無視してダイアログ・ボックスを閉じる」になります
      戻り値:
      オブジェクトのローカライズされた説明。オブジェクトが説明を持たない場合はnull
      関連項目:

    • setAccessibleDescription

      @BeanProperty(preferred=true, description="Sets the accessible description for the component.") public void setAccessibleDescription(String s)
      このオブジェクトのAccessible説明を設定します。 名前を変更すると、ACCESSIBLE_DESCRIPTION_PROPERTYプロパティに対してPropertyChangeEventが実行されます。
      パラメータ:
      s - オブジェクトの新しいローカライズされた説明
      関連項目:

    • getAccessibleRole

      public abstract AccessibleRole getAccessibleRole()
      このオブジェクトの役割を取得します。 オブジェクトの役割は、ジェネリックな目的、またはこのオブジェクトのクラスの使用です。 たとえば、プッシュ・ボタンのロールはAccessibleRole.PUSH_BUTTONです。 AccessibleRoleのロールは、コンポーネント開発者が事前定義されたロールのセットから選択できるように提供されています。 これにより、補助テクノロジでは、コンポーネント(たとえば、プッシュ・ボタンのように動作するすべてのコンポーネントにAccessibleRole.PUSH_BUTTONを使用)のさまざまな調整済みサブクラスに一貫したインタフェースを提供し、(チェックボックスの場合はAccessibleRole.CHECK_BOX、ラジオ・ボタンの場合はAccessibleRole.RADIO_BUTTON)とは異なる動作をするサブクラスを区別することができます。

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

      戻り値:
      オブジェクトの役割を記述したAccessibleRoleのインスタンス
      関連項目:

    • getAccessibleStateSet

      public abstract AccessibleStateSet getAccessibleStateSet()
      このオブジェクトの状態セットを取得します。 オブジェクトのAccessibleStateSetは一意のAccessibleStatesのセットで構成されています。 オブジェクトのAccessibleStateSetが変更されると、ACCESSIBLE_STATE_PROPERTYプロパティに対してPropertyChangeEventが発生します。
      戻り値:
      オブジェクトの現在の状態セットを含むAccessibleStateSetのインスタンス
      関連項目:

    • getAccessibleParent

      public Accessible getAccessibleParent()
      このオブジェクトのAccessible親を取得します。
      戻り値:
      このオブジェクトの親のAccessible。nullこのオブジェクトにAccessibleの親がない場合

    • setAccessibleParent

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

    • getAccessibleIndexInParent

      public abstract int getAccessibleIndexInParent()
      Accessible親での、このオブジェクトのゼロから始まるインデックスを取得します。
      戻り値:
      親での、このオブジェクトのゼロから始まるインデックス。このオブジェクトにAccessible親がない場合は -1。
      関連項目:

    • getAccessibleChildrenCount

      public abstract int getAccessibleChildrenCount()
      オブジェクトのAccessible子の数を返します。
      戻り値:
      オブジェクトのAccessible子の数。

    • getAccessibleChild

      public abstract Accessible getAccessibleChild(int i)
      オブジェクトの指定されたAccessible子を返します。 AccessibleオブジェクトのAccessible子はゼロ・ベースであるため、Accessible子の最初の子はインデックス0に、2番目の子はインデックス1に、以下同様に続きます。
      パラメータ:
      i - 子のゼロから始まるインデックス
      戻り値:
      オブジェクトのAccessible子
      関連項目:

    • getLocale

      public abstract Locale getLocale() throws IllegalComponentStateException
      コンポーネントのロケールを取得します。 コンポーネントがロケールを持たない場合は、その親のロケールが返されます。
      戻り値:
      このコンポーネントのロケール。 このコンポーネントがロケールを持たない場合は、その親のロケールが返される。
      スロー:
      IllegalComponentStateException - コンポーネントが独自のロケールを持たず、含まれている親からロケールを判別できるように、包含階層にまだ追加されていない場合

    • addPropertyChangeListener

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

    • removePropertyChangeListener

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

    • getAccessibleAction

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

    • getAccessibleComponent

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

    • getAccessibleSelection

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

    • getAccessibleText

      public AccessibleText getAccessibleText()
      ディスプレイ上にテキストを表示するこのオブジェクトに関連付けられたAccessibleTextを取得します。
      戻り値:
      オブジェクトによってサポートされている場合はAccessibleText。そうでなければnullを返す
      関連項目:

    • getAccessibleEditableText

      public AccessibleEditableText getAccessibleEditableText()
      ディスプレイ上に編集可能なテキストを表示するこのオブジェクトに関連付けられたAccessibleEditableTextを取得します。
      戻り値:
      オブジェクトによってサポートされている場合はAccessibleEditableText。そうでなければnullを返す
      導入されたバージョン:
      1.4
      関連項目:

    • getAccessibleValue

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

    • getAccessibleIcon

      public AccessibleIcon[] getAccessibleIcon()
      関連するアイコンが1つ以上あるオブジェクトに関連付けられたAccessibleIconsを取得します。
      戻り値:
      オブジェクトによってサポートされている場合はAccessibleIconの配列。それ以外の場合はnullを返します。
      導入されたバージョン:
      1.3
      関連項目:

    • getAccessibleRelationSet

      public AccessibleRelationSet getAccessibleRelationSet()
      オブジェクトに関連付けられたAccessibleRelationSetを取得します。
      戻り値:
      オブジェクトによってサポートされている場合はAccessibleRelationSet。それ以外の場合はnullを返します。
      導入されたバージョン:
      1.3
      関連項目:

    • getAccessibleTable

      public AccessibleTable getAccessibleTable()
      オブジェクトに関連付けられたAccessibleTableを取得します。
      戻り値:
      オブジェクトによってサポートされている場合はAccessibleTable。それ以外の場合はnullを返します。
      導入されたバージョン:
      1.3
      関連項目:

    • firePropertyChange

      public void firePropertyChange(String propertyName, Object oldValue, Object newValue)
      バウンド・プロパティの変更の報告をサポートします。 oldValueとnewValueが等しくなく、PropertyChangeEventリスナー・リストが空でない場合は、各リスナーに対してPropertyChangeイベントを発生させます。 一般に、これはAccessibleオブジェクト自体が使用するためのものであり、アプリケーション・プログラムから呼び出すべきではありません。
      パラメータ:
      propertyName - 変更されたプロパティのプログラム名
      oldValue - プロパティの古い値
      newValue - プロパティの新しい値
      関連項目: