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

    • 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
      オブジェクトの方向が垂直方向であることを示します。 通常は、スクロール・バー、スライダ、進捗バーなどのオブジェクトに関連付けられます。
      関連項目:
      VERTICAL, AccessibleRole.SCROLL_BAR, AccessibleRole.SLIDER, AccessibleRole.PROGRESS_BAR

    • HORIZONTAL

      public static final AccessibleState HORIZONTAL
      オブジェクトの方向が水平方向であることを示します。 通常は、スクロール・バー、スライダ、進捗バーなどのオブジェクトに関連付けられます。
      関連項目:
      HORIZONTAL, 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)