Pakiet | mx.accessibility |
Klasa | public class AccImpl |
Dziedziczenie | AccImpl AccessibilityImplementation Object |
Podklasy | AccordionHeaderAccImpl, ButtonAccImpl, ButtonBaseAccImpl, ComboBaseAccImpl, DateChooserAccImpl, DateFieldAccImpl, LabelAccImpl, ListBaseAccImpl, ListBaseAccImpl, MenuBarAccImpl, PanelAccImpl, PanelAccImpl, RichEditableTextAccImpl, SliderAccImpl, SliderBaseAccImpl, SpinnerAccImpl, TabBarAccImpl, TextBaseAccImpl, TreeAccImpl, VideoPlayerAccImpl |
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
It is a subclass of the Flash Player's AccessibilityImplementation class.
When an MX or Spark component is created,
its accessibilityImplementation
property
is set to an instance of a subclass of this class.
The Flash Player then uses this object to allow MSAA clients
such as screen readers to see and manipulate the component.
See the flash.accessibility.AccessibilityImplementation class
for additional information about accessibility implementation
classes and MSAA.
Children
The Flash Player does not support
a true hierarchy of accessible objects.
If a DisplayObject has an accessibilityImplementation
object,
then the accessibilityImplementation
objects
of its children are ignored.
However, the Player does allow a component's accessibility implementation class
to expose MSAA information for its internal parts.
(For example, a List exposes MSAA information about its items.)
The number of children (internal parts)
and the child IDs used to identify them
are determined by the getChildIDArray()
method.
In the Player's AccessibilityImplementation base class,
this method simply returns null
.
Flex's AccImpl class overrides it to return an empty array.
It also provides a protected utility method,
createChildIDArray()
which subclasses with internal parts
can use in their overrides.
Role
The MSAA Role of a component and its internal parts
is determined by the get_accRole()
method.
In the Player's AccessibilityImplementation base class,
this method throws a runtime error,
since subclasses are expected to override it.
Flex's AccImpl class has a protected role
property
which subclasses generally set in their constructor,
and it overrides get_accRole()
to return this property.
Name
The MSAA Name of a component and its internal parts
is determined by the get_accName()
method.
In the Player's AccessibilityImplementation base class,
this method simply returns null
.
Flex's AccImpl class overrides it to construct a name as follows,
starting with an empty string
and separating added portions with a single space:
- If a simple child (e.g., combo or list box item) is being requested, only the child's default name is returned. The rest of the steps below apply only to the component itself (childID 0).
- If the component is inside a Form:
- If the Form has a FormHeading and the component is inside
a FormItem, the heading text is added.
Developers wishing to avoid this should set the
accessibilityName
of the FormHeading to a space (" "). - If the field is required, the locale-dependent string "required field" is added.
- If the component is inside a FormItem,
the FormItem label text is added.
Developers wishing to avoid this should set the
accessibilityName
of the FormItem to a space (" ").
- If the Form has a FormHeading and the component is inside
a FormItem, the heading text is added.
Developers wishing to avoid this should set the
- The component's name is then determined thus:
- If the component's
accessibilityName
(i.e.,accessibilityProperties.name
) is a space, no component name is added. - Otherwise, if the component's name is specified (i.e., is not null and not empty) then it is added.
- Otherwise, a protected
getName()
method, defined by AccImpl and implemented by each subclass, is called to provide a default name. (For example, ButtonAccImpl implementsgetName()
to specify that a Button's default name is the label that it displays.) If not empty, the return value ofgetName()
is added. - Otherwise (if
getName()
returned empty), if the component'stoolTip
property is set, that String is added. - If the component's
errorString
property is set, that String is added.
- If the component's
Description
The MSAA Description is determined solely by a component's
accessibilityProperties
object and not by its
accessibilityImplementation
object.
Therefore there is no logic in AccessibilityImplementation or AccImpl
or any subclasses of AccImpl related to the description.
The normal way to set the description in Flex is via the
accessibilityDescription
property on UIComponent,
which simply sets accessibilityProperties.description
.
State
The MSAA State of a component and its internal parts
is determined by the get_accState()
method.
In the Player's AccessibilityImplementation base class,
this method throws a runtime error,
since subclasses are expected to override it.
Flex's AccImpl class does not override it,
but provides a protected utility method, getState()
,
for subclasses to use in their overrides.
The getState()
method determines the state
as a combination of
- STATE_SYSTEM_UNAVAILABLE (when enabled is false on this component or any ancestor)
- STATE_SYSTEM_FOCUSABLE
- STATE_SYSTEM_FOCUSED (when the component itself is focused, not set for any subparts the component may have)
Value
The MSAA Value of a component and its internal parts
is determined by the get_accValue()
method.
In the Player's AccessibilityImplementation base class,
this method simply returns null
.
Flex's AccImpl class does not override it,
but subclasses for components like TextInput do.
Location
The MSAA Location for a component's internal parts,
but not the component itself,
is determined by the get_accLocation()
method.
This method is never called with a childID of 0;
instead, the Flash Player determines the MSAA Location of a component
based on its bounding rectangle as determined by getBounds()
.
Flex's AccImpl class does not override this method,
but subclasses for components with internal parts do.
Default Action
The MSAA DefaultAction for a component and its internal parts
is determined by the get_accDefaultAction()
method.
In the Player's AccessibilityImplementation base class,
this method simply returns null
.
Flex's AccImpl class does not override it,
but subclasses with default actions do.
These subclasses also override AccessibilityImplementation's
accDoDefaultAction()
method
to perform the default action that they advertise.
Other
The MSAA events EVENT_OBJECT_SHOW and EVENT_OBJECT_HIDE are sent when the object is shown or hidden. The corresponding states for these are covered by the Flash Player which does not render any MSAA components that are hidden. When the component is shown the states mentioned for AccImpl are used.
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
eventsToHandle : Array [tylko do odczytu]
All subclasses must override this function by returning an array
of strings of the events to listen for. | AccImpl | ||
master : UIComponent
A reference to the UIComponent instance that this AccImpl instance
is making accessible. | AccImpl | ||
role : uint
Accessibility role of the component being made accessible. | AccImpl |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
AccImpl(master:UIComponent)
Constructor. | AccImpl | ||
Metoda IAccessible wykonująca domyślą czynność skojarzoną ze składnikiem reprezentowanym przez tę klasę AccessibilityImplementation lub jeden z jego elementów potomnych. | AccessibilityImplementation | ||
Metoda MSAA zwracająca obiekt DisplayObject lub Rectangle określający obwiednię elementu podrzędnego w klasie AccessibilityImplementation. | AccessibilityImplementation | ||
Metoda IAccessible służąca do zmiany zaznaczenia w składniku reprezentowanym przez ten obiekt AccessibilityImplementation. | AccessibilityImplementation | ||
Metoda modelu MSAA służąca do zwracania domyślnej czynności składnika reprezentowanego przez ten obiekt AccessibilityImplementation lub jednego z jego elementów podrzędnych. | AccessibilityImplementation | ||
Metoda MSAA służąca do zwracania identyfikatora (liczby całkowitej bez znaku) elementu podrzędnego, który jest aktywny w składniku, o ile istnieje aktywny element. | AccessibilityImplementation | ||
Metoda modelu MSAA służąca do zwracania nazwy składnika reprezentowanego przez ten obiekt AccessibilityImplementation lub jednego z jego elementów potomnych. | AccessibilityImplementation | ||
Metoda modelu MSAA służąca do zwracania roli systemowej składnika reprezentowanego przez ten obiekt AccessibilityImplementation lub jednego z jego elementów podrzędnych. | AccessibilityImplementation | ||
Metoda modelu MSAA służąca do zwracania tablicy zawierającej identyfikatory wszystkich elementów podrzędnych, które są zaznaczone. | AccessibilityImplementation | ||
Metoda interfejsu IAccessible służąca do zwracania bieżącego stanu (w środowisku wykonawczym) składnika reprezentowanego przez ten obiekt AccessibilityImplementation lub jednego z jego elementów potomnych. | AccessibilityImplementation | ||
Metoda modelu MSAA służąca do zwracania wartości (w środowisku wykonawczym) składnika reprezentowanego przez ten obiekt AccessibilityImplementation lub jednego z jego elementów podrzędnych. | AccessibilityImplementation | ||
AccessibilityImplementation | |||
AccessibilityImplementation | |||
Zwraca tablicę zawierającą identyfikatory (liczby całkowite bez znaku) wszystkich elementów podrzędnych w obiekcie AccessibilityImplementation. | AccessibilityImplementation | ||
[statyczny]
Method for supporting Form Accessibility. | AccImpl | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
[statyczny]
Returns true if an ancestor of the component has enabled set to false. | AccImpl | ||
Zwraca wartość true albo false, wskazując, czy obiekt tekstowy o obwiedni określonej przez parametry x, y, width i height powinien być uznawany za etykietę składnika reprezentowanego przez ten obiekt AccessibilityImplementation. | AccessibilityImplementation | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Generic event handler. | AccImpl | ||
Returns the name of the accessible component. | AccImpl | ||
Utility method to determine state of the accessible component. | AccImpl |
eventsToHandle | właściwość |
eventsToHandle:Array
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
All subclasses must override this function by returning an array of strings of the events to listen for.
Implementacja
protected function get eventsToHandle():Array
master | właściwość |
protected var master:UIComponent
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
A reference to the UIComponent instance that this AccImpl instance is making accessible.
role | właściwość |
protected var role:uint
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Accessibility role of the component being made accessible.
AccImpl | () | Konstruktor |
public function AccImpl(master:UIComponent)
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Constructor.
Parametrymaster:UIComponent — The UIComponent instance that this AccImpl instance
is making accessible.
|
eventHandler | () | metoda |
getFormName | () | metoda |
public static function getFormName(component:UIComponent):String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Method for supporting Form Accessibility. Called from get_accName() in this AccImpl class. Also called from the UIComponentAccProps constructor.
Parametry
component:UIComponent |
String |
getName | () | metoda |
protected function getName(childID:uint):String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flex 3 |
Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Returns the name of the accessible component. All subclasses must implement this instead of implementing get_accName().
Parametry
childID:uint |
String |
getState | () | metoda |
isAncestorDisabled | () | metoda |
public static function isAncestorDisabled(component:UIComponent):Boolean
Returns true if an ancestor of the component has enabled set to false. The given component itself is not checked.
Parametry
component:UIComponent — The UIComponent to check for a disabled ancestor.
|
Boolean — true if the component has a disabled ancestor.
|
Tue Jun 12 2018, 12:06 PM Z