AccImpl  - AS3 Flex

パッケージ	mx.accessibility
クラス	public class AccImpl
継承	AccImpl AccessibilityImplementation Object
サブクラス	AccordionHeaderAccImpl, ButtonAccImpl, ButtonBaseAccImpl, ComboBaseAccImpl, DateChooserAccImpl, DateFieldAccImpl, LabelAccImpl, ListBaseAccImpl, ListBaseAccImpl, MenuBarAccImpl, PanelAccImpl, PanelAccImpl, RichEditableTextAccImpl, SliderAccImpl, SliderBaseAccImpl, SpinnerAccImpl, TabBarAccImpl, TextBaseAccImpl, TreeAccImpl, VideoPlayerAccImpl

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

AccImpl は、MX および Spark コンポーネントに対して使用される Flex の基本アクセシビリティ実装クラスです。

Flash Player の AccessibilityImplementation クラスのサブクラスです。

MX または Spark コンポーネントが作成されると、そのコンポーネントの accessibilityImplementation プロパティがこのクラスのサブクラスのインスタンスに設定されます。その後、Flash Player でこのオブジェクトを使用することにより、スクリーンリーダーなどの MSAA クライアントでコンポーネントの表示と操作が可能になります。アクセシビリティ実装クラスおよび MSAA について詳しくは、flash.accessibility.AccessibilityImplementation クラスを参照してください。

子

Flash Player は、アクセス可能なオブジェクトの厳密な階層をサポートしていません。DisplayObject に accessibilityImplementation オブジェクトがある場合、その子の accessibilityImplementation オブジェクトは無視されます。ただし、Player では、コンポーネントのアクセシビリティ実装クラスで、その内部パーツの MSAA 情報を公開できます。例えば、List はその内部アイテムに関する MSAA 情報を公開します。

子（内部パーツ）の数と、識別に使用される子 ID は、getChildIDArray() メソッドにより判定されます。Player の AccessibilityImplementation 基本クラスでは、このメソッドを使用すると、単に null が返されます。Flex の AccImpl クラスは、このメソッドをオーバーライドして空の配列を返します。また、createChildIDArray() という保護されたユーティリティメソッドもあり、内部パーツを持つサブクラスのオーバーライドで使用できます。

役割

コンポーネントとその内部パーツの MSAA Role は、get_accRole() メソッドにより判定されます。Player の AccessibilityImplementation 基本クラスでは、サブクラスによりオーバーライドされることが予期されるため、このメソッドを使用するとランタイムエラーがスローされます。Flex の AccImpl クラスには role という名前の保護されたプロパティがあります。通常、サブクラスは、このプロパティをそれぞれのコンストラクターで設定し、get_accRole() をオーバーライドして、このプロパティを返します。

名前

コンポーネントとその内部パーツの MSAA Name は、get_accName() メソッドにより判定されます。Player の AccessibilityImplementation 基本クラスでは、このメソッドを使用すると、単に null が返されます。Flex の AccImpl クラスは、このメソッドをオーバーライドし、次のように、空の文字列から始まり、追加される各部分を単一のスペースで区切った名前を作成します。

• 単純な子（コンボボックスやリストボックスのアイテムなど）が要求されている場合は、子のデフォルト名のみが返されます。以下に示す残りの手順は、コンポーネント本体（childID 0）のみに適用されます。
• コンポーネントが Form の内部にある場合
  • Form に FormHeading があり、コンポーネントが FormItem の内部にある場合は、見出しテキストが追加されます。 これを回避するには、FormHeading の accessibilityName をスペース（" "）に設定する必要があります。
  • フィールドが必須の場合は、ロケールに応じて「必須フィールド」を意味する文字列が追加されます。
  • コンポーネントが FormItem の内部にある場合は、FormItem のラベルテキストが追加されます。これを回避するには、FormItem の accessibilityName をスペース（" "）に設定する必要があります。
