Compartilhar via

Método IUIAutomationTextRange3::GetChildrenBuildCache (uiautomationclient.h)

  • Artigo

Retorna os filhos e as propriedades e padrões fornecidos para elementos em um intervalo de texto em uma única chamada entre processos. Isso é equivalente a chamar GetChildren, mas adiciona o padrão de cache de build padrão.

Sintaxe

HRESULT GetChildrenBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElementArray **children
);

Parâmetros

[in] cacheRequest

Um IUIAutomationCacheRequest que especifica as propriedades e os padrões de controle a serem armazenados em cache.

[out, retval] children

Retorna os filhos e as propriedades ou padrões de cada filho do intervalo de texto que atendem aos critérios do cacheRequest fornecido.

Retornar valor

Retorna S_OK se tiver êxito, caso contrário, um código de erro HRESULT .

Comentários

Seguindo o design de GetChildren:

  • Os filhos que se sobrepõem ao intervalo de texto, mas não são totalmente incluídos por ele, também serão incluídos.
  • Quando nenhum filho existe, uma coleção vazia é retornada.
Como resultado de uma chamada bem-sucedida, Automação da Interface do Usuário clientes podem chamar APIs "armazenadas em cache" de IUIAutomationElement fornecidas no cacheRequest, por exemplo, IUIAutomationElement::GetCachedPropertyValue.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (include UIAutomation.h)

Confira também

IUIAutomationTextRange3

suporte Automação da Interface do Usuário para conteúdo textual