モジュール java.desktop
パッケージ 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
      オブジェクトが可視であることを示します。

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

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

    • フィールドの詳細

      • 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

      • 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

      • MODAL

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

      • SHOWING

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

      • VISIBLE

        public static final AccessibleState VISIBLE
        オブジェクトが可視であることを示します。 注: オブジェクトを可視にしようとしても、オブジェクトのコンテナが可視でない場合は、オブジェクトも画面に表示されないことがあります。
        関連項目:
        SHOWING

      • 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)