パッケージ | spark.accessibility |
クラス | public class DropDownListBaseAccImpl |
継承 | DropDownListBaseAccImpl ListBaseAccImpl AccImpl AccessibilityImplementation Object |
サブクラス | ComboBoxAccImpl |
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 4 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
ComboBox には独自のアクセシビリティ実装サブクラスがありますが、DropDownList では DropDownListBase 用のアクセシビリティ実装サブクラスが使用されます。したがって、以降の説明は、DropDownListBase 基本クラスではなく、一般的に使用される DropDownList コンポーネントについての記述です。
Spark の DropDownList が作成されると、そのオブジェクトの accessibilityImplementation
プロパティがこのクラスのインスタンスに設定されます。その後、Flash Player でこのクラスを使用することにより、スクリーンリーダーなどの MSAA クライアントで DropDownList の表示と操作が可能になります。アクセシビリティ実装クラスと MSAA の背景情報については、mx.accessibility.AccImpl および flash.accessibility.AccessibilityImplementation クラスを参照してください。
子
MSAA における DropDownList の子は、個々のリストアイテムです。子の数は、表示されるレンダラーの数だけではなく、dataProvider
内にあるすべてのアイテムの数です。
後述するように、リストアイテムのアクセシビリティは DropDownList によって管理されます。アイテムレンダラーの accessibilityImplementation
および accessibilityProperties
は、Flash Player では無視されます。
役割
DropDownList の MSAA Role は ROLE_SYSTEM_COMBOBOX です。
各リストアイテムの Role は ROLE_SYSTEM_LISTITEM です。
名前
デフォルトでは、DropDownList の MSAA Name は空の文字列です。FormItem エレメント内にラップされた場合、この Name は FormItem のラベルに設定されます。この動作をオーバーライドするには、DropDownList の accessibilityName
プロパティを設定します。
各リストアイテムの Name は、DropDownList の itemToLabel()
メソッドにより決定されます。
DropDownList またはいずれかのリストアイテムの Name が変更されると、該当する childID(リストアイテムの場合)または 0(DropDownList 本体の場合)を含む MSAA イベント EVENT_OBJECT_NAMECHANGE が DropDownList から送出されます。
説明
デフォルトでは、DropDownList の MSAA Description は空の文字列ですが、DropDownList の accessibilityDescription
プロパティを設定することで説明を指定できます。
各リストアイテムの Description は空の文字列です。
状態
DropDownList の MSAA State は、次の値の組み合わせになります。
- STATE_SYSTEM_UNAVAILABLE(enabled が false である場合)
- STATE_SYSTEM_FOCUSABLE(enabled が true である場合)
- STATE_SYSTEM_FOCUSED(enabled が true であり、DropDownList にフォーカスがある場合)
- STATE_SYSTEM_EXPANDED(開かれている場合)
- STATE_SYSTEM_COLLAPSED(閉じられている場合)
リストアイテムの State は次の値の組み合わせになります。
- STATE_SYSTEM_FOCUSABLE
- STATE_SYSTEM_FOCUSED(フォーカスがある場合)
- STATE_SYSTEM_SELECTABLE
- STATE_SYSTEM_SELECTED(選択されている場合)
DropDownList またはいずれかのリストアイテムの State が変化すると、該当する childID(リストアイテムの場合)または 0(DropDownList 本体の場合)を含む MSAA イベント EVENT_OBJECT_STATECHANGE が DropDownList から送出されます。
値
DropDownList の MSAA Value は、現在選択されているリストアイテムの MSAA Name です。
各リストアイテムの Value は空の文字列です。
DropDownList の Value が変更されると、MSAA イベント EVENT_OBJECT_VALUECHANGE が DropDownList から送出されます。
場所
DropDownList および各リストアイテムの MSAA Location は、それぞれの境界矩形です。
デフォルトアクション
DropDownList には MSAA DefaultAction がありません。
リストアイテムの DefaultAction は "Double click" です。
フォーカス
リストアイテムだけではなく、DropDownList 本体も(折りたたまれているか展開されているかにかかわらず)フォーカスを取得できます。この場合は EVENT_OBJECT_FOCUS が発行されます。
選択
DropDownList では、1 つのアイテムのみを選択できます。この場合は EVENT_OBJECT_SELECTION イベントが発行されます。
メソッド | 定義元 | ||
---|---|---|---|
DropDownListBaseAccImpl(master:UIComponent)
コンストラクターです。 | DropDownListBaseAccImpl | ||
この AccessibilityImplementation が表すコンポーネントまたはその子要素のいずれかに関連付けられているデフォルトアクションを実行する IAccessible メソッドです。 | AccessibilityImplementation | ||
AccessibilityImplementation の子要素の境界ボックスを指定する DisplayObject または Rectangle を返すための MSAA メソッドです。 | AccessibilityImplementation | ||
この AccessibilityImplementation が表すコンポーネント内の選択を変更するための IAccessible メソッドです。 | AccessibilityImplementation | ||
[静的]
DropDownListBase クラスでアクセシビリティを有効にします。 | DropDownListBaseAccImpl | ||
この AccessibilityImplementation が表すコンポーネントまたはその子要素のいずれかのデフォルトアクションを返すための MSAA メソッドです。 | AccessibilityImplementation | ||
コンポーネント内に子フォーカスを持つ子要素がある場合に、その符号なし整数 ID を返す MSAA メソッドです。 | AccessibilityImplementation | ||
この AccessibilityImplementation が表すコンポーネントまたはその子要素のいずれかの名前を返すための MSAA メソッドです。 | AccessibilityImplementation | ||
この AccessibilityImplementation が表すコンポーネントまたはその子要素のいずれかのシステムロールを返すための MSAA メソッドです。 | AccessibilityImplementation | ||
選択されているすべての子要素の ID を含む配列を返すための MSAA メソッドです。 | AccessibilityImplementation | ||
この AccessibilityImplementation が表すコンポーネントまたはその子要素のいずれかの現在のランタイム状態を返すための IAccessible メソッドです。 | AccessibilityImplementation | ||
この AccessibilityImplementation が表すコンポーネントまたはその子要素のいずれかのランタイム値を返すための MSAA メソッドです。 | AccessibilityImplementation | ||
AccessibilityImplementation | |||
AccessibilityImplementation | |||
AccessibilityImplementation のすべての子要素の符号なし整数 ID を含む配列を返します。 | AccessibilityImplementation | ||
[静的]
フォームアクセシビリティをサポートするためのメソッドです。 | AccImpl | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
[静的]
コンポーネントの上位要素で enabled が false に設定されている場合は true を返します。 | AccImpl | ||
true または false を返して、x、y、width および height で指定されたバウンディングボックスを持つテキストオブジェクトを、この AccessibilityImplementation が表すコンポーネントのラベルと見なすかどうかを示します。 | AccessibilityImplementation | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object |
DropDownListBaseAccImpl | () | コンストラクター |
public function DropDownListBaseAccImpl(master:UIComponent)
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 4 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
コンストラクターです。
パラメーターmaster:UIComponent — この AccImpl インスタンスによってアクセス可能になる UIComponent インスタンスです。
|
enableAccessibility | () | メソッド |
public static function enableAccessibility():void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 4 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
DropDownListBase クラスでアクセシビリティを有効にします。
このメソッドは、MXML コンパイラーによって自動生成されるアプリケーション起動コードから呼び出されます。その後、DropDownListBase のインスタンスが初期化されると、accessibilityImplementation
プロパティがこのクラスのインスタンスに設定されます。
Tue Jun 12 2018, 10:34 AM Z