• コンポーネントの名前は次のように決定されます。
  • コンポーネントの accessibilityName（つまり、accessibilityProperties.name）がスペースの場合、コンポーネント名は追加されません。
  • コンポーネント名が指定されている場合（つまり、null でも空でもない場合）は、指定されたコンポーネント名が追加されます。
  • それ以外の場合は、AccImpl で定義され各サブクラスで実装される、保護されたメソッド getName() が呼び出されて、デフォルト名が設定されます。例えば、ButtonAccImpl では、Button のデフォルト名がボタンに表示されるラベルであることを指定ために、getName() が実装されます。空でない場合、getName() の戻り値が追加されます。
  • getName() で空の値が返された場合、コンポーネントの toolTip プロパティが設定されているときは、その String が追加されます。
  • コンポーネントの errorString プロパティが設定されている場合は、その String が追加されます。

説明

MSAA Description は、コンポーネントの accessibilityImplementation オブジェクトではなく、accessibilityProperties オブジェクトのみに基づいて決定されます。したがって、AccessibilityImplementation、AccImpl、および説明に関連する AccImpl のサブクラスにはロジックがありません。通常、Flex で説明を設定するには、UIComponent の accessibilityDescription プロパティを使用して、単純に accessibilityProperties.description を設定します。

状態

コンポーネントとその内部パーツの MSAA State は、get_accState() メソッドにより判定されます。Player の AccessibilityImplementation 基本クラスでは、サブクラスによりオーバーライドされることが予期されるため、このメソッドを使用するとランタイムエラーがスローされます。Flex の AccImpl クラスはこのメソッドをオーバーライドしませんが、サブクラスでオーバーライドできるように、getState() という保護されたユーティリティメソッドが用意されています。getState() メソッドを使用すると、次の値の組み合わせによって状態が示されます。

• STATE_SYSTEM_UNAVAILABLE（このコンポーネントまたはいずれかの上位要素で enabled が false になっている場合）
• STATE_SYSTEM_FOCUSABLE
• STATE_SYSTEM_FOCUSED（コンポーネント自身にフォーカスが設定されており、コンポーネントにある可能性があるどのサブパートに対しても設定されていない場合）

デフォルトではすべてのコンポーネントがフォーカス可能であると見なされるので、フォーカス可能でないコンポーネント（Label など）のアクセシビリティ実装クラスではこの状態フラグをクリアする必要があります。コンポーネントの状態が UNAVAILABLE になっている場合は、アクセシビリティ実装クラスにより FOCUSABLE 状態が削除されます。

値

コンポーネントとその内部パーツの MSAA Value は、get_accValue() メソッドにより判定されます。Player の AccessibilityImplementation 基本クラスでは、このメソッドを使用すると、単に null が返されます。Flex の AccImpl クラスはこのメソッドをオーバーライドしませんが、TextInput などのコンポーネントのサブクラスはこのメソッドをオーバーライドします。

場所

コンポーネント本体ではなく、コンポーネントの内部パーツの MSAA Location は、get_accLocation() メソッドにより判定されます。このメソッドが childID 0 に対して呼び出されることはありません。Flash Player では、getBounds() から返された境界矩形に基づいてコンポーネントの MSAA Location を判定します。Flex の AccImpl クラスはこのメソッドをオーバーライドしませんが、内部パーツを持つコンポーネントのサブクラスはこのメソッドをオーバーライドします。

デフォルトアクション

コンポーネントとその内部パーツの MSAA DefaultAction は、get_accDefaultAction() により判定されます。Player の AccessibilityImplementation 基本クラスでは、このメソッドを使用すると、単に null が返されます。Flex の AccImpl クラスはこのメソッドをオーバーライドしませんが、デフォルトアクションを持つサブクラスはこのメソッドをオーバーライドします。これらのサブクラスは、AccessibilityImplementation の accDoDefaultAction() メソッドもオーバーライドして、それぞれのデフォルトアクションを実行します。

その他

オブジェクトの表示 / 非表示が切り替えられると、EVENT_OBJECT_SHOW および EVENT_OBJECT_HIDE と呼ばれる MSAA イベントが送信されます。Flash Player では、これらに対応する状態がサポートされ、非表示になっている MSAA コンポーネントはレンダリングされません。コンポーネントが表示されている場合は、AccImpl に関連して説明されている状態が使用されます。

---