Compartilhar via


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

Obtém o elemento delimitador e as propriedades e padrões fornecidos para um elemento em um intervalo de texto em uma única chamada entre processos. Isso é equivalente a chamar GetEnclosingElement, mas adiciona o padrão de cache de build padrão.

Sintaxe

HRESULT GetEnclosingElementBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **enclosingElement
);

Parâmetros

[in] cacheRequest

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

[out, retval] enclosingElement

Retorna o elemento delimitador (e propriedades/padrões) do intervalo de texto se ele atender 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 GetEnclosingElement:

  • Obtém o elemento delimitador totalmente inclusivo e interno de um intervalo de texto e as propriedades fornecidas do elemento.
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