Método IUIAutomationTreeWalker::GetParentElementBuildCache (uiautomationclient.h)

Recupera o elemento pai do elemento de Automação da Interface do Usuário especificado e armazena em cache as propriedades e os padrões de controle.

Sintaxe

HRESULT GetParentElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **parent
);

Parâmetros

[in] element

Tipo: IUIAutomationElement*

Um ponteiro para o elemento para o qual recuperar o pai.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Um ponteiro para uma solicitação de cache que especifica as propriedades e os padrões de controle a serem armazenados em cache no elemento retornado.

[out, retval] parent

Tipo: IUIAutomationElement**

Recebe um ponteiro para o elemento pai ou NULL se não houver nenhum elemento pai.

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

A estrutura da árvore de Automação da Interface do Usuário da Microsoft muda conforme os elementos de interface do usuário visíveis na área de trabalho mudam. Não há garantia de que um elemento retornado como o elemento pai será retornado como o pai em passagens subsequentes.

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)