AccImpl

Paket	mx.accessibility
Klasse	public class AccImpl
Vererbung	AccImpl AccessibilityImplementation Object
Unterklassen	AccordionHeaderAccImpl, ButtonAccImpl, ButtonBaseAccImpl, ComboBaseAccImpl, DateChooserAccImpl, DateFieldAccImpl, LabelAccImpl, ListBaseAccImpl, ListBaseAccImpl, MenuBarAccImpl, PanelAccImpl, PanelAccImpl, RichEditableTextAccImpl, SliderAccImpl, SliderBaseAccImpl, SpinnerAccImpl, TabBarAccImpl, TextBaseAccImpl, TreeAccImpl, VideoPlayerAccImpl

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

In Flex stellt AccImpl die grundlegendste Implementierungsklasse für Barrierefreiheitsfunktionen der MX- und Spark-Komponenten dar.

Sie ist eine Unterklasse der AccessibilityImplementation-Klasse von Flash Player.

Wenn eine MX- oder Spark-Komponente erstellt wird, wird ihre accessibilityImplementation-Eigenschaft auf eine Instanz einer Unterklasse dieser Klasse gesetzt. Der Flash Player lässt dann mithilfe dieses Objekts zu, dass MSAA-Clients, wie z. B. Bildschirmleseprogramme, Komponenten erkennen und ändern dürfen. Weitere Informationen über Accessibility-Implementierungsklassen und MSAA finden Sie unter der flash.accessibility.AccessibilityImplementation-Klasse.

Untergeordnete Elemente

Flash Player unterstützt keine echte Hierarchie barrierefreier Objekte. Wenn ein DisplayObject über ein accessibilityImplementation-Objekt verfügt, dann werden die accessibilityImplementation-Objekte seiner untergeordneten Elemente ignoriert. Der Player lässt jedoch zu, dass die Accessibility-Implementierungsklasse MSAA-Informationen über die internen Teile einer Komponente bereitstellt. (Zum Beispiel werden bei einer Liste MSAA-Informationen über ihre Elemente zugänglich.)

Die Anzahl der untergeordneten Elemente (interne Teile) sowie die Child-IDs, über die sie identifiziert werden, werden durch die getChildIDArray()-Methode bestimmt. In der AccessibilityImplementation-Basisklasse des Players gibt diese Methode einfach null zurück. Die AccImpl-Klasse von Flex überschreibt dies und gibt ein leeres Array zurück. Es wird auch eine geschützte Dienstmethode bereitgestellt, createChildIDArray(), die Unterklassen mit internen Teilen für das Überschreiben nutzen können.

Rolle

Die MSAA-Rolle einer Komponente und ihrer internen Teile wird mithilfe der get_accRole()-Methode bestimmt. Bei der AccessibilityImplementation-Basisklasse des Players gibt diese Methode einen Laufzeitfehler aus, da erwartet wird, dass sie von Unterklassen überschrieben wird. Die AccImpl-Klasse von Flex hat eine geschützte role-Eigenschaft, die im Allgemeinen durch den Konstruktor von Unterklassen festgelegt wird. Sie überschreibt get_accRole(), um diese Eigenschaft zurückzugeben.

Name

Der MSAA-Name einer Komponente und ihrer internen Teile wird mithilfe der get_accName()-Methode bestimmt. In der AccessibilityImplementation-Basisklasse des Players gibt diese Methode einfach null zurück. Die AccImpl-Klasse von Flex überschreibt diesen Wert und erstellt einen Namen, beginnend mit einem leeren String, dessen hinzugefügte Teile jeweils durch eine Leerstelle abgetrennt werden. Hierbei wird folgendermaßen vorgegangen:

