ComboBoxAccImpl

Paket	spark.accessibility
Klasse	public class ComboBoxAccImpl
Vererbung	ComboBoxAccImpl DropDownListBaseAccImpl ListBaseAccImpl AccImpl AccessibilityImplementation Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

ComboBoxAccImpl ist die Accessibility-Implementierungsklasse für spark.components.ComboBox.

Wenn eine Spark-ComboBox erstellt wird, wird ihre accessibilityImplementation-Eigenschaft auf eine Instanz dieser Klasse gesetzt. Der Flash Player lässt dann mithilfe dieser Klasse zu, dass MSAA-Clients, wie z. B. Bildschirmleseprogramme, die ComboBox erkennen und ändern.. Weitere Hintergrundinformationen über Accessibility-Implementierungsklassen und MSAA finden Sie unter den Klassen „mx.accessibility.AccImpl“ und „flash.accessibility.AccessibilityImplementation“.

Untergeordnete Elemente

Die untergeordneten MSAA-Elemente einer ComboBox sind der bearbeitbare TextInput (mit childID 1) und die Listenelemente (mit childIDs 2, 3, ... n). Die Anzahl der untergeordneten Elemente ist 1 plus die Anzahl der Elemente im dataProvider (nicht jedoch 1 plus die Anzahl der sichtbaren Renderer).

Wie unten beschrieben wird die Accessibility des TextInput und der Listenelemente von der ComboBox verwaltet; die accessibilityImplementation und accessibilityProperties werden von Flash Player ignoriert.

Rolle

Die MSAA-Rolle einer ComboBox ist ROLE_SYSTEM_COMBOBOX.

Die MSAA-Rolle des bearbeitbaren TextInput ist ROLE_SYSTEM_TEXT.

Die Rolle eines jeden Listenelements ist ROLE_SYSTEM_LISTITEM.

Name

Der MSAA-Name einer ComboBox (und ihres bearbeitbaren TextInput) ist standardmäßig ein leerer String. Wenn der Name in einem FormItem-Element eingeschlossen ist, entspricht er der Beschriftung des FormItem. Um dieses Verhalten zu überschreiben, legen Sie die accessibilityName-Eigenschaft der ComboBox fest.

Der Name der einzelnen Listenelemente wird durch die itemToLabel()-Methode der ComboBox bestimmt.

Wenn der Name der ComboBox oder eines ihrer Elemente geändert wird, löst die ComboBox das MSAA-Ereignis EVENT_OBJECT_NAMECHANGE aus mit der richtigen childID für ein Listenelement oder 0 für sie selbst.

Beschreibung

Die MSAA-Beschreibung einer ComboBox ist standardmäßig ein leerer String, Sie können jedoch die accessibilityDescription-Eigenschaft der ComboBox festlegen.

Die Beschreibung eines jeden Listenelements ist der leere String.

Status

Der MSAA-Status einer ComboBox ist eine Kombination aus:

STATE_SYSTEM_UNAVAILABLE (wenn „enabled“ den Wert „false“ hat)
STATE_SYSTEM_FOCUSABLE (wenn „enabled“ den Wert „true“ hat)
STATE_SYSTEM_FOCUSED (wenn „enabled“ den Wert „true“ und die ComboBox den Fokus hat)
STATE_SYSTEM_EXPANDED (wenn geöffnet)
STATE_SYSTEM_COLLAPSED (wenn geschlossen)

Der Status des bearbeitbaren TextInput ist eine Kombination aus:

STATE_SYSTEM_UNAVAILABLE (wenn „enabled“ den Wert „false“ hat)
STATE_SYSTEM_FOCUSABLE (wenn „enabled“ den Wert „true“ hat)
STATE_SYSTEM_FOCUSED (wenn „enabled“ den Wert „true“ und die ComboBox den Fokus hat)

Der Status eines Listenelements ist eine Kombination aus:

STATE_SYSTEM_FOCUSABLE
STATE_SYSTEM_FOCUSED (wenn im Fokus)
STATE_SYSTEM_SELECTABLE
STATE_SYSTEM_SELECTED (wenn ausgewählt)

Wenn der Status der ComboBox, ihres TextInput oder eines ihrer Listenelemente geändert wird, löst die ComboBox das MSAA-Ereignis EVENT_OBJECT_STATECHANGE aus mit der richtigen childID für den TextInput, das Listenelement oder 0 für sie selbst.

Wert

Der MSAA-Wert einer ComboBox ist der MSAA-Name des aktuell ausgewählten Listenelements oder der im TextInput eingegebene Text.

Der Wert eines Listenelements ist immer der leere String.

Wenn der Wert der ComboBox geändert wird, löst sie das MSAA-Ereignis EVENT_OBJECT_VALUECHANGE aus.

Speicherort

Die MSAA-Position einer ComboBox, ihres TextInput oder eines ihrer Listenelemente ist ihr Begrenzungsrechteck.

Standardaktion

Weder die ComboBox noch ihr TextInput haben eine MSAA-DefaultAction.

Die DefaultAction eines Listenelements lautet „Double click“. Durch Ausführung dieser Aktion wird das Element ausgewählt.

Fokus

Die ComboBox selbst und ihre Listenelemente können den Fokus erhalten (während die ComboBox reduziert oder erweitert ist).

Auswahl

