Paket | spark.accessibility |
Klasse | public class DropDownListBaseAccImpl |
Vererbung | DropDownListBaseAccImpl ListBaseAccImpl AccImpl AccessibilityImplementation Object |
Unterklassen | ComboBoxAccImpl |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Obwohl ComboBox eine eigene Accessibility-Implementierungsunterklasse hat, verwendet DropDownList einfach diejenige der DropDownListBase. Deshalb bezieht sich der Rest dieser Beschreibung auf die häufig verwendete DropDownList-Komponente und nicht auf die DropDownListBase-Basisklasse.
Wenn eine Spark-DropDownList 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 DropDownList 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 DropDownList sind ihre Listenelemente. Die Anzahl der untergeordneten Elemente ist die Anzahl der Elemente im dataProvider
, nicht nur die Anzahl der sichtbaren Renderer.
Wie unten beschrieben wird die Accessibility der Listenelemente von der DropDownList verwaltet; die accessibilityImplementation
und accessibilityProperties
der Elementrenderer werden von Flash Player ignoriert.
Rolle
Die MSAA-Rolle einer DropDownList ist ROLE_SYSTEM_COMBOBOX.
Die Rolle eines jeden Listenelements ist ROLE_SYSTEM_LISTITEM.
Name
Der MSAA-Name einer DropDownList 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 DropDownList fest.
Der Name der einzelnen Listenelemente wird durch die itemToLabel()
-Methode der DropDownList bestimmt.
Wenn der Name der DropDownList oder eines ihrer Elemente geändert wird, löst die DropDownList 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 DropDownList ist standardmäßig ein leerer String, Sie können jedoch die accessibilityDescription
-Eigenschaft der DropDownList festlegen.
Die Beschreibung eines jeden Listenelements ist der leere String.
Status
Der MSAA-Status einer DropDownList 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 DropDownList den Fokus hat)
- STATE_SYSTEM_EXPANDED (wenn geöffnet)
- STATE_SYSTEM_COLLAPSED (wenn geschlossen)
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 DropDownList oder eines ihrer Listenelemente geändert wird, löst die DropDownList das MSAA-Ereignis EVENT_OBJECT_STATECHANGE aus mit der richtigen childID für das Listenelement oder 0 für sie selbst.
Wert
Der MSAA-Wert einer DropDownList ist der MSAA-Name des aktuell ausgewählten Listenelements.
Der Wert eines jeden Listenelements ist der leere String.
Wenn der Wert der DropDownList geändert wird, löst sie das MSAA-Ereignis EVENT_OBJECT_VALUECHANGE aus.
Speicherort
Die MSAA-Position einer DropDownList oder eines Listenelements ist ihr Begrenzungsrechteck.
Standardaktion
Eine DropDownList hat keine MSAA-DefaultAction
Die DefaultAction eines Listenelements lautet „Double click“.
Fokus
Die DropDownList selbst und ihre Listenelemente können den Fokus erhalten (während die DropDownList reduziert oder erweitert ist). Wenn dies geschieht, wird EVENT_OBJECT_FOCUS ausgelöst.
Auswahl
Die DropDownList lässt die Auswahl eines einzelnen Elements zu. In diesem Falle wird ein EVENT_OBJECT_SELECTION-Ereignis ausgelöst.
Methode | Definiert von | ||
---|---|---|---|
DropDownListBaseAccImpl(master:UIComponent)
Konstruktor. | DropDownListBaseAccImpl | ||
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 | ||
[statisch]
Aktiviert Barrierefreiheit (Accessibility) in der DropDownListBase-Klasse. | DropDownListBaseAccImpl | ||
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 |
DropDownListBaseAccImpl | () | Konstruktor |
public function DropDownListBaseAccImpl(master:UIComponent)
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
Parametermaster:UIComponent — Die UIComponent-Instanz, die durch diese AccImpl-Instanz barrierefrei gemacht wird.
|
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 DropDownListBase-Klasse.
Diese Methode wird durch Anwendungsstartcode aufgerufen, der vom MXML-Compiler automatisch generiert wird. Wenn anschließend DropDownListBase-Instanzen initialisiert werden, wird deren accessibilityImplementation
-Eigenschaft auf eine Instanz dieser Klasse gesetzt.
Tue Jun 12 2018, 10:04 AM Z