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

Recupera o próximo elemento irmão do elemento Automação da Interface do Usuário especificado e armazena em cache propriedades e padrões de controle.

Sintaxe

HRESULT GetNextSiblingElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **next
);

Parâmetros

[in] element

Tipo: IUIAutomationElement*

Um ponteiro para o elemento para o qual recuperar o próximo irmão.

[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] next

Tipo: IUIAutomationElement**

Recebe um ponteiro para o próximo elemento irmão ou NULL se não houver nenhum elemento irmão.

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

Um elemento pode ter elementos irmãos adicionais que não correspondem à condição de exibição atual e, portanto, não são retornados ao navegar na árvore de elementos.

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

Requisitos