AccImpl  - AS3 Flex

Package	mx.accessibility
Classe	public class AccImpl
Héritage	AccImpl AccessibilityImplementation Object
Sous-classes	AccordionHeaderAccImpl, ButtonAccImpl, ButtonBaseAccImpl, ComboBaseAccImpl, DateChooserAccImpl, DateFieldAccImpl, LabelAccImpl, ListBaseAccImpl, ListBaseAccImpl, MenuBarAccImpl, PanelAccImpl, PanelAccImpl, RichEditableTextAccImpl, SliderAccImpl, SliderBaseAccImpl, SpinnerAccImpl, TabBarAccImpl, TextBaseAccImpl, TreeAccImpl, VideoPlayerAccImpl

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

AccImpl est la classe d’implémentation d’accessibilité de base pour les composants Spark et MX.

Il s’agit d’une sous-classe de la classe AccessibilityImplementation de Flash Player.

Lorsqu’un composant MX ou Spark est créé, sa propriété accessibilityImplementation est définie en tant qu’instance d’une sous-classe de cette classe. Flash Player utilise ensuite cet objet pour permettre aux clients MSAA, tels que les lecteurs d’écran, de voir et de manipuler le composant. Pour plus d’informations sur les classes d’implémentation d’accessibilité et MSAA, voir la classe flash.accessibility.AccessibilityImplementation.

Enfants

Flash Player ne prend pas en charge une vraie hiérarchie d’objets accessibles. Si un objet DisplayObject possède un objet accessibilityImplementation, alors les objets accessibilityImplementation de ses enfants sont ignorés. Cependant, le lecteur permet à la classe d’implémentation d’accessibilité d’un composant d’exposer des informations MSAA pour ses parties internes. (Par exemple, une liste expose des informations MSAA sur ses éléments.)

