Método IUIAutomationElement::GetCachedChildren (uiautomationclient.h)

Artigo
03/03/2024

Recupera os elementos filho armazenados em cache desse elemento Automação da Interface do Usuário.

Sintaxe

HRESULT GetCachedChildren(
  [out, retval] IUIAutomationElementArray **children
);

Parâmetros

[out, retval] children

Tipo: IUIAutomationElementArray**

Recebe um ponteiro para uma coleção dos elementos filho armazenados em cache.

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

A exibição da coleção retornada é determinada pela propriedade TreeFilter da IUIAutomationCacheRequest que estava ativa quando esse elemento foi obtido.

Os filhos serão armazenados em cache somente se o escopo da solicitação de cache incluir TreeScope_Subtree, TreeScope_Children ou TreeScope_Descendants.

Se a solicitação de cache especificasse que os filhos seriam armazenados em cache nesse nível, mas não houver filhos, o valor dessa propriedade será 0. No entanto, se nenhuma solicitação tiver sido feita para armazenar crianças em cache nesse nível, uma tentativa de recuperar a propriedade retornará um erro.

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 (inclua UIAutomation.h)