Método IUIAutomation::ElementFromIAccessibleBuildCache (uiautomationclient.h)

Recupera um elemento de 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.

Sintaxe

HRESULT ElementFromIAccessibleBuildCache(
  [in]          IAccessible               *accessible,
  [in]          int                       childId,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **element
);

Parâmetros

[in] accessible

Tipo: IAccessible*

Um ponteiro para a interface IAccessible do objeto acessível.

[in] childId

Tipo: int

A ID filho do objeto acessível.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest**

O endereço da solicitação de cache que especifica as propriedades e os padrões de controle a serem armazenados no cache.

[out, retval] element

Tipo: IUIAutomationElement**

Recebe um ponteiro para o elemento de Automação da Interface do Usuário.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método permite que os clientes da Automação da Interface do Usuário da Microsoft obtenham interfaces IUIAutomationElement para objetos acessíveis implementados por um servidor de Acessibilidade Ativa da Microsoft.

Esse método poderá falhar se o servidor implementar interfaces do provedor de Automação da Interface do Usuário juntamente com o suporte à Acessibilidade Ativa da Microsoft.

O método retornará E_INVALIDARG se a implementação subjacente do elemento de Automação da Interface do Usuário não for um servidor nativo de Acessibilidade Ativa da Microsoft; ou seja, se um cliente tentar recuperar a interface IAccessible para um elemento originalmente compatível com um objeto proxy de Oleacc.dll ou pela ponte UIA para MSAA.

Requisitos

Confira também

IUIAutomation

IUIAutomation::ElementFromHandleBuildCache