Automação de Interface do usuário e Acessibilidade Microsoft Active
Observação
Esta documentação destina.Os desenvolvedores do NET Framework que desejam usar o gerenciado UI Automation classes definidas na System.Windows.Automation namespace.As informações mais recentes sobre UI Automation, consulte API de automação do Windows: Automação da interface do usuário.
Microsoft Active Accessibilityfoi a solução anterior para tornar os aplicativos acessíveis. Microsoft UI Automationé o novo modelo de acessibilidade para Microsoft Windows e destina-se para atender às necessidades de produtos de tecnologia assistencial e automatizada ferramentas de teste. UI Automationoferece vários aprimoramentos em Active Accessibility.
This topic includes the main features of UI Automation and explains how these features differ from Active Accessibility.
Este tópico contém as seguintes seções.
- Programming Languages
- Support in Windows Presentation Foundation
- Servers and Clients
- UI Elements
- Tree Views and Navigation
- Roles and Control Types
- States and Properties
- Events
- Security
- Tópicos relacionados
Programming Languages
Active Accessibility is based on the Component Object Model (COM) with support for dual interfaces, and is therefore programmable in C/C++, Microsoft Visual Basic 6.0, and scripting languages. UI Automation (including the client-side provider library for standard controls) is written in managed code, and UI Automation client applications are most easily programmed using Microsoft Visual C# or Microsoft Visual Basic .NET. UI Automation providers, which are interface implementations, can be written in managed code or in C/C++.
Support in Windows Presentation Foundation
Windows Presentation Foundation (WPF)é o novo modelo para criar interfaces do usuário. WPFelementos não contêm suporte nativo para Active Accessibility; No entanto, eles oferecem suporte a UI Automation, que inclui suporte para a ponte Active Accessibility clientes. Only clients written specifically for UI Automation can take full advantage of the accessibility features of WPF, such as the rich support for text.
Servers and Clients
In Active Accessibility, servers and clients communicate directly, largely through the server's implementation of IAccessible.
In UI Automation, a core service lies between the server (called a provider) and the client. The core service makes calls to the interfaces implemented by providers and provides additional services such as generating unique runtime identifiers for elements. Client applications use library functions to call the UI Automation service.
UI Automation providers can provide information to Active Accessibility clients, and Active Accessibility servers can provide information to UI Automation client applications. However, because Active Accessibility does not expose as much information as UI Automation, the two models are not fully compatible.
UI Elements
Active Accessibility presents UI elements either as an IAccessible interface or as a child identifier. It is difficult to compare two IAccessible pointers to determine if they refer to the same element.
In UI Automation, every element is represented as an AutomationElement object. Comparison is done by using the equality operator or the Equals method, both of which compare the unique runtime identifiers of the elements.
Tree Views and Navigation
The user interface (UI) elements on the screen can be seen as a tree structure with the desktop as the root, application windows as immediate children, and elements within applications as further descendants.
In Active Accessibility, many automation elements that are irrelevant to end users are exposed in the tree. Client applications have to look at all the elements to determine which are meaningful.
UI Automation client applications see the UI through a filtered view. O modo de exibição contém apenas os elementos de interesse: aqueles que fornecem informações para o usuário ou habilitar a interação. Exibições predefinidas de apenas os elementos de controle e somente os elementos de conteúdo estão disponíveis; Além disso, os aplicativos podem definir modos de exibição personalizados. UI Automationsimplifica a tarefa de descrever o UI para o usuário e ajudar o usuário interagir com o aplicativo.
Navigation between elements, in Active Accessibility, is either spatial (for example, moving to the element that lies to the left on the screen), logical (for example, moving to the next menu item, or the next item in the tab order within a dialog box), or hierarchical (for example, moving the first child in a container, or from the child to its parent). Hierarchical navigation is complicated by the fact that child elements are not always objects that implement IAccessible.
In UI Automation, all UI elements are AutomationElement objects that support the same basic functionality. (From the standpoint of the provider, they are objects that implement an interface inherited from IRawElementProviderSimple.) A navegação é principalmente hierárquica: de pais, filhos e para um irmão para a próxima. (Navigation between siblings has a logical element, as it may follow the tab order.) You can navigate from any starting-point, using any filtered view of the tree, by using the TreeWalker class. You can also navigate to particular children or descendants by using FindFirst and FindAll; for example, it is very easy to retrieve all elements within a dialog box that support a specified control pattern.
Navigation in UI Automation is more consistent than in Active Accessibility. Some elements such as drop-down lists and pop-up windows appear twice in the Active Accessibility tree, and navigation from them may have unexpected results. É realmente impossível implementar adequadamente Active Accessibility para um controle rebar. UI Automationpermite reparenting e reposicionamento, para que um elemento pode ser colocado em qualquer lugar na árvore de apesar da hierarquia imposta pela propriedade do windows.
Roles and Control Types
Active Accessibility uses the accRole property (IAccessible::get_actRole) to retrieve a description of the element's role in the UI, such as ROLE_SYSTEM_SLIDER or ROLE_SYSTEM_MENUITEM. The role of an element is the main clue to its available functionality. Interaction with a control is achieved by using fixed methods such as IAccessible::accSelect and IAccessible::accDoDefaultAction. The interaction between the client application and the UI is limited to what can be done through IAccessible.
In contrast, UI Automation largely decouples the control type of the element (described by the ControlType property) from its expected functionality. Functionality is determined by the control patterns that are supported by the provider through its implementation of specialized interfaces. Control patterns can be combined to describe the full set of functionality supported by a particular UI element. Some providers are required to support a particular control pattern; for example, the provider for a check box must support the Toggle control pattern. Other providers are required to support one or more of a set of control patterns; for example, a button must support either Toggle or Invoke. Still others support no control patterns at all; for example, a pane that cannot be moved, resized, or docked does not have any control patterns.
UI Automationoferece suporte a controles personalizados, que são identificados pela Custom propriedade e podem ser descritas as LocalizedControlTypeProperty propriedade.
The following table shows the mapping of Active Accessibility roles to UI Automation control types.
Active Accessibility role |
UI Automation control type |
|---|---|
ROLE_SYSTEM_PUSHBUTTON |
Button |
ROLE_SYSTEM_CLIENT |
Calendar |
ROLE_SYSTEM_CHECKBUTTON |
Check box |
ROLE_SYSTEM_COMBOBOX |
Combo box |
ROLE_SYSTEM_CLIENT |
Custom |
ROLE_SYSTEM_LIST |
Data grid |
ROLE_SYSTEM_LISTITEM |
Data item |
ROLE_SYSTEM_DOCUMENT |
Document |
ROLE_SYSTEM_TEXT |
Edit |
ROLE_SYSTEM_GROUPING |
Group |
ROLE_SYSTEM_LIST |
Header |
ROLE_SYSTEM_COLUMNHEADER |
Header item |
ROLE_SYSTEM_LINK |
Hyperlink |
ROLE_SYSTEM_GRAPHIC |
Image |
ROLE_SYSTEM_LIST |
List |
ROLE_SYSTEM_LISTITEM |
List item |
ROLE_SYSTEM_MENUPOPUP |
Menu |
ROLE_SYSTEM_MENUBAR |
Menu bar |
ROLE_SYSTEM_MENUITEM |
Menu item |
ROLE_SYSTEM_PANE |
Pane |
ROLE_SYSTEM_PROGRESSBAR |
Progress bar |
ROLE_SYSTEM_RADIOBUTTON |
Radio button |
ROLE_SYSTEM_SCROLLBAR |
Scroll bar |
ROLE_SYSTEM_SEPARATOR |
Separator |
ROLE_SYSTEM_SLIDER |
Slider |
ROLE_SYSTEM_SPINBUTTON |
Spinner |
ROLE_SYSTEM_SPLITBUTTON |
Split button |
ROLE_SYSTEM_STATUSBAR |
Status bar |
ROLE_SYSTEM_PAGETABLIST |
Tab |
ROLE_SYSTEM_PAGETAB |
Tab item |
ROLE_SYSTEM_TABLE |
Table |
ROLE_SYSTEM_STATICTEXT |
Text |
ROLE_SYSTEM_INDICATOR |
Thumb |
ROLE_SYSTEM_TITLEBAR |
Title bar |
ROLE_SYSTEM_TOOLBAR |
Tool bar |
ROLE_SYSTEM_TOOLTIP |
ToolTip |
ROLE_SYSTEM_OUTLINE |
Tree |
ROLE_SYSTEM_OUTLINEITEM |
Tree item |
ROLE_SYSTEM_WINDOW |
Window |
For more information about the different control types, see Tipos de controle de automação de interface do usuário.
States and Properties
In Active Accessibility, elements support a common set of properties, and some properties (such as accState) must describe very different things, depending on the element's role. Servers must implement all methods of IAccessible that return a property, even those that are not relevant to the element.
UI Automation defines many more properties, some of which correspond to states in Active Accessibility. Some are common to all elements, but others are specific to control types and control patterns. Properties are distinguished by unique identifiers, and most properties can be retrieved by using a single method, GetCurrentPropertyValue or GetCachedPropertyValue. Many properties are also easily retrievable from the Current and Cached property accessors.
A UI Automation provider does not have to implement irrelevant properties, but can simply return a null value for any properties it does not support. Also, the UI Automation core service can obtain some properties from the default window provider, and these are amalgamated with properties explicitly implemented by the provider.
As well as supporting many more properties, UI Automation supplies better performance by allowing multiple properties to be retrieved with a single cross-process call.
The following table shows the correspondence between properties in the two models.
Active Accessibility property accessor |
UI Automation property ID |
Remarks |
|---|---|---|
get_accKeyboardShortcut |
AccessKeyProperty takes precedence if both are present. |
|
get_accName |
|
|
get_accRole |
See the previous table for mapping of roles to control types. |
|
get_accValue |
Valid only for control types that support ValuePattern or RangeValuePattern. RangeValue values are normalized to 0-100, to be consistent with MSAA behavior. Value items use a string. |
|
get_accHelp |
||
accLocation |
||
get_accDescription |
Not supported in UI Automation |
accDescription did not have a clear specification within MSAA, which resulted in providers placing different pieces of information in this property. |
get_accHelpTopic |
Not supported in UI Automation |
The following table shows which UI Automation properties correspond to Active Accessibility state constants.
Active Accessibility state |
UI Automation property |
Triggers State Change? |
|---|---|---|
STATE_SYSTEM_CHECKED |
For check box, ToggleStateProperty For radio button, IsSelectedProperty |
Y |
STATE_SYSTEM_COLLAPSED |
Y |
|
STATE_SYSTEM_EXPANDED |
Y |
|
STATE_SYSTEM_FOCUSABLE |
N |
|
STATE_SYSTEM_FOCUSED |
N |
|
STATE_SYSTEM_HASPOPUP |
ExpandCollapsePattern for menu items |
N |
STATE_SYSTEM_INVISIBLE |
IsOffscreenProperty = True and GetClickablePoint causes NoClickablePointException |
N |
STATE_SYSTEM_LINKED |
N |
|
STATE_SYSTEM_MIXED |
N |
|
STATE_SYSTEM_MOVEABLE |
N |
|
STATE_SYSTEM_MUTLISELECTABLE |
N |
|
STATE_SYSTEM_OFFSCREEN |
IsOffscreenProperty = True |
N |
STATE_SYSTEM_PROTECTED |
N |
|
STATE_SYSTEM_READONLY |
RangeValuePattern.IsReadOnlyProperty and ValuePattern.IsReadOnlyProperty |
N |
STATE_SYSTEM_SELECTABLE |
SelectionItemPattern is supported |
N |
STATE_SYSTEM_SELECTED |
N |
|
STATE_SYSTEM_SIZEABLE |
N |
|
STATE_SYSTEM_UNAVAILABLE |
Y |
The following states either were not implemented by most Active Accessibility control servers or have no equivalent in UI Automation.
Active Accessibility state |
Remarks |
|---|---|
STATE_SYSTEM_BUSY |
Not available in UI Automation |
STATE_SYSTEM_DEFAULT |
Not available in UI Automation |
STATE_SYSTEM_ANIMATED |
Not available in UI Automation |
STATE_SYSTEM_EXTSELECTABLE |
Not widely implemented by Active Accessibility servers |
STATE_SYSTEM_MARQUEED |
Not widely implemented by Active Accessibility servers |
STATE_SYSTEM_SELFVOICING |
Not widely implemented by Active Accessibility servers |
STATE_SYSTEM_TRAVERSED |
Not available in UI Automation |
STATE_SYSTEM_ALERT_HIGH |
Not widely implemented by Active Accessibility servers |
STATE_SYSTEM_ALERT_MEDIUM |
Not widely implemented by Active Accessibility servers |
STATE_SYSTEM_ALERT_LOW |
Not widely implemented by Active Accessibility servers |
STATE_SYSTEM_FLOATING |
Not widely implemented by Active Accessibility servers |
STATE_SYSTEM_HOTTRACKED |
Not available in UI Automation |
STATE_SYSTEM_PRESSED |
Not available in UI Automation |
For a complete list of UI Automation property identifiers, see UI Automation Properties Overview.
Events
The event mechanism in UI Automation, unlike that in Active Accessibility, does not rely on Windows event routing (which is closely tied in with window handles) and does not require the client application to set up hooks. Subscriptions to events can be fine-tuned not just to particular events but to particular parts of the tree. Providers can also fine-tune their raising of events by keeping track of what events are being listened for.
It is also easier for clients to retrieve the elements that raise events, as these are passed directly to the event callback. Properties of the element are automatically prefetched if a cache request was active when the client subscribed to the event.
The following table shows the correspondence of Active Accessibility WinEvents and UI Automation events.
WinEvent |
UI Automation event identifier |
|---|---|
EVENT_OBJECT_ACCELERATORCHANGE |
AcceleratorKeyProperty property change |
EVENT_OBJECT_CONTENTSCROLLED |
VerticalScrollPercentProperty or HorizontalScrollPercentProperty property change on the associated scroll bars |
EVENT_OBJECT_CREATE |
|
EVENT_OBJECT_DEFACTIONCHANGE |
No equivalent |
EVENT_OBJECT_DESCRIPTIONCHANGE |
No exact equivalent; perhaps HelpTextProperty or LocalizedControlTypeProperty property change |
EVENT_OBJECT_DESTROY |
|
EVENT_OBJECT_FOCUS |
|
EVENT_OBJECT_HELPCHANGE |
HelpTextProperty change |
EVENT_OBJECT_HIDE |
|
EVENT_OBJECT_LOCATIONCHANGE |
BoundingRectangleProperty property change |
EVENT_OBJECT_NAMECHANGE |
NameProperty property change |
EVENT_OBJECT_PARENTCHANGE |
|
EVENT_OBJECT_REORDER |
Not consistently used in Active Accessibility. No directly corresponding event is defined in UI Automation. |
EVENT_OBJECT_SELECTION |
|
EVENT_OBJECT_SELECTIONADD |
|
EVENT_OBJECT_SELECTIONREMOVE |
|
EVENT_OBJECT_SELECTIONWITHIN |
No equivalent |
EVENT_OBJECT_SHOW |
|
EVENT_OBJECT_STATECHANGE |
Various property-changed events |
EVENT_OBJECT_VALUECHANGE |
RangeValuePattern.ValueProperty and ValuePattern.ValueProperty changed |
EVENT_SYSTEM_ALERT |
No equivalent |
EVENT_SYSTEM_CAPTUREEND |
No equivalent |
EVENT_SYSTEM_CAPTURESTART |
No equivalent |
EVENT_SYSTEM_CONTEXTHELPEND |
No equivalent |
EVENT_SYSTEM_CONTEXTHELPSTART |
No equivalent |
EVENT_SYSTEM_DIALOGEND |
|
EVENT_SYSTEM_DIALOGSTART |
|
EVENT_SYSTEM_DRAGDROPEND |
No equivalent |
EVENT_SYSTEM_DRAGDROPSTART |
No equivalent |
EVENT_SYSTEM_FOREGROUND |
|
EVENT_SYSTEM_MENUEND |
|
EVENT_SYSTEM_MENUPOPUPEND |
|
EVENT_SYSTEM_MENUPOPUPSTART |
|
EVENT_SYSTEM_MENUSTART |
|
EVENT_SYSTEM_MINIMIZEEND |
WindowVisualStateProperty property change |
EVENT_SYSTEM_MINIMIZESTART |
WindowVisualStateProperty property change |
EVENT_SYSTEM_MOVESIZEEND |
BoundingRectangleProperty property change |
EVENT_SYSTEM_MOVESIZESTART |
BoundingRectangleProperty property change |
EVENT_SYSTEM_SCROLLINGEND |
VerticalScrollPercentProperty or HorizontalScrollPercentProperty property change |
EVENT_SYSTEM_SCROLLINGSTART |
VerticalScrollPercentProperty or HorizontalScrollPercentProperty property change |
EVENT_SYSTEM_SOUND |
No equivalent |
EVENT_SYSTEM_SWITCHEND |
No equivalent, but an AutomationFocusChangedEvent event signals that a new application has received the focus |
EVENT_SYSTEM_SWITCHSTART |
No equivalent |
No equivalent |
CurrentViewProperty property change |
No equivalent |
HorizontallyScrollableProperty property change |
No equivalent |
VerticallyScrollableProperty property change |
No equivalent |
HorizontalScrollPercentProperty property change |
No equivalent |
VerticalScrollPercentProperty property change |
No equivalent |
HorizontalViewSizeProperty property change |
No equivalent |
VerticalViewSizeProperty property change |
No equivalent |
ToggleStateProperty property change |
No equivalent |
WindowVisualStateProperty property change |
No equivalent |
AsyncContentLoadedEvent event |
No equivalent |
Security
Some IAccessible customization scenarios require wrapping a base IAccessible and calling through to it. This has security implications, since a partially trusted component should not be an intermediary on a code path.
The UI Automation model removes the need for providers to call through to other provider code. The UI Automation core service does all the necessary aggregation.