Le nombre d’enfants (parties internes) et d’ID d’enfant utilisés pour les identifier sont déterminés par la méthode getChildIDArray(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie simplement null. La classe AccImpl Flex la remplace pour renvoyer un tableau vide. Elle fournit également une méthode utilitaire protégée createChildIDArray() que les sous-classes avec parties internes peuvent utiliser dans leurs remplacements.

Rôle

Le rôle MSAA d’un composant et de ses parties internes est déterminé par la méthode get_accRole(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie une erreur d’exécution, étant donné qu’il est attendu des sous-classes qu’elles l’ignorent. La classe AccImpl de Flex possède une propriété protégée role que les sous-classes définissent généralement dans leur constructeur et il remplace get_accRole() pour renvoyer cette propriété.

Nom

Le nom MSAA d’un composant et de ses parties internes est déterminé par la méthode get_accName(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie simplement null. La classe AccImpl de Flex le remplace pour construire un nom comme suit, en commençant par une chaîne vide et séparant les parties ajoutées par un seul espace :

• Si un enfant simple (par exemple, un élément d’une liste déroulante) est demandé, seul le nom par défaut de l’enfant est renvoyé. Le reste des étapes ci-dessous s’applique uniquement au composant lui-même (childID 0).
• Si le composant est imbriqué dans un formulaire :
  • Si le formulaire possède un FormHeading et que le composant est à l’intérieur d’un composant FormItem, le texte d’en-tête est ajouté. Les développeurs qui souhaitent éviter cela doivent définir accessibilityName du FormHeading sur un espace (" ").
  • Si le champ est obligatoire, la chaîne dépendante des paramètres régionaux « champ obligatoire » est ajoutée.
  • Si le composant est imbriqué dans un FormItem, le texte du libellé du FormItem est ajouté. Les développeurs qui souhaitent éviter cela doivent définir le accessibilityName du FormItem sur un espace (" ").
• Le nom du composant est alors déterminé comme suit :
  • Si le accessibilityName du composant (c’est-à-dire accessibilityProperties.name) est un espace, aucun nom de composant n’est ajouté.
  • Dans le cas contraire, si le nom du composant est spécifié (c’est-à-dire qu’il n’est pas null et n’est pas vide), il est ajouté.
  • Dans le cas contraire, une méthode protégée getName(), définie par AccImpl et implémentée par chaque sous-classe, est appelée pour fournir un nom par défaut. (Par exemple, ButtonAccImpl implémente getName() pour spécifier que le nom par défaut d’un Button est le libellé qu’il affiche.) Si elle n’est pas vide, la valeur de retour de getName() est ajoutée.
  • Dans le cas contraire (getName() renvoie une valeur vide), si la propriété toolTip du composant est définie, cette chaîne est ajoutée.
  • Si la propriété errorString du composant est définie, cette chaîne est ajoutée.

Description

La description MSAA est déterminée uniquement par l’objet accessibilityProperties d’un composant et non par son objet accessibilityImplementation. Il n’y a donc pas de logique dans AccessibilityImplementation ou AccImpl ou dans les sous-classes de AccImpl relatives à la description. La procédure normale pour définir la description dans Flex est par le biais de la propriété accessibilityDescription sur UIComponent, qui définit simplement accessibilityProperties.description.

Etat

L’état MSAA d’un composant et de ses parties internes est déterminé par la méthode get_accState(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie une erreur d’exécution, étant donné qu’il est attendu des sous-classes qu’elles l’ignorent. La classe AccImpl de Flex ne l’écrase pas, mais fournit la méthode utilitaire protégée getState(), que les sous-classes peuvent utiliser dans leurs remplacements. La méthode getState() détermine l’état en tant que combinaison de :

• STATE_SYSTEM_UNAVAILABLE (lorsqu’enabled est false sur ce composant ou sur l’un de ses ancêtres)
• STATE_SYSTEM_FOCUSABLE
• STATE_SYSTEM_FOCUSED (lorsque le composant lui-même a le focus, non défini pour toutes les sous-parties éventuelles du composant)

Notez que, par défaut, tous les composants sont considérés à priori comme étant capables de recevoir le focus. Les classes d’implémentation d’accessibilité pour les composants n’étant pas en mesure de recevoir le focus (tels que Label) doivent donc effacer cet indicateur d’état. Lorsqu’un composant possède un état « non disponible », l’état « en mesure de recevoir le focus » est supprimé par la classe d’implémentation d’accessibilité.

Valeur

La valeur MSAA d’un composant et de ses parties internes est déterminé par la méthode get_accValue(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie simplement null. La classe AccImpl de Flex ne la remplace pas, contrairement aux sous-classes de composants tels que TextInput.

Emplacement

L’emplacement MSAA des parties internes d’un composant, et non le composant lui-même, est déterminé par la méthode get_accLocation(). Cette méthode n’est jamais appelée avec un childID de 0 ; au lieu de cela, Flash Player détermine l’emplacement MSAA d’un composant en fonction de son rectangle de délimitation tel que déterminé par getBounds(). La classe AccImpl de Flex ne remplace pas cette méthode, contrairement aux sous-classes de composants ayant des parties internes.

Action par défaut

L’action par défaut DefaultAction MSAA d’un composant et de ses parties internes est déterminée par la méthode get_accDefaultAction(). Dans la classe de base AccessibilityImplementation du lecteur, cette méthode renvoie simplement null. La classe AccImpl de Flex ne la remplace pas, contrairement aux sous-classes ayant des actions par défaut. Ces sous-classes remplacent également la méthode accDoDefaultAction() d’implémentation d’accessibilité pour exécuter l’action par défaut qu’ils annoncent.

Autre

Les événements MSAA EVENT_OBJECT_SHOW et EVENT_OBJECT_HIDE sont envoyés lorsque l’objet est affiché ou masqué. Leurs états correspondants sont couverts par Flash Player qui ne rend pas les composants MSAA qui sont masqués. Lorsque le composant est affiché, les états mentionnés pour AccImpl sont utilisés.

---