ComboBoxAccImpl

Package	spark.accessibility
Classe	public class ComboBoxAccImpl
Héritage	ComboBoxAccImpl DropDownListBaseAccImpl ListBaseAccImpl AccImpl AccessibilityImplementation Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

ComboBoxAccImpl est la classe d’implémentation d’accessibilité pour spark.components.ComboBox.

Lorsqu’un composant Spark ComboBox est créé, sa propriété accessibilityImplementation est définie sur une instance de cette classe. Flash Player utilise ensuite cette classe pour permettre aux clients MSAA, tels que les lecteurs d’écran, de voir et de manipuler le composant ComboBox. Pour plus d’informations sur les classes d’implémentation d’accessibilité et MSAA, voir les classes mx.accessibility.AccImpl et flash.accessibility.AccessibilityImplementation.

Enfants

Les enfants MSAA d’un ComboBox sont ses éléments modifiables TextInput (avec childID 1) et ses éléments de liste (avec childID 2, 3, ... n). Le nombre d’enfants est de un plus le nombre d’éléments dans dataProvider (et donc pas un plus le nombre de rendus visibles).

Comme indiqué ci-dessous, l’accessibilité de TextInput et des éléments de la liste est gérée par le composant ComboBox ; leurs propriétés accessibilityImplementation et accessibilityProperties sont ignorées par Flash Player.

Rôle

Le rôle MSAA d’un ComboBox est ROLE_SYSTEM_COMBOBOX.

Le rôle MSAA d’un TextInput modifiable est ROLE_SYSTEM_TEXT.

Le rôle de chaque élément de la liste est ROLE_SYSTEM_LISTITEM.

Nom

Par défaut, le nom MSAA d’un ComboBox (et de ses éléments TextInput modifiables) est une chaîne vide. Lorsque le nom est enveloppé dans un élément FormItem, il en devient le libellé. Pour remplacer ce comportement, définissez la propriété accessibilityName du composant ComboBox.

Le nom de chaque élément de la liste est déterminé par la méthode itemToLabel() du composant ComboBox.

Lorsque le nom du ComboBox ou de l’un de ses éléments change, ComboBox distribue l’événement MSAA EVENT_OBJECT_NAMECHANGE avec le childID correspondant à l’élément de la liste ou 0 pour lui-même.

Description

Par défaut, la description MSAA d’un ComboBox est une chaîne vide, mais vous pouvez définir la propriété accessibilityDescription du ComboBox.

La description de chaque élément de la liste est la chaîne vide.

Etat

L’état MSAA d’un ComboBox est une combinaison de :

STATE_SYSTEM_UNAVAILABLE (lorsqu’enabled est false)
STATE_SYSTEM_FOCUSABLE (lorsqu’enabled est true)
STATE_SYSTEM_FOCUSED (lorsqu’enabled est true et ComboBox a le focus)
STATE_SYSTEM_EXPANDED (lorsqu’il est ouvert)
STATE_SYSTEM_COLLAPSED (lorsqu’il est fermé)

L’état de l’élément modifiable TextInput est une combinaison de :

STATE_SYSTEM_UNAVAILABLE (lorsqu’enabled est false)
STATE_SYSTEM_FOCUSABLE (lorsqu’enabled est true)
STATE_SYSTEM_FOCUSED (lorsqu’enabled est true et ComboBox a le focus)

L’état d’un élément de liste est une combinaison de :

STATE_SYSTEM_FOCUSABLE
STATE_SYSTEM_FOCUSED (lorsqu’il a le focus)
STATE_SYSTEM_SELECTABLE
STATE_SYSTEM_SELECTED (lorsqu’il est sélectionné)

Lorsque l’état du ComboBox, de ses éléments TextInput ou de l’un de ses éléments de liste change, ComboBox distribue un événement MSAA EVENT_OBJECT_STATECHANGE avec le childID correspondant à l’élément TextInput ou à l’élément de liste, ou distribue 0 pour lui-même.

Valeur

La valeur MSAA d’un ComboBox est le nom MSAA de l’élément de liste sélectionné ou le texte saisi dans l’élément TextInput.

La valeur d’un élément de liste est toujours la chaîne vide.

Lorsque la valeur du ComboBox change, le ComboBox distribue l’événement MSAA EVENT_OBJECT_VALUECHANGE.

Emplacement

L’emplacement MSAA d’un ComboBox, de ses éléments TextInput ou de l’un de ses éléments de liste est son rectangle de délimitation.

Action par défaut

Ni le composant ComboBox ni ses éléments TextInput n’ont d’action par défaut DefaultAction MSAA.

L’action par défaut DefaultAction d’un élément de liste est « Double-cliquer ». Cette action sélectionne l’élément.

Focus

Le composant ComboBox lui-même peut recevoir le focus, ainsi que ses éléments de liste (que le composant ComboBox soit réduit ou développé).

Sélection

