Příloha G: Aktivní přemostění přístupnosti na automatizaci uživatelského rozhraní

Tento dodatek obsahuje informace o mostu Microsoft Active Accessibility Bridge. Most aktivní přístupnosti umožňuje aplikacím, které implementují microsoft Active Accessibility, přístup k aplikacím, které implementují Microsoft UI Automation. Přemostěním microsoft Active Accessibility a automatizace uživatelského rozhraní společně můžou klienti založené na technologii Microsoft Active Accessibility, jako je čtečka obrazovky ve Windows XP, programově pracovat s poskytovateli automatizace uživatelského rozhraní, jako je například aplikace WPF (Windows Presentation Foundation). Je součástí nativního základního rozhraní API pro automatizaci uživatelského rozhraní (UIAutomationCore.dll).

Most aktivní přístupnosti mapuje vlastnosti a události automatizace uživatelského rozhraní na události microsoft Active Accessibility. Následující tabulky mapuje metody a vlastnosti rozhraní Microsoft Active Accessibility IAccessible pro automatizaci uživatelského rozhraní. Pomocí těchto tabulek můžete určit vhodné postupy kódování pro vývoj klienta založeného na microsoft Active Accessibility.

Vlastnosti navigace a hierarchie

Vlastnost IAccessible	Vlastnost Automatizace uživatelského rozhraní
get_accChild	Neimplementované
get_accChildCount	Odvozeno ze stromu automatizace uživatelského rozhraní
get_accParent	Odvozeno ze stromu automatizace uživatelského rozhraní
accNavigate	Neimplementované

 

Popisné vlastnosti a metody

Nepřístupný	Automatizace uživatelského rozhraní
accDoDefaultAction	Podrobnosti najdete v tabulce Typy ovládacích prvků a accRole.
get_accDefaultAction	Podrobnosti najdete v tabulce Typy ovládacích prvků a accRole.
get_accKeyboardShortcut	AccessKeyPropertyor AcceleratorKeyProperty; Pokud jsou obě přítomny, má přednost AccessKeyProperty.
get_accName	NameProperty
get_accRole	ControlTypeProperty. Podrobnosti najdete v tabulce Typy ovládacích prvků a accRole.
get_accState	Podrobnosti najdete v tabulce Typy ovládacích prvků a accRole.
get_accValue	ValueProperty; podporované u typů ovládacích prvků, které podporují vzor ovládacích prvků Hodnota nebo RangeValue vzor ovládacího vzoru ovládacího prvku. Hodnoty RangeValue jsou konzistentní s chováním Microsoft Active Accessibility (0 až 100). Položky hodnot používají řetězec.
put_accValue	ValueProperty; podporováno u typů ovládacích prvků, které podporují vzor ovládacích prvků Hodnota nebo RangeValue vzor ovládacího prvku
get_accHelp	HelpTextProperty
get_accDescription	Neimplementované
get_accHelpTopic	Neimplementované

 

Typy ovládacích prvků a accRole

Výchozí role Microsoft Active Accessibility je ROLE_SYSTEM_CLIENT. Pokud se pro typ ovládacího prvku nenajde žádná výchozí akce, most pro usnadnění přístupu bude také používat následující dostupné vzory ovládacích prvků: Vyvolat, ExpandCollapsea Přepnout. Například ovládací prvek groupbox nemá žádnou výchozí akci. Pokud podporuje rozšíření ExpandCollapse, použije se pro výchozí akci most pro aktivní přístupnost.

