Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Observação
Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.
O Microsoft Ative Accessibility era a solução anterior para tornar os aplicativos acessíveis. Microsoft UI Automation é o novo modelo de acessibilidade para o Microsoft Windows e destina-se a atender às necessidades de produtos de tecnologia assistiva e ferramentas de teste automatizado. A Automação da Interface do Usuário oferece muitas melhorias em relação à Acessibilidade Ativa.
Este tópico inclui os principais recursos da Automação da Interface do Usuário e explica como esses recursos diferem da Acessibilidade Ativa.
Linguagens de Programação
O Ative Accessibility é baseado no COM (Component Object Model) com suporte para interfaces duplas e, portanto, é programável em C/C++, Microsoft Visual Basic 6.0 e linguagens de script. A Automação da Interface do Usuário (incluindo a biblioteca do provedor do lado do cliente para controles padrão) é escrita em código gerenciado, e os aplicativos cliente da Automação da Interface do Usuário são mais facilmente programados usando C# ou Visual Basic .NET. Os provedores de automação da interface do usuário, que são implementações de interface, podem ser escritos em código gerenciado ou em C/C++.
Suporte na Windows Presentation Foundation
Windows Presentation Foundation (WPF) é o novo modelo para criar interfaces de usuário. Os elementos WPF não contêm suporte nativo para Acessibilidade Ativa; no entanto, eles suportam a automação da interface do usuário, que inclui suporte de ponte para clientes de acessibilidade ativa. Somente clientes escritos especificamente para automação da interface do usuário podem aproveitar ao máximo os recursos de acessibilidade do WPF, como o suporte avançado para texto.
Servidores e Clientes
Na Acessibilidade Ativa, servidores e clientes se comunicam diretamente, em grande parte através da implementação do IAccessible.
Na Automação da Interface do Usuário, um serviço principal fica entre o servidor (chamado de provedor) e o cliente. O serviço principal faz chamadas para as interfaces implementadas pelos provedores e fornece serviços adicionais, como a geração de identificadores de tempo de execução exclusivos para elementos. Os aplicativos cliente usam funções de biblioteca para chamar o serviço de Automação da Interface do Usuário.
Os provedores de Automação da Interface do Usuário podem fornecer informações para clientes de Acessibilidade Ativa e os servidores de Acessibilidade Ativa podem fornecer informações para aplicativos cliente de Automação da Interface do Usuário. No entanto, como o Ative Accessibility não expõe tantas informações quanto a Automação da Interface do Usuário, os dois modelos não são totalmente compatíveis.
Elementos da interface do usuário
Active Accessibility apresenta elementos da interface do utilizador como uma IAccessible interface ou como um identificador filho. É difícil comparar dois IAccessible ponteiros para determinar se se referem ao mesmo elemento.
Na automação da interface do usuário, cada elemento é representado como um AutomationElement objeto. A comparação é feita usando o operador de igualdade ou o Equals método, que comparam os identificadores de tempo de execução exclusivos dos elementos.
Vistas em árvore e navegação
Os elementos da interface do usuário (UI) na tela podem ser vistos como uma estrutura de árvore com a área de trabalho como a raiz, janelas de aplicativos como filhos imediatos e elementos dentro de aplicativos como descendentes adicionais.
Na Acessibilidade Ativa, muitos elementos de automação que são irrelevantes para os usuários finais são expostos na árvore. Os aplicativos cliente têm que examinar todos os elementos para determinar quais são significativos.
Os aplicativos cliente de Automação da Interface do Usuário veem a interface do usuário por meio de uma exibição filtrada. A vista contém apenas elementos de interesse: aqueles que dão informações ao utilizador ou permitem a interação. Visualizações predefinidas de apenas elementos de controle e apenas elementos de conteúdo estão disponíveis; Além disso, os aplicativos podem definir modos de exibição personalizados. A Automação da Interface do Usuário simplifica a tarefa de descrever a interface do usuário para o usuário e ajudá-lo a interagir com o aplicativo.
A navegação entre elementos, em Acessibilidade Ativa, é espacial (por exemplo, mover para o elemento que fica à esquerda na tela), lógica (por exemplo, mover para o próximo item de menu ou o próximo item na ordem de tabulação dentro de uma caixa de diálogo) ou hierárquica (por exemplo, mover o primeiro filho em um contêiner ou do filho para seu pai). A navegação hierárquica é complicada pelo facto de os elementos filho nem sempre serem objetos que implementam IAccessible.
Na Automação da Interface do Usuário, todos os elementos da interface do usuário são AutomationElement objetos que oferecem suporte à mesma funcionalidade básica. (Do ponto de vista do provedor, eles são objetos que implementam uma interface herdada de IRawElementProviderSimple.) A navegação é principalmente hierárquica: de pais para filhos e de um irmão para o outro. (A navegação entre irmãos tem um elemento lógico, pois pode seguir a ordem de tabulação.) Você pode navegar a partir de qualquer ponto inicial, usando qualquer exibição filtrada da árvore, usando a TreeWalker classe. Você também pode navegar para filhos ou descendentes específicos usando FindFirst e FindAll, por exemplo, é muito fácil recuperar todos os elementos dentro de uma caixa de diálogo que suportam um padrão de controle especificado.
A navegação na Automação da Interface do Usuário é mais consistente do que na Acessibilidade Ativa. Alguns elementos, como listas suspensas e janelas pop-up, aparecem duas vezes na árvore de Acessibilidade Ativa, e a navegação a partir deles pode ter resultados inesperados. Na verdade, é impossível implementar corretamente a Acessibilidade Ativa para um controle de vergalhão. A automação da interface do usuário permite a reparentação e o reposicionamento, para que um elemento possa ser colocado em qualquer lugar da árvore, apesar da hierarquia imposta pela propriedade das janelas.
Funções e tipos de controle
A Acessibilidade Ativa usa a accRole propriedade (IAccessible::get_actRole) para recuperar uma descrição da função do elemento na interface do usuário, como ROLE_SYSTEM_SLIDER ou ROLE_SYSTEM_MENUITEM. O papel de um elemento é a principal pista para sua funcionalidade disponível. A interação com um controlo é conseguida através da utilização de métodos fixos, tais como IAccessible::accSelect e IAccessible::accDoDefaultAction. A interação entre o aplicativo cliente e a interface do usuário é limitada ao que pode ser feito através do IAccessible.
Por outro lado, a Automação da Interface de Utilizador desacopla amplamente o tipo de controlo do elemento (descrito pela propriedade ControlType) da sua funcionalidade esperada. A funcionalidade é determinada pelos padrões de controle que são suportados pelo provedor através de sua implementação de interfaces especializadas. Os padrões de controle podem ser combinados para descrever o conjunto completo de funcionalidades suportadas por um elemento específico da interface do usuário. Alguns fornecedores são obrigados a suportar um determinado padrão de controlo; por exemplo, o provedor de uma caixa de seleção deve oferecer suporte ao padrão de controle Toggle. Outros fornecedores são obrigados a suportar um ou mais padrões de controlo; por exemplo, um botão deve suportar Alternar ou Invocar. Outros ainda não suportam padrões de controle; Por exemplo, um painel que não pode ser movido, redimensionado ou encaixado não tem nenhum padrão de controle.
a automação da Interface de Custom Usuário oferece suporte a controles personalizados, que são identificados pela propriedade Custom e podem ser descritos pela propriedade .
A tabela a seguir mostra o mapeamento de funções de Acessibilidade Ativa para tipos de controle de Automação da Interface do Usuário.
| Função Acessibilidade Ativa | Tipo de controle de automação da interface do usuário |
|---|---|
| BOTÃO_DO_SISTEMA | Botão |
| CLIENTE_DO_SISTEMA | Calendário |
| ROLE_SISTEMA_BOTÃO_DE_SELEÇÃO | Caixa de verificação |
| Função_Sistema_Caixa_Combinação | Caixa de combinação |
| CLIENTE_DO_SISTEMA | Personalizado |
| LISTA_DO_SISTEMA_FUNÇÃO | Grelha de dados |
| FUNÇÃO_SISTEMA_ITEMDELISTA | Item de dados |
| DOCUMENTO_DO_SISTEMA_FUNÇÃO | Documento |
| TEXTO_DE_FUNÇÃO_SISTEMA | Editar |
| AGRUPAMENTO_DO_SISTEMA | Grupo |
| LISTA_DO_SISTEMA_FUNÇÃO | Cabeçalho |
| CABECALHO_DE_COLUNA_DO_SISTEMA | Item de cabeçalho |
| LIGAÇÃO_DO_SISTEMA | Hiperligação |
| PAPEL_SISTEMA_GRÁFICO | Imagem |
| LISTA_DO_SISTEMA_FUNÇÃO | Lista |
| FUNÇÃO_SISTEMA_ITEMDELISTA | Item de lista |
| ROLE_SYSTEM_MENUPOPUP | Cardápio |
| ROLE_SYSTEM_MENUBAR | Barra de menus |
| ROLE_SYSTEM_MENUITEM | Item de menu |
| Função_Sistema_Área | Painel |
| ROLE_SYSTEM_PROGRESSBAR | Barra de progresso |
| BOTÃO_DE_OPÇÃO_SISTEMA | Botão de opção |
| ROLE_SYSTEM_SCROLLBAR | Barra de rolagem |
| PAPEL_SISTEMA_SEPARADOR | Separador |
| Controlador de Deslizante do Sistema | Controle deslizante |
| BOTÃO_DE_ROTAÇÃO_SISTEMA | Ícone de Progresso |
| Botão de Divisão do Sistema | Botão Dividir |
| ROLE_SYSTEM_STATUSBAR | Barra de status |
| ROLE_SYSTEM_PAGETABLIST | Separador |
| ROLE_SYSTEM_PAGETAB | Item de tabulação |
| TABELA_DE_SISTEMA_FUNÇÃO | Tabela |
| TEXTO_ESTÁTICO_DO_SISTEMA | Texto |
| FUNÇÃO_INDICADOR_SISTEMA | Polegar |
| BARRA_DE_TÍTULO_SISTEMA | Barra de título |
| FUNÇÃO_SISTEMA_BARRA_DE_FERRAMENTAS | Barra de ferramentas |
| DESCRIÇÃO_POPUP_DO_SISTEMA | Dica de ferramenta |
| ESQUEMA_DO_SISTEMA | Árvore |
| ITEM_DE_RESUMO_DO_SISTEMA | Item de árvore |
| FUNÇÃO_SISTEMA_JANELA | Janela |
Para obter mais informações sobre os diferentes tipos de controle, consulte Tipos de controle de automação da interface do usuário.
Estados e Propriedades
Na Acessibilidade Ativa, os elementos suportam um conjunto comum de propriedades, e algumas propriedades (como accState) devem descrever coisas muito diferentes, dependendo da função do elemento. Os servidores devem implementar todos os métodos IAccessible que retornam uma propriedade, mesmo aqueles que não são relevantes para o elemento .
A Automação da Interface do Usuário define muito mais propriedades, algumas das quais correspondem a estados em Acessibilidade Ativa. Alguns são comuns a todos os elementos, mas outros são específicos para tipos de controle e padrões de controle. As propriedades são distinguidas por identificadores exclusivos, e a maioria das propriedades pode ser recuperada usando um único método GetCurrentPropertyValue ou GetCachedPropertyValue. Muitas propriedades também são facilmente recuperáveis a partir dos acessores Current e Cached.
Um provedor de Automação da Interface do Usuário não precisa implementar propriedades irrelevantes, mas pode simplesmente retornar um null valor para quaisquer propriedades às quais não oferece suporte. Além disso, o serviço principal de Automação da Interface do Usuário pode obter algumas propriedades do provedor de janela padrão, e elas são amalgamadas com propriedades explicitamente implementadas pelo provedor.
Além de oferecer suporte a muito mais propriedades, a Automação da Interface do Usuário oferece melhor desempenho, permitindo que várias propriedades sejam recuperadas com uma única chamada entre processos.
A tabela a seguir mostra a correspondência entre as propriedades nos dois modelos.
| Acessador de propriedade de Acessibilidade Ativa | ID da propriedade de Automação da Interface do Usuário | Observações |
|---|---|---|
get_accKeyboardShortcut |
AccessKeyProperty ou AcceleratorKeyProperty |
AccessKeyProperty tem precedência se ambos estiverem presentes. |
get_accName |
NameProperty | |
get_accRole |
ControlTypeProperty | Consulte a tabela anterior para obter o mapeamento de funções para tipos de controle. |
get_accValue |
ValuePattern.ValueProperty RangeValuePattern.ValueProperty |
Válido apenas para tipos de controle que suportam ValuePattern ou RangeValuePattern. Os valores de RangeValue são normalizados para 0-100, para serem consistentes com o comportamento do MSAA. Os itens de valor usam uma cadeia de caracteres. |
get_accHelp |
HelpTextProperty | |
accLocation |
BoundingRectangleProperty | |
get_accDescription |
Não é suportado na UI Automation |
accDescription não tinham uma especificação clara dentro da MSAA, o que resultou em provedores colocando diferentes informações nesta propriedade. |
get_accHelpTopic |
Não é suportado na UI Automation |
A tabela a seguir mostra quais propriedades de Automação da Interface do Usuário correspondem às constantes de estado de Acessibilidade Ativa.
| Estado de Acessibilidade Ativa | Propriedade de automação da interface do usuário | Aciona a mudança de estado? |
|---|---|---|
| ESTADO_SISTEMA_VERIFICADO | Para a caixa de seleção, ToggleStateProperty Para o botão de opção, IsSelectedProperty |
Y |
| ESTADO_SISTEMA_COLAPSADO | ExpandCollapseState = Collapsed | Y |
| ESTADO_SISTEMA_EXPANDIDO | ExpandCollapseState = Expanded ou PartiallyExpanded | Y |
| ESTADO_SISTEMA_FOCÁVEL | IsKeyboardFocusableProperty | N |
| ESTADO_SISTEMA_FOCALIZADO | HasKeyboardFocusProperty | N |
| STATE_SYSTEM_HASPOPUP | ExpandCollapsePattern para itens de menu | N |
| ESTADO_SISTEMA_INVISÍVEL | IsOffscreenProperty = Verdadeiro e GetClickablePoint causa NoClickablePointException | N |
| SISTEMA_LIGADO_AO_ESTADO | ControlTypeProperty = Hyperlink |
N |
| Estado_Sistema_Misto | ToggleState = Indeterminate | N |
| ESTADO_SISTEMA_MÓVEL | CanMoveProperty | N |
| STATE_SYSTEM_MULTISELECTABLE | CanSelectMultipleProperty | N |
| STATE_SYSTEM_OFFSCREEN | IsOffscreenProperty = Verdadeiro | N |
| SISTEMA_EM_ESTADO_PROTEGIDO | IsPasswordProperty | N |
| ESTADO_SISTEMA_SOMENTE_LEITURA | RangeValuePattern.IsReadOnlyProperty e ValuePattern.IsReadOnlyProperty | N |
| ESTADO_SISTEMA_SELECIONÁVEL | SelectionItemPattern é suportado | N |
| ESTADO_SISTEMA_SELECIONADO | IsSelectedProperty | N |
| Estado do Sistema Redimensionável | CanResize | N |
| ESTADO_DO_SISTEMA_INDISPONÍVEL | IsEnabledProperty | Y |
Os estados a seguir não foram implementados pela maioria dos servidores de controle de Acessibilidade Ativa ou não têm equivalente na Automação da Interface do Usuário.
| Estado de Acessibilidade Ativa | Observações |
|---|---|
| ESTADO_SISTEMA_OCUPADO | Não disponível em UI Automation |
| ESTADO_SISTEMA_PADRÃO | Não disponível em UI Automation |
| ESTADO_SISTEMA_ANIMADO | Não disponível em UI Automation |
| STATE_SYSTEM_EXTSELECTABLE | Não amplamente implementado por servidores de Acessibilidade Ativa |
| STATE_SYSTEM_MARQUEED | Não amplamente implementado por servidores de Acessibilidade Ativa |
| ESTADO_SISTEMA_AUTOLOCUÇÃO | Não amplamente implementado por servidores de Acessibilidade Ativa |
| Estado do Sistema Atravessado | Não disponível em UI Automation |
| ALERTA_DE_SISTEMA_ELEVADO | Não amplamente implementado por servidores de Acessibilidade Ativa |
| ESTADO_SISTEMA_ALERTA_MÉDIO | Não amplamente implementado por servidores de Acessibilidade Ativa |
| ESTADO_SISTEMA_ALERTA_BAIXO | Não amplamente implementado por servidores de Acessibilidade Ativa |
| ESTADO_SISTEMA_FLUTUANTE | Não amplamente implementado por servidores de Acessibilidade Ativa |
| Estado_Sistema_RastreadorAquecido | Não disponível em UI Automation |
| ESTADO_SISTEMA_PRESSIONADO | Não disponível em UI Automation |
Para obter uma lista completa dos identificadores de propriedade de Automação da Interface do Usuário, consulte Visão geral das propriedades de Automação da Interface do Usuário.
Eventos
O mecanismo de eventos na Automação da Interface do Usuário, ao contrário do da Acessibilidade Ativa, não depende do roteamento de eventos do Windows (que está intimamente ligado aos identificadores de janela) e não requer que o aplicativo cliente configure ganchos. As subscrições de eventos podem ser ajustadas não apenas a eventos específicos, mas a partes específicas da árvore. Os fornecedores também podem ajustar a sua angariação de eventos, acompanhando os eventos que estão a ser ouvidos.
Também é mais fácil aos clientes recuperar os elementos que geram eventos, pois eles são passados diretamente para o callback do evento. As propriedades do elemento são automaticamente pré-buscadas se uma solicitação de cache estava ativa quando o cliente se inscreveu no evento.
A tabela a seguir mostra a correspondência entre os eventos WinEvents de Acessibilidade Ativa e os eventos de Automação da Interface do Utilizador.
| WinEvent | Identificador de evento de automação da interface do usuário |
|---|---|
| EVENT_OBJECT_ACCELERATORCHANGE | AcceleratorKeyProperty mudança de propriedade |
| EVENT_OBJECT_CONTEÚDOROLADO | Alteração de propriedade de VerticalScrollPercentProperty ou HorizontalScrollPercentProperty nas barras de rolagem associadas |
| EVENT_OBJECT_CREATE | StructureChangedEvent |
| EVENT_OBJECT_DEFACTIONCHANGE | Sem equivalente |
| Mudança na Descrição do Objeto (EVENT_OBJECT_DESCRIPTIONCHANGE) | Nenhum equivalente exato; talvez mudança de propriedade HelpTextProperty ou LocalizedControlTypeProperty |
| EVENTO_OBJETO_DESTRUIR (EVENT_OBJECT_DESTROY) | StructureChangedEvent |
| Foco do Objeto de Evento | AutomationFocusChangedEvent |
| EVENT_OBJECT_ALTERAÇÃO_DE_AJUDA | HelpTextProperty alteração |
| Evento_Objecto_Ocultar | StructureChangedEvent |
| EVENT_OBJECT_LOCATIONCHANGE | BoundingRectangleProperty mudança de propriedade |
| EVENTO_OBJETO_ALTERAÇÃODENOME | NameProperty mudança de propriedade |
| ALTERAÇÃO_DO_OBJETO_MÃE | StructureChangedEvent |
| EVENTO_OBJETO_REORDENAR | Não é usado consistentemente na Acessibilidade Ativa. Nenhum evento correspondente diretamente é definido na Automação da Interface do Usuário. |
| SELEÇÃO_DE_OBJETO_DO_EVENTO | ElementSelectedEvent |
| EVENT_OBJECT_SELECTIONADD | ElementAddedToSelectionEvent |
| EVENTO_OBJECTO_SELEÇÃO_REMOVER | ElementRemovedFromSelectionEvent |
| EVENTO_OBJETO_SELECAO_INTERNA | Sem equivalente |
| EVENTO_OBJETO_MOSTRAR | StructureChangedEvent |
| EVENT_OBJECT_STATECHANGE | Vários eventos de mudança de propriedade |
| ALTERAÇÃO_DO_VALOR_DO_OBJETO | RangeValuePattern.ValueProperty e ValuePattern.ValueProperty mudaram |
| ALERTA_DO_SISTEMA_EVENTO | Sem equivalente |
| EVENT_SYSTEM_CAPTUREEND | Sem equivalente |
| EVENT_SYSTEM_CAPTURESTART | Sem equivalente |
| EVENTO_SISTEMA_AJUDA_CONTEXTUAL_TERMINO | Sem equivalente |
| EVENT_SYSTEM_CONTEXTHELPSTART | Sem equivalente |
| EVENT_SYSTEM_DIALOGEND | WindowClosedEvent |
| EVENT_SYSTEM_DIALOGSTART | WindowOpenedEvent |
| EVENTO_SISTEMA_FIM_ARRASTAR_SOLTAR | Sem equivalente |
| EVENT_SYSTEM_DRAGDROPSTART | Sem equivalente |
| Evento_Sistema_Primeiro_Plano | AutomationFocusChangedEvent |
| EVENT_SYSTEM_MENUEND | MenuClosedEvent |
| EVENT_SYSTEM_MENUPOPUPEND | MenuClosedEvent |
| EVENT_SYSTEM_MENUPOPUPSTART | MenuOpenedEvent |
| EVENTO_SISTEMA_INICIO_MENU | MenuOpenedEvent |
| EVENT_SYSTEM_MINIMIZEEND | WindowVisualStateProperty mudança de propriedade |
| EVENT_SYSTEM_MINIMIZESTART | WindowVisualStateProperty mudança de propriedade |
| EVENTO_SISTEMA_MOVETAMANHOFIM | BoundingRectangleProperty mudança de propriedade |
| EVENT_SYSTEM_MOVESIZESTART | BoundingRectangleProperty mudança de propriedade |
| EVENTO_SISTEMA_FIM_DE_SCROLL | VerticalScrollPercentProperty ou HorizontalScrollPercentProperty mudança de propriedade |
| EVENTO_SISTEMA_INÍCIO_DE_SCROLLING | VerticalScrollPercentProperty ou HorizontalScrollPercentProperty mudança de propriedade |
| EVENT_SYSTEM_SOUND | Sem equivalente |
| EVENT_SYSTEM_SWITCHEND | Não há equivalente, mas um AutomationFocusChangedEvent evento sinaliza que um novo aplicativo recebeu o foco |
| EVENTO_SISTEMA_INICIOTROCA | Sem equivalente |
| Sem equivalente | CurrentViewProperty mudança de propriedade |
| Sem equivalente | HorizontallyScrollableProperty mudança de propriedade |
| Sem equivalente | VerticallyScrollableProperty mudança de propriedade |
| Sem equivalente | HorizontalScrollPercentProperty mudança de propriedade |
| Sem equivalente | VerticalScrollPercentProperty mudança de propriedade |
| Sem equivalente | HorizontalViewSizeProperty mudança de propriedade |
| Sem equivalente | VerticalViewSizeProperty mudança de propriedade |
| Sem equivalente | ToggleStateProperty mudança de propriedade |
| Sem equivalente | WindowVisualStateProperty mudança de propriedade |
| Sem equivalente | evento AsyncContentLoadedEvent |
| Sem equivalente | ToolTipOpenedEvent |
Segurança
Alguns IAccessible cenários de personalização exigem envolver uma base IAccessible e recorrer a ela. Isso tem implicações de segurança, uma vez que um componente parcialmente confiável não deve ser um intermediário em um caminho de código.
O modelo de automação da interface do usuário elimina a necessidade de os provedores ligarem para outro código de provedor. O serviço principal de Automação da Interface do Usuário faz toda a agregação necessária.