Appendice G: Accesso facilitato attivo all'automazione interfaccia utente
Questa appendice contiene informazioni su Microsoft Active Accessibility Bridge. Active Accessibility Bridge consente alle applicazioni che implementano Microsoft Active Accessibility di accedere alle applicazioni che implementano Automazione interfaccia utente Microsoft. Grazie al bridging di Microsoft Active Accessibility e automazione interfaccia utente insieme, i client basati sull'accessibilità Microsoft Active, ad esempio un utilità per la lettura dello schermo in Windows XP, possono interagire a livello di codice con provider basati sull'automazione interfaccia utente di Automazione interfaccia utente, ad esempio un'applicazione Windows Presentation Foundation (WPF). Fa parte dell'API Native Core di Automazione interfaccia utente (UIAutomationCore.dll).
Active Accessibility Bridge esegue il mapping delle proprietà e degli eventi di Automazione interfaccia utente a quelli di Microsoft Active Accessibility. Le tabelle seguenti eseguono il mapping dei metodi e delle proprietà dell'interfaccia microsoft Active Accessibility IAccessible all'automazione interfaccia utente. Usare queste tabelle per determinare le procedure di codifica appropriate per lo sviluppo del client basato sull'accessibilità di Microsoft Active.
Proprietà di navigazione e gerarchia
| Proprietà IAccessible | Proprietà automazione interfaccia utente |
|---|---|
| get_accChild | Non implementato |
| get_accChildCount | Derivato dall'albero di automazione interfaccia utente |
| get_accParent | Derivato dall'albero di automazione interfaccia utente |
| accNavigate | Non implementato |
Proprietà e metodi descrittivi
| IAccessible | Automazione interfaccia utente |
|---|---|
| accDoDefaultAction | Per informazioni dettagliate, vedere la tabella Tipi di controllo e accRole. |
| get_accDefaultAction | Per informazioni dettagliate, vedere la tabella Tipi di controllo e accRole. |
| get_accKeyboardShortcut | AccessKeyPropertyor AcceleratorKeyProperty; se entrambi presenti, AccessKeyProperty ha la precedenza. |
| get_accName | NameProperty |
| get_accRole | ControlTypeProperty. Per informazioni dettagliate, vedere la tabella Tipi di controllo e accRole. |
| get_accState | Per informazioni dettagliate, vedere la tabella Tipi di controllo e accRole. |
| get_accValue | ValueProperty; supportato nei tipi di controllo che supportano il pattern di controllo Value o RangeValue pattern di controllo del pattern di controllo. I valori RangeValue sono coerenti con il comportamento di Accessibilità di Microsoft Active (da 0 a 100). Gli elementi valore usano una stringa. |
| put_accValue | ValueProperty; supportato nei tipi di controllo che supportano il pattern di controllo Valore o RangeValue pattern di controllo |
| get_accHelp | HelpTextProperty |
| get_accDescription | Non implementato |
| get_accHelpTopic | Non implementato |
Tipi di controllo e accRole
Il ruolo predefinito Microsoft Active Accessibility è ROLE_SYSTEM_CLIENT. Se non viene trovata alcuna azione predefinita per un tipo di controllo, il bridge di accessibilità attiva userà anche i modelli di controllo disponibili seguenti: Invoke, ExpandCollapsee Attiva/Disattiva. Ad esempio, un controllo groupbox non ha alcuna azione predefinita. Se supporta ExpandCollapse, il bridge di accessibilità attivo userà tale oggetto per l'azione predefinita.
Proprietà e accState di automazione interfaccia utente
| accState | Proprietà automazione interfaccia utente | Modifica dello stato dei trigger |
|---|---|---|
| STATE_SYSTEM_CHECKED | Per ControlType = "checkbox" usare ToggleState.On. Per "radiobutton" usare SelectionItemPattern::IsSelected | Sì |
| STATE_SYSTEM_FOCUSABLE | IsKeyboardFocusableProperty | No |
| STATE_SYSTEM_FOCUSED | HasKeyboardFocusProperty | No |
| STATE_SYSTEM_PROTECTED | IsPasswordProperty | No |
| STATE_SYSTEM_READONLY | IsReadOnlyProperty (pattern di controllo Value e Pattern di controllo RangeValue) | No |
| STATE_SYSTEM_UNAVAILABLE | IsEnabledProperty | Sì |
| STATE_SYSTEM_LINKED | ControlTypeProperty = "hyperlink" | No |
| STATE_SYSTEM_SELECTABLE | SelectionItemPattern è supportato | No |
| STATE_SYSTEM_SELECTED | IsSelectedProperty (pattern di controllo SelectionItem) | No |
| STATE_SYSTEM_COLLAPSED | ExpandCollapseState = Compresso | Sì |
| STATE_SYSTEM_EXPANDED | ExpandCollapseState = Espanso o ParzialmenteExpanded | Sì |
| STATE_SYSTEM_HASPOPUP | Voci di menu che supportano Expand/Collapse | No |
| STATE_SYSTEM_MIXED | ToggleState = Indeterminate | No |
| STATE_SYSTEM_SIZEABLE | IUIAutomationTransformPattern::CanResize | No |
| STATE_SYSTEM_MOVEABLE | IUIAutomationTransformPattern::CanMove | No |
| STATE_SYSTEM_MULTISELECTABLE | IUIAutomationSelectionPattern::CanSelectMultiple | No |
Selezione e stato attivo
| IAccessible | Automazione interfaccia utente |
|---|---|
| get_accFocus | IUIAutomation::FocusedElement |
| accSelect | Per informazioni dettagliate, vedere la tabella Ui Automation Properties and accSelect SELFLAGs (Proprietà automazione interfaccia utente e accSelect SELFLAGs). |
| get_accSelection | SelectionPattern::GetSelection |
Proprietà di automazione interfaccia utente e accSelect SELFLAGs
| accSelect SELFLAGs | Proprietà automazione interfaccia utente |
|---|---|
| SELFLAG_NONE | Non disponibile |
| SELFLAG_TAKFOCUS | IUIAutomationElement::SetFocus |
| SELFLAG_TAKESELECTION | IUIAutomationSelectionItemPattern::Select |
| SELFLAG_ADDSELECTION | IUIAutomationSelectionItemPattern::AddToSelection |
| SELFLAG_TAKEREMOVESELECTION | IUIAutomationSelectionItemPattern::RemoveFromSelection |
| SELFLAG_EXTENDSELECTION | Non disponibile |
Mapping spaziale
| IAccessible | Automazione interfaccia utente |
|---|---|
| accLocation | BoundingRectangleProperty |
| accHitTest | IRawElementProviderFragmentRoot::ElementProviderFromPoint |
Avvenimenti
| Costanti evento System-Level | Automazione interfaccia utente |
|---|---|
| EVENT_SYSTEM_MENUPOPUPSTART | UIA_MenuOpenedEventId (nota: deve verificare se si tratta di una finestra popup). |
| EVENT_SYSTEM_MENUPOPUPEND | UIA_MenuClosedEventId |
| EVENT_SYSTEM_MENUSTART | UIA_MenuModeStartEventId |
| EVENT_SYSTEM_MENUEND | UIA_MenuModeEndEventId |
| EVENT_SYSTEM_SOUND | |
| EVENT_SYSTEM_ALERT | |
| EVENT_SYSTEM_CAPTURESTART | |
| EVENT_SYSTEM_CAPTUREEND | |
| EVENT_SYSTEM_DIALOGSTART | |
| EVENT_SYSTEM_DIALOGEND | |
| EVENT_SYSTEM_MOVESIZESTART | |
| EVENT_SYSTEM_MOVESIZEEND | |
| EVENT_SYSTEM_CONTEXTHELPSTART | |
| EVENT_SYSTEM_CONTEXTHELPEND | Non pertinente |
| EVENT_SYSTEM_DRAGDROPSTART | |
| EVENT_SYSTEM_DRAGDROPEND | |
| EVENT_SYSTEM_SWITCHSTART | Non pertinente |
| EVENT_SYSTEM_SWITCHEND | Non pertinente |
| EVENT_SYSTEM_MINIMIZESTART | |
| EVENT_SYSTEM_MINIMIZEEND | |
| EVENT_SYSTEM_FOREGROUND | |
| EVENT_SYSTEM_SCROLLINGSTART | Non disponibile |
| EVENT_SYSTEM_SCROLLINGEND | Non disponibile |
| Costanti evento Object-Level | Automazione interfaccia utente |
|---|---|
| EVENT_OBJECT_FOCUS | AutomationFocusChangedEvent |
| EVENT_OBJECT_VALUECHANGE | ValueProperty (pattern di controllo value e pattern di controllo RangeValue) |
| EVENT_OBJECT_SELECTION | ElementSelectedEvent (pattern di controllo SelectionItem) |
| EVENT_OBJECT_SELECTIONADD | ElementAddedToSelectionEvent (pattern di controllo SelectionItem) |
| EVENT_OBJECT_SELECTIONREMOVE | ElementRemovedFromSelectionEvent |
| EVENT_OBJECT_SELECTIONWITHIN | EventsSelectionInvalidatedEvent |
| EVENT_OBJECT_STATECHANGE | Vedere Proprietà di automazione interfaccia utente e tabella accState per gli stati che attivano una modifica dello stato |