mx.accessibility.AccordionHeaderAccImpl

Package	mx.accessibility
Class	public class AccordionHeaderAccImpl
Inheritance	AccordionHeaderAccImpl AccImpl AccessibilityImplementation

Review Needed

The AccordionHeaderAccImpl class, also called the AccordionHeader Accessibility Implementation class, enables communication between a AccordionHeader component and a screen reader. Screen readers are used to translate screen content into synthesized speech or braille for visually impaired users.

The AccordionHeaderAccImpl class supports system roles, object-based events, and states.

An AccordionHeader reports the role ROLE_SYSTEM_PAGETAB (0x25) to a screen reader.

An AccordionHeader reports the following states to a screen reader:

STATE_SYSTEM_NORMAL (0x00000000)
STATE_SYSTEM_UNAVAILABLE (0x00000001)
STATE_SYSTEM_FOCUSED (0x00000004)
STATE_SYSTEM_FOCUSABLE (0x00100000)
STATE_SYSTEM_SELECTED (0x00000002)
STATE_SYSTEM_SELECTABLE (0x00200000)

An AccordionHeader dispatches the following events to a screen reader:

EVENT_OBJECT_STATECHANGE (0x800A)
EVENT_OBJECT_NAMECHANGE (0x800C)
EVENT_OBJECT_FOCUS (0x8005)
EVENT_OBJECT_SELECTION (0x8006)

The user of a screen reader can activate an AccordionHeader component by using the spacebar or the Enter key.

	Property	Defined by
		errno : uint Errors are indicated out-of-band, rather than in return values.	AccessibilityImplementation
		stub : Boolean If a component is released without an ActionScript accessibility implementation, it is strongly suggested that a component accessibility stub be included.	AccessibilityImplementation

	Property	Defined by
		eventsToHandle : Array [read-only] All AccImpl subclasses must override this function by returning an array of strings of the events for which the class should listen from its master component.	AccordionHeaderAccImpl
		master : UIComponent A reference to the UIComponent instance that this AccImpl instance is making accessible.	AccImpl
		role : uint Accessibility Role of the component being made accessible.	AccImpl

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined by
		AccordionHeaderAccImpl(master:UIComponent) Creates a new AccordionHeaderAccImpl instance for the specified AccordionHeader component.	AccordionHeaderAccImpl
		accDoDefaultAction(childID:uint):void IAccessible method that performs the default action associated with the component that this AccessibilityImplementation represents or of one of its child elements.	AccessibilityImplementation
		accLocation(childID:uint):* IAccessible method for returning a `DisplayObject` or `Rectangle` specifying the bounding box of a child element in the AccessibilityImplementation.	AccessibilityImplementation
		accSelect(selFlag:uint, childID:uint):void IAccessible method for altering the selection in the component that this AccessibilityImplementation represents.	AccessibilityImplementation
		enableAccessibility():void [static] Method call for enabling accessibility for a component.	AccordionHeaderAccImpl
		get_accDefaultAction(childID:uint):String IAccessible method for returning the Default Action, which for the AccordionHeader is Switch.	AccordionHeaderAccImpl
		get_accFocus():uint IAccessible method for returning the unsigned integer ID of the child element, if any, that has child focus within the component.	AccessibilityImplementation
		get_accName(childID:uint):String IAccessible method for returning the name for the component that this AccessibilityImplementation represents or for one of its child elements.	AccImpl
		get_accRole(childID:uint):uint IAccessible method for returning the system role for the component that this AccessibilityImplementation represents or for one of its child elements.	AccImpl
		get_accSelection():Array IAccessible method for returning an array containing the IDs of all child elements that are selected.	AccessibilityImplementation
		get_accState(childID:uint):uint IAccessible method for returning the state of Tab selected.	AccordionHeaderAccImpl
		get_accValue(childID:uint):String IAccessible method for returning the runtime value of the component that this AccessibilityImplementation represents or of one of its child elements.	AccessibilityImplementation
		getChildIDArray():Array Returns an array containing the unsigned integer IDs of all child elements in the AccessibilityImplementation.	AccessibilityImplementation

	Method	Defined by
		eventHandler(event:Event):void Override the generic event handler.	AccordionHeaderAccImpl
		getName(childID:uint):String Method for returning the name of the Tab which is spoken out by the screen reader.	AccordionHeaderAccImpl
		getState(childID:uint):uint Returns the state of the accessible component.	AccImpl

Property detail

eventsToHandle

property

eventsToHandle:Array [read-only]

All AccImpl subclasses must override this function by returning an array of strings of the events for which the class should listen from its master component.

Implementation
protected function get eventsToHandle():Array

Constructor detail

AccordionHeaderAccImpl

()

constructor

public function AccordionHeaderAccImpl(master:UIComponent)

Creates a new AccordionHeaderAccImpl instance for the specified AccordionHeader component.

Direct calls to the AccImpl subclass constructors are unneccessary. When a Flex project is compiled with Generate accessible SWF file set to true, the compiler instantiates the accessibility implementations for the components used in the project that have them by calling the the static enableAccessibility() method.

Parameters

master:UIComponent — The UIComponent instance that this AccordionHeaderAccImpl instance is making accessible.

Method detail

enableAccessibility

()

method

public static function enableAccessibility():void

Method call for enabling accessibility for a component. This method is required for the compiler to activate the accessibility classes for a component.

When a Flex project is compiled with the Generate accessible SWF file set to true, the Flex compiler automatically enables accessibility implementations for the components used in the project that have them.

Accessible component classes should include the [AccessibilityClass] meta tag to specify the appropriate AccImpl subclass or accessibility implementation and let the compiler know to call enableAccessibility().

Example
Following is an example showing how the [AccessibilityClass] meta tag specifies the appropriate AccImpl subclass or accessibility implementation for the mx.containers.accordionClasses.AccordionHeader component.

[AccessibilityClass(implementation="mx.accessibility.AccordionHeaderAccImpl")]

eventHandler

()

method

protected override function eventHandler(event:Event):void

Override the generic event handler. Each AccImpl subclass must implement this method to listen for events from its master component.

Parameters

event:Event — The event object.

get_accDefaultAction

()

method

public override function get_accDefaultAction(childID:uint):String

IAccessible method for returning the Default Action, which for the AccordionHeader is Switch.

Parameters

childID:uint — An unsigned integer corresponding to one of the component's child elements as defined by getChildIDArray().

Returns

String — Name of default action.

get_accState

()

method

public override function get_accState(childID:uint):uint

IAccessible method for returning the state of Tab selected. States are predefined for all the components in MSAA. Values are assigned to each state. Depending upon the Tab being Selectable, Focusable, Focused, or Selected, a value is returned.

Parameters

childID:uint — An unsigned integer corresponding to one of the component's child elements as defined by getChildIDArray().

Returns

uint — State depending upon the Tab being Selectable, Focusable, Focused, or Selected

getName

()

method

protected override function getName(childID:uint):String

Method for returning the name of the Tab which is spoken out by the screen reader.

Each Tab of the Accordion component should return the name specified by its label property. If the tab is selected, word "Active" is added.

Parameters

childID:uint — An unsigned integer corresponding to one of the component's child elements as defined by getChildIDArray().

Returns

String — Name of the tab. If the tab is selected, the word "Active" is added.

Adobe® Flex™ 3 Language Reference	All Packages \| All Classes \| Index \| Frames No Frames
Class AccordionHeaderAccImpl	Properties \| Methods