Le ComboBox permet la sélection d’un seul élément, ce qui provoque le déclenchement de l’événement EVENT_OBJECT_SELECTION.

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		errno : uint Indique un code d’erreur.	AccessibilityImplementation
		stub : Boolean S’utilise pour créer un stub d’accessibilité de composant.	AccessibilityImplementation

Propriétés protégées

Masquer les propriétés protégées héritées

Afficher les propriétés protégées héritées

	Propriété		Défini par
		eventsToHandle : Array [lecture seule] Toutes les sous-classes doivent remplacer cette fonction en renvoyant un tableau de chaînes des événements à écouter.	AccImpl
		master : UIComponent Référence à l’instance UIComponent dont AccImpl assure l’accessibilité.	AccImpl
		role : uint Rôle d’accessibilité du composant rendu accessible.	AccImpl

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		ComboBoxAccImpl(master:UIComponent) Constructeur.	ComboBoxAccImpl
		accDoDefaultAction(childID:uint):void Une méthode IAccessible qui exécute l’action par défaut associée au composant représenté par cette classe AccessibilityImplementation ou l’un de ses éléments enfant.	AccessibilityImplementation
		accLocation(childID:uint):* La méthode MSAA permettant de renvoyer un objet DisplayObject ou Rectangle spécifiant le cadre de sélection d’un élément enfant dans la classe AccessibilityImplementation.	AccessibilityImplementation
		accSelect(operation:uint, childID:uint):void La méthode IAccessible permettant de modifier la sélection dans le composant représenté par la classe AccessibilityImplementation.	AccessibilityImplementation
		enableAccessibility():void [statique] Active l’accessibilité dans la classe ComboBox.	ComboBoxAccImpl
		get_accDefaultAction(childID:uint):String La méthode MSAA permettant de renvoyer l’action par défaut du composant représenté par cette classe AccessibilityImplementation ou de l’un de ses éléments enfant.	AccessibilityImplementation
		get_accFocus():uint La méthode MSAA permettant de renvoyer, le cas échéant, l’ID d’entier non signé de l’élément enfant possédant le focus au sein du composant.	AccessibilityImplementation
		get_accName(childID:uint):String La méthode MSAA permettant de renvoyer le nom du composant représenté par cette classe AccessibilityImplementation ou de l’un de ses éléments enfant.	AccessibilityImplementation
		get_accRole(childID:uint):uint La méthode MSAA permettant de renvoyer le rôle système du composant représenté par cette classe AccessibilityImplementation ou de l’un de ses éléments enfant.	AccessibilityImplementation
		get_accSelection():Array La méthode MSAA permettant de renvoyer un tableau contenant les ID de tous les éléments enfant sélectionnés.	AccessibilityImplementation
		get_accState(childID:uint):uint La méthode IAccessible permettant de renvoyer l’état d’exécution actuel du composant représenté par cette classe AccessibilityImplementation ou de l’un de ses éléments enfant.	AccessibilityImplementation
		get_accValue(childID:uint):String La méthode MSAA permettant de renvoyer la valeur d’exécution du composant représenté par cette classe AccessibilityImplementation ou de l’un de ses éléments enfant.	AccessibilityImplementation
		get_selectionActiveIndex():*	AccessibilityImplementation
		get_selectionAnchorIndex():*	AccessibilityImplementation
		getChildIDArray():Array Renvoie un tableau contenant les ID d’entiers non signés de l’ensemble des éléments enfant de la classe AccessibilityImplementation.	AccessibilityImplementation
		getFormName(component:UIComponent):String [statique] Méthode prenant en charge l’accessibilité de Form.	AccImpl
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isAncestorDisabled(component:UIComponent):Boolean [statique] Renvoie true si la propriété enabled d’un ancêtre du composant est définie sur false.	AccImpl
		isLabeledBy(labelBounds:Rectangle):Boolean Renvoie true ou false pour indiquer si un objet de texte dont le cadre de sélection est spécifié par x, y, width et height doit être considéré comme une étiquette pour le composant que représente cette classe AccessibilityImplementation.	AccessibilityImplementation
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Méthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		eventHandler(event:Event):void Gestionnaire d’événement générique.	AccImpl
		getName(childID:uint):String Renvoie le nom du composant accessible.	AccImpl
		getState(childID:uint):uint Méthode d’utilitaire déterminant l’état du composant accessible.	AccImpl

Détails du constructeur

()

Constructeur

public function ComboBoxAccImpl(master:UIComponent)

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Constructeur.

Paramètres

master:UIComponent — Instance UIComponent dont cette instance AccImpl assure l’accessibilité.

Détails de la méthode

enableAccessibility

()

méthode

public static function enableAccessibility():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Active l’accessibilité dans la classe ComboBox.

Cette méthode est appelée par le code de démarrage de l’application qui est autogénéré par le compilateur MXML. Ensuite, lorsque des instances de la classe ComboBox sont initialisées, leur propriété accessibilityImplementation est définie sur une instance de cette classe.

Informations juridiques | Politique de confidentialité en ligne

ComboBoxAccImpl - AS3 Flex

Classes x

ComboBoxAccImpl

enableAccessibility