Interface IUIAutomation (uiautomationclient.h)

Expõe métodos que permitem que os aplicativos cliente do Microsoft Automação da Interface do Usuário descubram, acessem e filtrem elementos Automação da Interface do Usuário. Automação da Interface do Usuário expõe todos os elementos do Automação da Interface do Usuário como um objeto representado pela interface IUIAutomation. Os membros dessa interface não são específicos para um elemento específico.

Herança

A interface IUIAutomation herda da interface IUnknown . IUIAutomation também tem estes tipos de membros:

Métodos

A interface IUIAutomation tem esses métodos.

IUIAutomation::AddAutomationEventHandler Registra um método que manipula eventos do Microsoft Automação da Interface do Usuário. Observação Antes de implementar um manipulador de eventos, você deve estar familiarizado com os problemas de threading descritos em Noções básicas sobre problemas de threading.
IUIAutomation::AddFocusChangedEventHandler Registra um método que manipula eventos com foco alterado. Observação Antes de implementar um manipulador de eventos, você deve estar familiarizado com os problemas de threading descritos em Noções básicas sobre problemas de threading.
IUIAutomation::AddPropertyChangedEventHandler Registra um método que manipula e matriz de eventos alterados por propriedade.
IUIAutomation::AddPropertyChangedEventHandlerNativeArray Registra um método que manipula uma matriz nativa de eventos alterados por propriedade.
IUIAutomation::AddStructureChangedEventHandler Registra um método que manipula eventos alterados por estrutura. Observação Antes de implementar um manipulador de eventos, você deve estar familiarizado com os problemas de threading descritos em Noções básicas sobre problemas de threading.
IUIAutomation::CheckNotSupported Verifica um VARIANT fornecido para ver se ele contém o identificador Sem Suporte.
IUIAutomation::CompareElements Compara dois elementos Automação da Interface do Usuário para determinar se eles representam o mesmo elemento de interface do usuário subjacente.
IUIAutomation::CompareRuntimeIds Compara duas matrizes de inteiros que contêm IDs (identificadores de tempo de execução) para determinar se seu conteúdo é o mesmo e eles pertencem ao mesmo elemento de interface do usuário.
IUIAutomation::CreateAndCondition Cria uma condição que seleciona elementos que correspondem a ambas as condições.
IUIAutomation::CreateAndConditionFromArray Cria uma condição que seleciona elementos com base em várias condições, todas elas devem ser verdadeiras.
IUIAutomation::CreateAndConditionFromNativeArray Cria uma condição que seleciona elementos de uma matriz nativa, com base em várias condições que devem ser todas verdadeiras.
IUIAutomation::CreateCacheRequest Cria uma solicitação de cache.
IUIAutomation::CreateFalseCondition Cria uma condição que é sempre falsa.
IUIAutomation::CreateNotCondition Cria uma condição que é o negativo de uma condição especificada.
IUIAutomation::CreateOrCondition Cria uma combinação de duas condições em que uma correspondência existe se uma das condições for verdadeira.
IUIAutomation::CreateOrConditionFromArray Cria uma combinação de duas ou mais condições em que uma correspondência existe se qualquer uma das condições for verdadeira.
IUIAutomation::CreateOrConditionFromNativeArray Cria uma combinação de duas ou mais condições em que uma correspondência existe se qualquer uma das condições for verdadeira.
IUIAutomation::CreatePropertyCondition Cria uma condição que seleciona elementos que têm uma propriedade com o valor especificado.
IUIAutomation::CreatePropertyConditionEx Cria uma condição que seleciona elementos que têm uma propriedade com o valor especificado, usando sinalizadores opcionais.
IUIAutomation::CreateProxyFactoryEntry Cria uma nova instância de um objeto de fábrica de proxy.
IUIAutomation::CreateTreeWalker Recupera um objeto de andador de árvore que pode ser usado para percorrer a árvore do Microsoft Automação da Interface do Usuário.
IUIAutomation::CreateTrueCondition Recupera uma condição predefinida que seleciona todos os elementos.
IUIAutomation::ElementFromHandle Recupera um elemento Automação da Interface do Usuário para a janela especificada.
IUIAutomation::ElementFromHandleBuildCache Recupera um elemento Automação da Interface do Usuário para a janela especificada, pré-busca as propriedades solicitadas e os padrões de controle e armazena os itens pré-buscados no cache.
IUIAutomation::ElementFromIAccessible Recupera um elemento Automação da Interface do Usuário para o objeto acessível especificado de um servidor microsoft active accessibility.
IUIAutomation::ElementFromIAccessibleBuildCache Recupera um elemento Automação da Interface do Usuário para o objeto acessível especificado de um servidor microsoft Active Accessibility, pré-busca as propriedades solicitadas e padrões de controle e armazena os itens pré-buscados no cache.
IUIAutomation::ElementFromPoint Recupera o elemento Automação da Interface do Usuário no ponto especificado na área de trabalho.
IUIAutomation::ElementFromPointBuildCache Recupera o elemento Automação da Interface do Usuário no ponto especificado na área de trabalho, pré-busca as propriedades solicitadas e os padrões de controle e armazena os itens pré-buscados no cache.
IUIAutomation::get_ContentViewCondition Recupera uma interface IUIAutomationCondition predefinida que seleciona elementos de conteúdo.
IUIAutomation::get_ContentViewWalker Recupera uma interface IUIAutomationTreeWalker usada para descobrir elementos de conteúdo.
IUIAutomation::get_ControlViewCondition Recupera uma interface IUIAutomationCondition predefinida que seleciona elementos de controle.
IUIAutomation::get_ControlViewWalker Recupera uma interface IUIAutomationTreeWalker usada para descobrir elementos de controle.
IUIAutomation::get_ProxyFactoryMapping Recupera um objeto que representa o mapeamento de nomes de classe do Window e dados associados a fábricas de proxy individuais.
IUIAutomation::get_RawViewCondition Recupera uma interface IUIAutomationCondition predefinida que seleciona todos os elementos da interface do usuário em uma exibição não filtrada.
IUIAutomation::get_RawViewWalker Recupera um objeto de andador de árvore usado para percorrer uma exibição não filtrada da árvore do Microsoft Automação da Interface do Usuário.
IUIAutomation::get_ReservedMixedAttributeValue Recupera um objeto de token estático que representa um atributo de texto que é um atributo misto.
IUIAutomation::get_ReservedNotSupportedValue Recupera um objeto de token estático que representa uma propriedade ou atributo de texto que não tem suporte.
IUIAutomation::GetFocusedElement Recupera o elemento Automação da Interface do Usuário que tem o foco de entrada.
IUIAutomation::GetFocusedElementBuildCache Recupera o elemento Automação da Interface do Usuário que tem o foco de entrada, pré-busca as propriedades solicitadas e os padrões de controle e armazena os itens pré-buscados no cache.
IUIAutomation::GetPatternProgrammaticName Recupera o nome programático registrado de um padrão de controle.
IUIAutomation::GetPropertyProgrammaticName Recupera o nome programático registrado de uma propriedade.
IUIAutomation::GetRootElement Recupera o elemento Automação da Interface do Usuário que representa a área de trabalho.
IUIAutomation::GetRootElementBuildCache Recupera o elemento Automação da Interface do Usuário que representa a área de trabalho, pré-busca as propriedades solicitadas e os padrões de controle e armazena os itens pré-buscados no cache.
IUIAutomation::IntNativeArrayToSafeArray Converte uma matriz de inteiros em um SAFEARRAY.
IUIAutomation::IntSafeArrayToNativeArray Converte um SAFEARRAY de inteiros em uma matriz.
IUIAutomation::P ollForPotentialSupportedPatterns Recupera os padrões de controle que podem ter suporte em um elemento Automação da Interface do Usuário.
IUIAutomation::P ollForPotentialSupportedProperties Recupera as propriedades que podem ter suporte em um elemento Automação da Interface do Usuário.
IUIAutomation::RectToVariant Cria uma VARIANT que contém as coordenadas de um retângulo.
IUIAutomation::RemoveAllEventHandlers Remove todos os manipuladores de eventos do Microsoft Automação da Interface do Usuário registrados.
IUIAutomation::RemoveAutomationEventHandler Remove o manipulador de eventos Automação da Interface do Usuário especificado.
IUIAutomation::RemoveFocusChangedEventHandler Remove um manipulador de eventos com foco alterado.
IUIAutomation::RemovePropertyChangedEventHandler Remove um manipulador de eventos com alteração de propriedade.
IUIAutomation::RemoveStructureChangedEventHandler Remove um manipulador de eventos com alteração de estrutura.
IUIAutomation::SafeArrayToRectNativeArray Converte um SAFEARRAY que contém coordenadas de retângulo em uma matriz do tipo RECT.
IUIAutomation::VariantToRect Converte uma VARIANT que contém coordenadas de retângulo em um RECT.

Comentários

Cada aplicativo cliente Automação da Interface do Usuário deve obter essa interface para um objeto CUIAutomation para obter acesso à funcionalidade de Automação da Interface do Usuário.

A função de exemplo a seguir cria um objeto CUIAutomation e obtém a interface IUIAutomation .

IUIAutomation *g_pAutomation;

BOOL InitializeUIAutomation()
{
    CoInitialize(NULL);
    HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER, 
        __uuidof(IUIAutomation), (void**)&g_pAutomation);
    return (SUCCEEDED(hr));
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationclient.h (include UIAutomation.h)

Confira também

interfaces de elemento Automação da Interface do Usuário para clientes