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 |
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.
Methode | Definiert von | ||
---|---|---|---|
ComboBoxAccImpl(master:UIComponent)
Konstruktor. | ComboBoxAccImpl | ||
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 ComboBox-Klasse. | ComboBoxAccImpl | ||
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 |
ComboBoxAccImpl | () | Konstruktor |
public function ComboBoxAccImpl(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 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.
Tue Jun 12 2018, 10:04 AM Z