Compartilhar via


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

Recupera um elemento Automação da Interface do Usuário para o objeto acessível especificado de um servidor microsoft active accessibility.

Sintaxe

HRESULT ElementFromIAccessible(
  [in]          IAccessible          *accessible,
  [in]          int                  childId,
  [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.

[out, retval] element

Tipo: IUIAutomationElement**

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

Retornar valor

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 Automação da Interface do Usuário clientes 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 Automação da Interface do Usuário interfaces do provedor juntamente com o suporte à Acessibilidade Ativa da Microsoft.

O método retornará E_INVALIDARG se a implementação subjacente do elemento microsoft Automação da Interface do Usuário não for um servidor nativo do Microsoft Active Accessibility; 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-to-MSAA.

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

IUIAutomation

IUIAutomation::ElementFromHandleBuildCache