Typ ovládacího prvku Automatizace uživatelského rozhraní	accRole	Výchozí akce
tlačítka	ROLE_SYSTEM_PUSHBUTTON	Tisk
kalendář	ROLE_SYSTEM_CLIENT	Žádný
CheckBox	ROLE_SYSTEM_CHECKBUTTON	Zaškrtnutí nebo zrušení zaškrtnutí (přepínač)
pole se seznamem	ROLE_SYSTEM_COMBOBOX	Žádný
Zvyk	ROLE_SYSTEM_CLIENT	Žádný
DataGrid	ROLE_SYSTEM_LIST	Žádný
dataItem	ROLE_SYSTEM_LISTITEM	Žádný
dokumentu	ROLE_SYSTEM_DOCUMENT	Žádný
Upravit	ROLE_SYSTEM_TEXT	Žádný
skupiny	ROLE_SYSTEM_GROUPING	Žádný
záhlaví	ROLE_SYSTEM_LIST	Žádný
headerItem	ROLE_SYSTEM_COLUMNHEADER	Kliknout
hypertextového odkazu	ROLE_SYSTEM_LINK	Přeskakování (mapy k vyvolání)
obrázku	ROLE_SYSTEM_GRAPHIC	Žádný
seznamu	ROLE_SYSTEM_LIST	Žádný
ListItem	ROLE_SYSTEM_LISTITEM	Poklikejte na
nabídky	ROLE_SYSTEM_MENUPOPUP	Žádný
řádku nabídek	ROLE_SYSTEM_MENUBAR	Žádný
MenuItem	ROLE_SYSTEM_MENUITEM	U položek nabídky, které mají podřízené položky, spusťte nebo otevřete/zavřít.
podokna	ROLE_SYSTEM_PANE	Žádný
progressbar	ROLE_SYSTEM_PROGRESSBAR	Žádný
RadioButton	ROLE_SYSTEM_RADIOBUTTON	Kontrolovat
posuvníku	ROLE_SYSTEM_SCROLLBAR	Žádný
posuvníku	ROLE_SYSTEM_SLIDER	Žádný
číselníku	ROLE_SYSTEM_SPINBUTTON	Žádný
SplitButton	ROLE_SYSTEM_SPLITBUTTON	Žádný
stavový řádek	ROLE_SYSTEM_STATUSBAR	Žádný
tabulátoru	ROLE_SYSTEM_PAGETABLIST	Žádný
TabItem	ROLE_SYSTEM_PAGETAB	Vypínač
tabulky	ROLE_SYSTEM_TABLE	Žádný
textové	ROLE_SYSTEM_STATICTEXT	Žádný
palec	ROLE_SYSTEM_INDICATOR	Žádný
záhlaví	ROLE_SYSTEM_TITLEBAR	Žádný
ToolBar	ROLE_SYSTEM_TOOLBAR	Žádný
popis	ROLE_SYSTEM_TOOLTIP	Žádný
stromové	ROLE_SYSTEM_OUTLINE	Žádný
treeItem	ROLE_SYSTEM_OUTLINEITEM	Rozbalení nebo sbalení
okna	ROLE_SYSTEM_WINDOW	Žádný

 

Vlastnosti a accState automatizace uživatelského rozhraní

accState	Vlastnost Automatizace uživatelského rozhraní	Změna stavu triggerů
STATE_SYSTEM_CHECKED	Pro ControlType = "checkbox" použijte ToggleState.On. Pro přepínač použijte SelectionItemPattern::IsSelected	Ano
STATE_SYSTEM_FOCUSABLE	IsKeyboardFocusableProperty	Ne
STATE_SYSTEM_FOCUSED	HasKeyboardFocusProperty	Ne
STATE_SYSTEM_PROTECTED	IsPasswordProperty	Ne
STATE_SYSTEM_READONLY	IsReadOnlyProperty (vzor ovládacích prvků hodnot a vzor ovládacího prvku RangeValue)	Ne
STATE_SYSTEM_UNAVAILABLE	IsEnabledProperty	Ano
STATE_SYSTEM_LINKED	ControlTypeProperty = "hypertextový odkaz"	Ne
STATE_SYSTEM_SELECTABLE	Podporuje se selectionItemPattern.	Ne
STATE_SYSTEM_SELECTED	IsSelectedProperty (vzor ovládacího prvku SelectionItem)	Ne
STATE_SYSTEM_COLLAPSED	ExpandCollapseState = Sbalené	Ano
STATE_SYSTEM_EXPANDED	ExpandCollapseState = Expanded nebo PartiallyExpanded	Ano
STATE_SYSTEM_HASPOPUP	Položky nabídky, které podporují rozbalení nebo sbalení	Ne
STATE_SYSTEM_MIXED	ToggleState = neurčitá	Ne
STATE_SYSTEM_SIZEABLE	IUIAutomationTransformPattern::CanResize	Ne
STATE_SYSTEM_MOVEABLE	IUIAutomationTransformPattern::CanMove	Ne
STATE_SYSTEM_MULTISELECTABLE	IUIAutomationSelectionPattern::CanSelectMultiple	Ne

 

