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
| 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) |