Die ComboBox lässt die Auswahl eines einzelnen Elements zu. In diesem Falle wird ein EVENT_OBJECT_SELECTION-Ereignis ausgelöst.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		errno : uint Gibt einen Fehlercode an.	AccessibilityImplementation
		stub : Boolean Wird verwendet, um einen Komponenteneingabehilfenteil zu erstellen.	AccessibilityImplementation

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		eventsToHandle : Array [schreibgeschützt] Alle Unterklassen müssen diese Funktion überschreiben, indem sie ein Array von Strings der Ereignisse, auf die gewartet wird, zurückgeben.	AccImpl
		master : UIComponent Ein Verweis auf die UIComponent-Instanz, die durch diese AccImpl-Instanz barrierefrei gemacht wird.	AccImpl
		role : uint Accessibility-Rolle der Komponente, die barrierefrei gemacht wird.	AccImpl

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		ComboBoxAccImpl(master:UIComponent) Konstruktor.	ComboBoxAccImpl
		accDoDefaultAction(childID:uint):void Eine IAccessible-Methode, die die Aktion ausführt, die standardmäßig mit der Komponente verknüpft ist, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente.	AccessibilityImplementation
		accLocation(childID:uint):* MSAA-Methode zur Rückgabe eines DisplayObject oder eines Rechtecks. Gibt den Begrenzungsrahmen des untergeordneten Elements in der AccessibilityImplementation an.	AccessibilityImplementation
		accSelect(operation:uint, childID:uint):void IAccessible-Methode zum Ändern der Auswahl in der Komponente, die diese AccessibilityImplementation darstellt.	AccessibilityImplementation
		enableAccessibility():void [statisch] Aktiviert Barrierefreiheit (Accessibility) in der ComboBox-Klasse.	ComboBoxAccImpl
		get_accDefaultAction(childID:uint):String MSAA-Methode zur Rückgabe der Aktion, die standardmäßig mit der Komponente verknüpft ist, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente.	AccessibilityImplementation
		get_accFocus():uint MSAA-Methode für die Rückgabe der ID des untergeordneten Elements als vorzeichenlose Ganzzahl, sofern ein solches untergeordnetes Element mit entsprechendem Fokus innerhalb der Komponente vorhanden ist.	AccessibilityImplementation
		get_accName(childID:uint):String MSAA-Methode zur Rückgabe des Namens der Komponente, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente.	AccessibilityImplementation
		get_accRole(childID:uint):uint MSAA-Methode zur Rückgabe der Systemrolle der Komponente, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente.	AccessibilityImplementation
		get_accSelection():Array MSAA-Methode zur Rückgabe eines Arrays, das die IDs aller ausgewählten untergeordneten Elemente enthält.	AccessibilityImplementation
		get_accState(childID:uint):uint IAccessible-Methode zur Rückgabe des aktuellen Laufzeitstatus der Komponente, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente.	AccessibilityImplementation
		get_accValue(childID:uint):String MSAA-Methode zur Rückgabe des Laufzeitwerts der Komponente, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente.	AccessibilityImplementation
		get_selectionActiveIndex():*	AccessibilityImplementation
		get_selectionAnchorIndex():*	AccessibilityImplementation
		getChildIDArray():Array Gibt ein Array zurück, das die IDs aller untergeordneten Elemente der AccessibilityImplementation als vorzeichenlose Ganzzahl enthält.	AccessibilityImplementation
		getFormName(component:UIComponent):String [statisch] Methode, mit der die Barrierefreiheit von Formularen unterstützt wird.	AccImpl
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isAncestorDisabled(component:UIComponent):Boolean [statisch] Gibt „true“ zurück, wenn bei einem Vorgänger der Komponente der aktive Status den Wert „false“ hat.	AccImpl
		isLabeledBy(labelBounds:Rectangle):Boolean Gibt „true“ oder „false“ zurück, um anzugeben, ob ein Textobjekt, das durch „x“, „y“, „width“ und „height“ festgelegt ist, als Beschriftung für die durch diese AccessibilityImplementation repräsentierte Komponente betrachtet werden soll.	AccessibilityImplementation
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		eventHandler(event:Event):void Generische Ereignisprozedur.	AccImpl
		getName(childID:uint):String Gibt den Namen der barrierefreien Komponente zurück.	AccImpl
		getState(childID:uint):uint Dienstmethode, die den Status der barrierefreien Komponente bestimmt.	AccImpl

Konstruktordetails

()

Konstruktor

public function ComboBoxAccImpl(master:UIComponent)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor.

Parameter

master:UIComponent — Die UIComponent-Instanz, die durch diese AccImpl-Instanz barrierefrei gemacht wird.

Methodendetails

enableAccessibility

()

Methode

public static function enableAccessibility():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Aktiviert Barrierefreiheit (Accessibility) in der ComboBox-Klasse.

Diese Methode wird durch Anwendungsstartcode aufgerufen, der vom MXML-Compiler automatisch generiert wird. Wenn anschließend ComboBox-Instanzen initialisiert werden, wird deren accessibilityImplementation-Eigenschaft auf eine Instanz dieser Klasse gesetzt.

Rechtliche Hinweise | Onlinedatenschutzerklärung

ComboBoxAccImpl - AS3 Flex

Klassen x

ComboBoxAccImpl

enableAccessibility