Compartilhar via


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