Anhang G: Aktive Barrierefreiheitsbrücke zur Benutzeroberflächenautomatisierung
Dieser Anhang enthält Informationen zur Microsoft Active Accessibility Bridge. Die Active Accessibility Bridge ermöglicht Anwendungen, die Microsoft Active Accessibility implementieren, um auf Anwendungen zuzugreifen, die Microsoft-Benutzeroberflächenautomatisierung implementieren. Durch die Zusammenarbeit von Microsoft Active Accessibility und der Benutzeroberflächenautomatisierung können Microsoft Active Accessibility-basierte Clients, z. B. eine Bildschirmsprachausgabe unter Windows XP, programmgesteuert mit benutzeroberflächenautomatisierungsbasierten Anbietern der Benutzeroberflächenautomatisierung interagieren, z. B. mit einer Windows Presentation Foundation (WPF)-Anwendung. Sie ist Teil der nativen Benutzeroberflächenautomatisierungs-API (UIAutomationCore.dll).
Die Active Accessibility Bridge ordnet benutzeroberflächenautomatisierungs-Eigenschaften und -Ereignisse den Eigenschaften und Ereignissen von Microsoft Active Accessibility zu. Die folgenden Tabellen ordnen die Microsoft Active Accessibility IAccessible Schnittstellenmethoden und -eigenschaften der Benutzeroberflächenautomatisierung zu. Verwenden Sie diese Tabellen, um geeignete Codierungsmethoden für die Entwicklung Ihres microsoft Active Accessibility-basierten Clients zu ermitteln.
Navigations- und Hierarchieeigenschaften
| IAccessible-Eigenschaft | Benutzeroberflächenautomatisierungs-Eigenschaft |
|---|---|
| get_accChild | Nicht implementiert |
| get_accChildCount | Abgeleitet von der Benutzeroberflächenautomatisierungsstruktur |
| get_accParent | Abgeleitet von der Benutzeroberflächenautomatisierungsstruktur |
| accNavigate- | Nicht implementiert |
Beschreibende Eigenschaften und Methoden
| IAccessible | Benutzeroberflächenautomatisierung |
|---|---|
| accDoDefaultAction | Weitere Informationen finden Sie in der Tabelle "Steuerelementtypen und accRole". |
| get_accDefaultAction | Weitere Informationen finden Sie in der Tabelle "Steuerelementtypen und accRole". |
| get_accKeyboardShortcut | AccessKeyPropertyor AcceleratorKeyProperty; Wenn beide vorhanden sind, hat AccessKeyProperty Vorrang. |
| get_accName | NameProperty |
| get_accRole | ControlTypeProperty. Weitere Informationen finden Sie in der Tabelle "Steuerelementtypen und accRole". |
| get_accState | Weitere Informationen finden Sie in der Tabelle "Steuerelementtypen und accRole". |
| get_accValue | ValueProperty; unterstützt für Steuerelementtypen, die das Value Steuerelementmuster oder RangeValue Steuerelementmuster unterstützen. RangeValue-Werte entsprechen dem Microsoft Active Accessibility-Verhalten (0 bis 100). Wertelemente verwenden eine Zeichenfolge. |
| put_accValue | ValueProperty; unterstützt für Steuerelementtypen, die das Value Steuerelementmuster oder RangeValue- Steuerelementmuster unterstützen |
| get_accHelp | HelpTextProperty |
| get_accDescription | Nicht implementiert |
| get_accHelpTopic | Nicht implementiert |
Steuerelementtypen und accRole
Die Microsoft Active Accessibility-Standardrolle ist ROLE_SYSTEM_CLIENT. Wenn keine Standardaktion für einen Steuerelementtyp gefunden wird, verwendet die aktive Barrierefreiheitsbrücke auch die folgenden verfügbaren Steuerelementmuster: Aufrufen, ExpandCollapseund Umschalten. Ein Groupbox-Steuerelement hat beispielsweise keine Standardaktion. Wenn es ExpandCollapse unterstützt, verwendet die aktive Barrierefreiheitsbrücke dies für die Standardaktion.
Benutzeroberflächenautomatisierungs-Eigenschaften und accState
| accState | Benutzeroberflächenautomatisierungs-Eigenschaft | Löst Zustandsänderung aus |
|---|---|---|
| STATE_SYSTEM_CHECKED | Verwenden Sie für ControlType = "checkbox" ToggleState.On. Verwenden Sie für "Optionsfeld" SelectionItemPattern::IsSelected | Ja |
| STATE_SYSTEM_FOCUSABLE | IsKeyboardFocusableProperty | Nein |
| STATE_SYSTEM_FOCUSED | HasKeyboardFocusProperty | Nein |
| STATE_SYSTEM_PROTECTED | IsPasswordProperty | Nein |
| STATE_SYSTEM_READONLY | IsReadOnlyProperty (Wertsteuerelementmuster und RangeValue-Steuerelementmuster) | Nein |
| STATE_SYSTEM_UNAVAILABLE | IsEnabledProperty | Ja |
| STATE_SYSTEM_LINKED | ControlTypeProperty = "hyperlink" | Nein |
| STATE_SYSTEM_SELECTABLE | SelectionItemPattern wird unterstützt. | Nein |
| STATE_SYSTEM_SELECTED | IsSelectedProperty (SelectionItem-Steuerelementmuster) | Nein |
| STATE_SYSTEM_COLLAPSED | ExpandCollapseState = Collapsed | Ja |
| STATE_SYSTEM_EXPANDED | ExpandCollapseState = Expanded oder PartiallyExpanded | Ja |
| STATE_SYSTEM_HASPOPUP | Menüelemente, die Erweitern/Reduzieren unterstützen | Nein |
| STATE_SYSTEM_MIXED | ToggleState = Unbestimmt | Nein |
| STATE_SYSTEM_SIZEABLE | IUIAutomationTransformPattern::CanResize | Nein |
| STATE_SYSTEM_MOVEABLE | IUIAutomationTransformPattern::CanMove | Nein |
| STATE_SYSTEM_MULTISELECTABLE | IUIAutomationSelectionPattern::CanSelectMultiple | Nein |
Auswahl und Fokus
| IAccessible | Benutzeroberflächenautomatisierung |
|---|---|
| get_accFocus | IUIAutomation::FocusedElement |
| accSelect- | Weitere Informationen finden Sie in der Tabelle mit den Eigenschaften der Benutzeroberflächenautomatisierung und accSelect SELFLAGs. |
| get_accSelection | SelectionPattern::GetSelection |
Benutzeroberflächenautomatisierungs-Eigenschaften und accSelect SELFLAGs
| accSelect SELFLAGs | Benutzeroberflächenautomatisierungs-Eigenschaft |
|---|---|
| SELFLAG_NONE | Nicht verfügbar |
| SELFLAG_TAKFOCUS | IUIAutomationElement::SetFocus |
| SELFLAG_TAKESELECTION | IUIAutomationSelectionItemPattern::Select |
| SELFLAG_ADDSELECTION | IUIAutomationSelectionItemPattern::AddToSelection |
| SELFLAG_TAKEREMOVESELECTION | IUIAutomationSelectionItemPattern::RemoveFromSelection |
| SELFLAG_EXTENDSELECTION | Nicht verfügbar |
Räumliche Zuordnung
| IAccessible | Benutzeroberflächenautomatisierung |
|---|---|
| accLocation- | BoundingRectangleProperty |
| accHitTest- | IRawElementProviderFragmentRoot::ElementProviderFromPoint- |
Ereignisse
| System-Level-Ereigniskonstanten | Benutzeroberflächenautomatisierung |
|---|---|
| EVENT_SYSTEM_MENUPOPUPSTART | UIA_MenuOpenedEventId (Hinweis: Muss überprüfen, ob es sich um ein Popupfenster handelt.) |
| 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 | Nicht relevant |
| EVENT_SYSTEM_DRAGDROPSTART | |
| EVENT_SYSTEM_DRAGDROPEND | |
| EVENT_SYSTEM_SWITCHSTART | Nicht relevant |
| EVENT_SYSTEM_SWITCHEND | Nicht relevant |
| EVENT_SYSTEM_MINIMIZESTART | |
| EVENT_SYSTEM_MINIMIZEEND | |
| EVENT_SYSTEM_FOREGROUND | |
| EVENT_SYSTEM_SCROLLINGSTART | Nicht verfügbar |
| EVENT_SYSTEM_SCROLLINGEND | Nicht verfügbar |
| Object-Level-Ereigniskonstanten | Benutzeroberflächenautomatisierung |
|---|---|
| EVENT_OBJECT_FOCUS | AutomationFocusChangedEvent |
| EVENT_OBJECT_VALUECHANGE | ValueProperty (Wertsteuerelementmuster und RangeValue-Steuerelementmuster) |
| EVENT_OBJECT_SELECTION | ElementSelectedEvent (SelectionItem-Steuerelementmuster) |
| EVENT_OBJECT_SELECTIONADD | ElementAddedToSelectionEvent (SelectionItem-Steuerelementmuster) |
| EVENT_OBJECT_SELECTIONREMOVE | ElementRemovedFromSelectionEvent |
| EVENT_OBJECT_SELECTIONWITHIN | EventsSelectionInvalidatedEvent |
| EVENT_OBJECT_STATECHANGE | Siehe Ui Automation Properties and accState table for states that trigger a state change |