| 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 |
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
accessibilityNameder 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
accessibilityNamedes FormItem auf ein Leerzeichen („ “).
- 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
- Der Name der Komponente wird dann folgendermaßen bestimmt:
- Wenn der
accessibilityNameder 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 implementiertgetName(), um anzugeben, dass der Standardname eines Button seiner Beschriftung entspricht.) Wenn der Rückgabewert vongetName()nicht leer ist, wird der Rückgabewert hinzugefügt. - Andernfalls (wenn
getName()einen leeren Wert zurückgab) wird dieser String hinzugefügt, wenn dietoolTip-Eigenschaft der Komponente festgelegt ist. - Wenn die
errorString-Eigenschaft der Komponente festgelegt ist, wird dieser String hinzugefügt.
- Wenn der
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)
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.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche 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 | ||
| Methode | Definiert von | ||
|---|---|---|---|
AccImpl(master:UIComponent)
Konstruktor. | AccImpl | ||
 |
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 | |
|
MSAA-Methode zur Rückgabe eines DisplayObject oder eines Rechtecks. Gibt den Begrenzungsrahmen des untergeordneten Elements in der AccessibilityImplementation an. | AccessibilityImplementation | |
|
IAccessible-Methode zum Ändern der Auswahl in der Komponente, die diese AccessibilityImplementation darstellt. | AccessibilityImplementation | |
|
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 | |
|
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 | |
|
MSAA-Methode zur Rückgabe des Namens der Komponente, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente. | AccessibilityImplementation | |
|
MSAA-Methode zur Rückgabe der Systemrolle der Komponente, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente. | AccessibilityImplementation | |
|
MSAA-Methode zur Rückgabe eines Arrays, das die IDs aller ausgewählten untergeordneten Elemente enthält. | AccessibilityImplementation | |
|
IAccessible-Methode zur Rückgabe des aktuellen Laufzeitstatus der Komponente, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente. | AccessibilityImplementation | |
|
MSAA-Methode zur Rückgabe des Laufzeitwerts der Komponente, die diese accessibilityImplementation darstellt, oder eines ihrer untergeordneten Elemente. | AccessibilityImplementation | |
| AccessibilityImplementation | ||
| AccessibilityImplementation | ||
|
Gibt ein Array zurück, das die IDs aller untergeordneten Elemente der AccessibilityImplementation als vorzeichenlose Ganzzahl enthält. | AccessibilityImplementation | |
[statisch]
Methode, mit der die Barrierefreiheit von Formularen unterstützt wird. | AccImpl | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
[statisch]
Gibt „true“ zurück, wenn bei einem Vorgänger der Komponente der aktive Status den Wert „false“ hat. | AccImpl | ||
|
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 | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
| Methode | Definiert von | ||
|---|---|---|---|
Generische Ereignisprozedur. | AccImpl | ||
Gibt den Namen der barrierefreien Komponente zurück. | AccImpl | ||
Dienstmethode, die den Status der barrierefreien Komponente bestimmt. | AccImpl | ||
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():Arraymaster | 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.
AccImpl | () | Konstruktor |
public function AccImpl(master:UIComponent)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
Parametermaster:UIComponent — Die UIComponent-Instanz, die durch diese AccImpl-Instanz barrierefrei gemacht wird.
|
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 |
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 |
String |
getState | () | Methode |
isAncestorDisabled | () | Methode |
public static function isAncestorDisabled(component:UIComponent):BooleanGibt „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.
|
Boolean — „true“, wenn die Komponente über ein deaktiviertes übergeordnetes Element verfügt.
|
Tue Jun 12 2018, 10:04 AM Z