Wenn ein einfaches untergeordnetes Element angefordert wird (z. B. ein Kombinationsfeld oder ein Listenfeld), wird nur der Standardname des untergeordneten Elements zurückgegeben. Die übrigen Schritte beziehen sich nur auf die Komponente selbst (childID 0).
Wenn sich die Komponente in einem Formular befindet:
- Wenn das Formular über eine FormHeading verfügt und sich die Komponente in einem FormItem befindet, wird der Überschrifttext hinzugefügt. Um dies zu verhindern, setzen Sie den accessibilityName der FormHeading auf ein Leerzeichen („ “).
- Wenn dieses Feld erforderlich ist, wird der gebietsschemaabhängige String „Erforderliches Feld“ (required field) hinzugefügt.
- Wenn sich die Komponente in einem FormItem befindet, wird der FormItem-Beschriftungstext hinzugefügt. Um dies zu verhindern, setzen Sie den accessibilityName des FormItem auf ein Leerzeichen („ “).
Der Name der Komponente wird dann folgendermaßen bestimmt:
- Wenn der accessibilityName der Komponente (d. h. accessibilityProperties.name) ein Leerzeichen ist, wird kein Komponentenname hinzugefügt.
- Ansonsten, wenn der Komponentenname angegeben ist (d. h. nicht null und nicht leer ist), wird er hinzugefügt.
- Andernfalls wird eine geschützte getName()-Methode, die von AccImpl definiert und allen Unterklassen implementiert wird, aufgerufen, um einen Standardnamen anzugeben. (Beispiel: ButtonAccImpl implementiert getName(), um anzugeben, dass der Standardname eines Button seiner Beschriftung entspricht.) Wenn der Rückgabewert von getName() nicht leer ist, wird der Rückgabewert hinzugefügt.
- Andernfalls (wenn getName() einen leeren Wert zurückgab) wird dieser String hinzugefügt, wenn die toolTip-Eigenschaft der Komponente festgelegt ist.
- Wenn die errorString-Eigenschaft der Komponente festgelegt ist, wird dieser String hinzugefügt.

Beschreibung

Die MSAA-Beschreibung wird ausschließlich durch das accessibilityProperties-Objekt einer Komponente bestimmt und nicht durch ihr accessibilityImplementation-Objekt. Deshalb enthalten AccessibilityImplementation, AccImpl und gegebenenfalls vorhandene Unterklassen von AccImpl keine Logik, die sich auf die Beschreibung bezieht. Üblicherweise wird die Beschreibung in Flex über die accessibilityDescription-Eigenschaft der UIComponent mit accessibilityProperties.description festgelegt.

Status

Der MSAA-Status einer Komponente und ihrer internen Teile wird mithilfe der get_accState()-Methode bestimmt. Bei der AccessibilityImplementation-Basisklasse des Players gibt diese Methode einen Laufzeitfehler aus, da erwartet wird, dass sie von Unterklassen überschrieben wird. Die AccImpl-Klasse von Flex überschreibt sie nicht, sondern stellt eine geschützte Dienstmethode bereit, getState(), die Unterklassen für das Überschreiben verwenden können. Die getState()-Methode bestimmt den Status als Kombination von

STATE_SYSTEM_UNAVAILABLE (wenn bei dieser Komponente oder irgendeinem Vorgänger „false“ aktiviert ist)
STATE_SYSTEM_FOCUSABLE
STATE_SYSTEM_FOCUSED (wenn die Komponente selbst im Fokus dargestellt wird; wird nicht für mögliche Unterteile der Komponente festgelegt)

Standardmäßig wird davon ausgegangen, dass alle Komponenten den Fokus erhalten können. Deshalb müssen die Accessibility-Implementierungsklassen für Komponenten, die nicht fokusfähig sind (z. B. „Label“), dieses Statusflag löschen. Wenn eine Komponente den Status „nicht verfügbar“ hat, wird der fokusfähige Status durch die Accessibility-Implementierungsklasse entfernt.

Wert

Der MSAA-Wert einer Komponente und ihrer internen Teile wird mithilfe der get_accValue()-Methode bestimmt. In der AccessibilityImplementation-Basisklasse des Players gibt diese Methode einfach null zurück. Dies wird von der Flex-AccImpl-Klasse nicht überschrieben, aber von Unterklassen für Komponenten wie TextInput.

Speicherort