Výběr a fokus

Nepřístupný	Automatizace uživatelského rozhraní
get_accFocus	IUIAutomation::FocusedElement
accSelect	Podrobnosti najdete v tabulce Vlastnosti automatizace uživatelského rozhraní a accSelect SELFLAG.
get_accSelection	SelectionPattern::GetSelection

 

Vlastnosti automatizace uživatelského rozhraní a akceSelect SELFLAG

accSelect SELFLAG	Vlastnost Automatizace uživatelského rozhraní
SELFLAG_NONE	Není k dispozici
SELFLAG_TAKFOCUS	IUIAutomationElement::SetFocus
SELFLAG_TAKESELECTION	IUIAutomationSelectionItemPattern::Select
SELFLAG_ADDSELECTION	IUIAutomationSelectionItemPattern::AddToSelection
SELFLAG_TAKEREMOVESELECTION	IUIAutomationSelectionItemPattern::RemoveFromSelection
SELFLAG_EXTENDSELECTION	Není k dispozici

 

Prostorové mapování

Nepřístupný	Automatizace uživatelského rozhraní
accLocation	OhraničujícíRectangleProperty
accHitTest	IRawElementProviderFragmentRoot::ElementProviderFromPoint

 

Dění

konstanty událostí System-Level	Automatizace uživatelského rozhraní
EVENT_SYSTEM_MENUPOPUPSTART	UIA_MenuOpenedEventId (Poznámka: Je nutné zkontrolovat, jestli se jedná o automaticky otevírané okno.)
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	Není relevantní
EVENT_SYSTEM_DRAGDROPSTART
EVENT_SYSTEM_DRAGDROPEND
EVENT_SYSTEM_SWITCHSTART	Není relevantní
EVENT_SYSTEM_SWITCHEND	Není relevantní
EVENT_SYSTEM_MINIMIZESTART
EVENT_SYSTEM_MINIMIZEEND
EVENT_SYSTEM_FOREGROUND
EVENT_SYSTEM_SCROLLINGSTART	Není k dispozici
EVENT_SYSTEM_SCROLLINGEND	Není k dispozici

 

konstanty událostí Object-Level	Automatizace uživatelského rozhraní
EVENT_OBJECT_FOCUS	AutomationFocusChangedEvent
EVENT_OBJECT_VALUECHANGE	ValueProperty (vzor ovládacího prvku hodnoty a vzor ovládacího prvku RangeValue)
EVENT_OBJECT_SELECTION	ElementSelectedEvent (vzor ovládacího prvku SelectionItem)
EVENT_OBJECT_SELECTIONADD	ElementAddedToSelectionEvent (vzor ovládacího prvku SelectionItem)
EVENT_OBJECT_SELECTIONREMOVE	ElementRemovedFromSelectionEvent
EVENT_OBJECT_SELECTIONWITHIN	EventsSelectionInvalidatedEvent
EVENT_OBJECT_STATECHANGE	Zobrazení vlastností automatizace uživatelského rozhraní a tabulky accState pro stavy, které aktivují změnu stavu