Flex SDK Wiki

class spark.accessibility.VideoPlayerAccImpl

This is the accessibility implementation class for spark.components.VideoPlayer. When a Spark VideoPlayer is created, its accessibilityImplementation property is set to an instance of this class. The Flash Player then uses this class to allow MSAA clients such as screen readers to see and manipulate the VideoPlayer. See the mx.accessibility.AccImpl and flash.accessibility.AccessibilityImplementation classes for background information about accessibility implementation classes and MSAA.

This method associates the VideoPlayer Accessibility Implementation on the VideoPlayer object. Each component of the VideoPlayer such as the PlayPause button is a simple child of the VideoPlayer.

Children

The VideoPlayer has 6 MSAA children:

1. Play/Pause control
2. Scrub control
3. Play time indicator
4. Mute control
5. Volume control
6. Full Screen control

The controls will always appear in the same order for accessibility regardless of the order of controls in the skin.

Role

The MSAA Role of a VideoPlayer is ROLE_SYSTEM_PANE.

The Role of each child control is:

1. Play/Pause control: ROLE_SYSTEM_BUTTON
2. Scrub control: ROLE_SYSTEM_SLIDER
3. Play time indicator: ROLE_SYSTEM_STATICTEXT
4. Mute control: ROLE_SYSTEM_BUTTON
5. Volume control: ROLE_SYSTEM_SLIDER
6. Full Screen control: ROLE_SYSTEM_BUTTON

Name

The MSAA Name of a VideoPlayer is, by default, "VideoPlayer". When wrapped in a FormItem element, the Name is the FormItem's label. To override this behavior, set the Spinner's accessibilityName property.

The Name of each child control is:

1. Play/Pause control: "Play" or "Pause"
2. Scrub control: "Scrub Bar"
3. Play time indicator: the displayed text
4. Mute control: "Muted" or "Not muted"
5. Volume control: "Volume Bar"
6. Full Screen control: "Full Screen"

To override the names of these child controls, reskin the VideoPlayer and set the accessibilityName of the controls.

Note that the Play/Pause control and the Mute control have MSAA Names which change as you interact with them. To specify them, set accessibilityName to a comma-separate list of MSAA Names, such as "Play,Pause" or "Not Muted,Muted".

When the Name of the VideoPlayer or one of its child controls changes, a VideoPlayer dispatches the MSAA event EVENT_OBJECT_NAMECHANGE with the proper childID for the control or 0 for itself.

Description

The MSAA Description of a VideoPlayer is, by default, the empty string, but you can set the VideoPlayer's accessibilityDescription property.

The Description of each child control is the empty string.

State

The MSAA State of a VideoPlayer is STATE_SYSTEM_NORMAL.

The State of each child control is:

1. Play/Pause control:

2. STATE_SYSTEM_UNAVAILABLE

3. STATE_SYSTEM_FOCUSABLE

4. STATE_SYSTEM_FOCUSED

5. Scrub control:

6. STATE_SYSTEM_UNAVAILABLE

7. STATE_SYSTEM_FOCUSABLE

8. STATE_SYSTEM_FOCUSED

9. Play time indicator:

10. STATE_SYSTEM_READONLY.

11. Mute control:

12. STATE_SYSTEM_UNAVAILABLE

13. STATE_SYSTEM_FOCUSABLE

14. STATE_SYSTEM_FOCUSED

15. Volume control:

16. STATE_SYSTEM_UNAVAILABLE

17. STATE_SYSTEM_FOCUSABLE

18. STATE_SYSTEM_FOCUSED

19. Full Screen control:

20. STATE_SYSTEM_UNAVAILABLE

21. STATE_SYSTEM_FOCUSABLE
22. STATE_SYSTEM_FOCUSED

When the State of the VideoPlayer or one of its child controls changes, a VideoPlayer dispatches the MSAA event EVENT_OBJECT_STATECHANGE with the proper childID for the control or 0 for itself.

Value

A VideoPlayer does not have an MSAA Value.

THe Value of each child control is:

1. Play/Pause control: no Value
2. Scrub control: Value of slider as an amount of time
3. Play time indicator: no Value
4. Mute control: no Value
5. Volume control: Value of slider
6. Full Screen control: no Value

When the Value of a child control changes, a Spinner dispatches the MSAA event EVENT_OBJECT_VALUECHANGE with the proper ChildId for the control.

Location

The MSAA Location of a VideoPlayer, or one of its child controls, is its bounding rectangle.

Default Action

A VideoPlayer does not have an MSAA DefaultAction.

The DefaultAction of each child control is:

1. Play/Pause control: "Press"
2. Scrub control: none
3. Play time indicator: none
4. Mute control: "Press"
5. Volume control: none
6. Full Screen control: "Press"

Performing the default action of one of the child controls will have the following effect:

1. Play/Pause control: toggle between Play and Pause
2. Scrub control: none
3. Play time indicator: none
4. Mute control: toggle between Mute and Not Muted
5. Volume control: none
6. Full Screen control: toogle Full Screen on and off

Focus

Returns 0 if the VideoPlayer is focused but no subitem is, and otherwise the ChildID of the focused subitem:
If the "Play Pause" sub component is foxued 1 is returned
If the "Scrub Bar" sub component is focused 2 is returned
If the "Volume" sub component is focused 5 is returned (Mute Button and VolumeBar are connected and the Mute button can not be foxued via the keyboard)
If the "Full Screen" sub component is focused 6 is returned

Selection

The Select method is not implemented for the VideoPlayer component itself
1st child: if called with 1 and TAKE_FOCUS call the setFocus method on "Play Pause".
2nd child: if called with 2 and TAKE_FOCUS call the setFocus method on "Scrub Bar".
3rd child: displayed text for the currentTimeDisplay object - not implemented.
4th child: if called with 4 and TAKE_FOCUS call the setFocus method on "Volume Bar" (Mute button and VolumeBar are connected).
5th child: if called with 5 and TAKE_FOCUS call the setFocus method on "Volume Bar".
6th child: if called with 6 and TAKE_FOCUS call the setFocus method on "Full Screen".