Die MSAA-Position der internen Teile einer Komponente, aber nicht die Komponente selbst, wird durch die get_accLocation()-Methode bestimmt. Diese Methode wird bei einer childID von 0 nicht aufgerufen; Flash Player bestimmt stattdessen die MSAA-Position einer Komponente anhand ihres Begrenzungsrechtecks mithilfe von getBounds(). Diese Methode wird von der Flex-AccImpl-Klasse nicht überschrieben, aber von Unterklassen für Komponenten mit internen Teilen.

Standardaktion

Die MSAA-Standardaktion einer Komponente und ihrer internen Teile wird durch die get_accDefaultAction()-Methode bestimmt. In der AccessibilityImplementation-Basisklasse des Players gibt diese Methode einfach null zurück. Dies wird von der Flex-AccImpl-Klasse nicht überschrieben, aber von Unterklassen mit Standardaktionen. Diese Unterklassen überschreiben auch die AccessibilityImplementation-accDoDefaultAction()-Methode, um die angegebene Standardaktion auszuführen.

Sonstiges

Die MSAA-Ereignisse EVENT_OBJECT_SHOW und EVENT_OBJECT_HIDE werden gesendet, wenn das Objekt eingeblendet oder ausgeblendet wird. Der jeweils entsprechende Status wird von Flash Player berücksichtigt; er gibt keine MSAA-Komponenten wieder, die ausgeblendet sind. Wenn die Komponente angezeigt wird, werden die für AccImpl erwähnten Status verwendet.

Ö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

	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
		AccImpl(master:UIComponent) Konstruktor.	AccImpl
		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
		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

	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

Eigenschaftendetails

eventsToHandle

Eigenschaft

eventsToHandle:Array [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Alle Unterklassen müssen diese Funktion überschreiben, indem sie ein Array von Strings der Ereignisse, auf die gewartet wird, zurückgeben.

Implementierung
protected function get eventsToHandle():Array

master

Eigenschaft

protected var master:UIComponent

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Verweis auf die UIComponent-Instanz, die durch diese AccImpl-Instanz barrierefrei gemacht wird.

role

Eigenschaft

protected var role:uint

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Accessibility-Rolle der Komponente, die barrierefrei gemacht wird.

Konstruktordetails

()

Konstruktor

public function AccImpl(master:UIComponent)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Parameter

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

Methodendetails

eventHandler

()

Methode

protected function eventHandler(event:Event):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Generische Ereignisprozedur. Alle AccImpl-Unterklassen müssen sie implementieren, um auf Ereignisse der Master-Komponente warten zu können.

Parameter

event:Event

getFormName

()

Methode

public static function getFormName(component:UIComponent):String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Methode, mit der die Barrierefreiheit von Formularen unterstützt wird. Wird aus get_accName() in dieser AccImpl-Klasse aufgerufen. Wird auch aus dem UIComponentAccProps-Konstruktor aufgerufen.

Parameter

component:UIComponent

Rückgabewerte

String

getName

()

Methode

protected function getName(childID:uint):String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt den Namen der barrierefreien Komponente zurück. Von allen Unterklassen anstelle von get_accName() zu implementieren.

Parameter

childID:uint

Rückgabewerte

String

getState

()

Methode

protected function getState(childID:uint):uint

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Dienstmethode, die den Status der barrierefreien Komponente bestimmt.

Parameter

childID:uint

Rückgabewerte

uint

isAncestorDisabled

()

Methode

public static function isAncestorDisabled(component:UIComponent):Boolean

Gibt „true“ zurück, wenn bei einem Vorgänger der Komponente der aktive Status den Wert „false“ hat. Die angegebene Komponente selbst wird nicht überprüft.

Parameter

component:UIComponent — Die auf ein deaktiviertes übergeordnetes Element zu überprüfende UIComponent.

Rückgabewerte

Boolean — „true“, wenn die Komponente über ein deaktiviertes übergeordnetes Element verfügt.

Rechtliche Hinweise | Onlinedatenschutzerklärung

AccImpl - AS3 Flex

Klassen x

eventsToHandle

master

role

AccImpl

eventHandler

getFormName

getName

getState

isAncestorDisabled