// Copyright 2007. Adobe Systems Incorporated. All Rights Reserved.
  package fl.accessibility {
          
          import flash.accessibility.Accessibility;
          import flash.events.Event;
          import fl.controls.listClasses.ICellRenderer;
          import fl.controls.TileList;
          import fl.core.UIComponent;
  
          

The @ax-student-ar-fl-accessibility-TileListAccImpl class, also called the Tile List Accessibility Implementation class, is used to make a TileList component accessible. This class enables communication between a TileList component and a screen reader. Screen readers are used to translate screen content into synthesized speech or braille for visually impaired users. <p>The @ax-student-ar-fl-accessibility-TileListAccImpl class supports system roles, object-based events, and states.</p> <p>A TileList reports the role <code>ROLE_SYSTEM_LIST</code> (0x21) to a screen reader. Items of a TileList report the role <code>ROLE_SYSTEM_LISTITEM</code> (0x22).</p> <p>A TileList reports the following states to a screen reader:</p> <ul> <li><code>STATE_SYSTEM_NORMAL</code> (0x00000000)</li> <li><code>STATE_SYSTEM_UNAVAILABLE</code> (0x00000001)</li> <li><code>STATE_SYSTEM_FOCUSED</code> (0x00000004)</li> <li><code>STATE_SYSTEM_FOCUSABLE</code> (0x00100000)</li> </ul> <p>Additionally, items of a TileList report the following states:</p> <ul> <li><code>STATE_SYSTEM_SELECTED</code> (0x00000002)</li> <li><code>STATE_SYSTEM_FOCUSED</code> (0x00000004)</li> <li><code>STATE_SYSTEM_INVISIBLE</code> (0x00008000)</li> <li><code>STATE_SYSTEM_OFFSCREEN</code> (0x00010000)</li> <li><code>STATE_SYSTEM_SELECTABLE</code> (0x00200000)</li> </ul> <p>A TileList dispatches the following events to a screen reader:</p> <ul> <li><code>EVENT_OBJECT_FOCUS</code> (0x8005)</li> <li><code>EVENT_OBJECT_SELECTION</code> (0x8006)</li> <li><code>EVENT_OBJECT_STATECHANGE</code> (0x800A)</li> <li><code>EVENT_OBJECT_NAMECHANGE</code> (0x800C)</li> </ul>
see: fl.controls.TileList TileList @langversion 3.0 @playerversion Flash 9.0.28.0

  
          public class @ax-student-ar-fl-accessibility-TileListAccImpl extends SelectableListAccImpl {
                  

@private Static variable triggering the <code>hookAccessibility()</code> method. This is used for initializing @ax-student-ar-fl-accessibility-TileListAccImpl class to hook its <code>createAccessibilityImplementation()</code> method to the TileList class before it gets called from UIComponent. @langversion 3.0 @playerversion Flash 9.0.28.0

  
                  private static var accessibilityHooked:Boolean = hookAccessibility();
  
                  

@private Static method for swapping the <code>createAccessibilityImplementation()</code> method of the TileList class with the @ax-student-ar-fl-accessibility-TileListAccImpl class. @langversion 3.0 @playerversion Flash 9.0.28.0

   
                  private static function hookAccessibility():Boolean {
                          TileList.createAccessibilityImplementation = createAccessibilityImplementation;
                          return true;
                  }
  
                  //--------------------------------------------------------------------------
                  //  Class methods
                  //--------------------------------------------------------------------------
  
                  

@private Method for creating the Accessibility class. This method is called from UIComponent.
parameter: component The UIComponent instance that this AccImpl instance is making accessible. @langversion 3.0 @playerversion Flash 9.0.28.0

  
                  public static function createAccessibilityImplementation(component:UIComponent):void {
                          component.accessibilityImplementation = new @ax-student-ar-fl-accessibility-TileListAccImpl(component);
                  }
  
                  

Enables accessibility for a TileList component. This method is required for the compiler to activate the accessibility classes for a component. @langversion 3.0 @playerversion Flash 9.0.28.0

  
                  public static function enableAccessibility():void {
                  }
  
                  //--------------------------------------------------------------------------
                  //  Constructor
                  //--------------------------------------------------------------------------
  
                  

@private Creates a new TileList Accessibility Implementation.
parameter: master The UIComponent instance that this AccImpl instance makes accessible. @langversion 3.0 @playerversion Flash 9.0.28.0

  
                  public function @ax-student-ar-fl-accessibility-TileListAccImpl(master:UIComponent) {
                          super(master);
                  }
  
                  
                  //--------------------------------------------------------------------------
                  //  Overridden methods: AccessibilityImplementation
                  //--------------------------------------------------------------------------
  
                  

@private IAccessible method for returning the value of the ListItem/TileList which is spoken out by the screen reader The TileList should return the name of the currently selected item with m of n string as value when focus moves to TileList.
parameter: childID The child id
returns: String Value @langversion 3.0 @playerversion Flash 9.0.28.0

  
                  override public function get_accValue(childID:uint):String {
                          var accValue:String;
                          var list:TileList = TileList(master);
                          var index:int = list.selectedIndex;
                          if (childID == 0) {
                                  if (index > -1) {
                                          var ext:String = " " + (index + 1) + " of " + list.dataProvider.length;
                                          var item:Object = list.getItemAt(index);
                                          if (item is String) {
                                                  accValue = item + ext;
                                          } else {
                                                  accValue = list.itemToLabel(item) + ext;
                                          }
                                  }
                          }
                          return accValue;
                  }
  
                  //--------------------------------------------------------------------------
                  //  Overridden methods: AccImpl
                  //--------------------------------------------------------------------------
  
                  

@private This method retrieves the name of the ListItem/TileList component that is spoken out by the screen reader. The ListItem should return the label as the name with m of n string and TileList should return the name that is specified in the Accessibility Panel.
parameter: childID The child id
returns: String Name @langversion 3.0 @playerversion Flash 9.0.28.0

  
                  override protected function getName(childID:uint):String {
                          if (childID == 0) {
                                  return "";
                          }
                          var list:TileList = TileList(master);
                          // Assuming childID is always ItemID + 1
                          // because getChildIDArray is not always invoked.
                          if(list.dataProvider) {
                                  var item:Object = list.getItemAt(childID - 1);
                                  var ext:String = " " + childID + " of " + list.dataProvider.length;
                                  if (item is String) {
                                          return item + ext;
                                  } else {
                                          return list.itemToLabel(item) + ext;
                                  }
                          }
                          return "";
                  }
  
          }
  }
  

---

[] readme course(s) preface I 1 2 II 3 4 III 5 6 7 IV 8 9 10 V 11 12 afterthought(s) appendix reference(s) example(s) resource(s) _

---

(C) Æliens 27/08/2009

You may not copy or print any of this material without explicit permission of the author or the publisher. In case of other copyright issues, contact the author.