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

  • Artigo

Recupera o primeiro elemento filho do elemento Automação da Interface do Usuário especificado.

Sintaxe

HRESULT GetFirstChildElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **first
);

Parâmetros

[in] element

Tipo: IUIAutomationElement*

Um ponteiro para o elemento para o qual recuperar o primeiro filho.

[out, retval] first

Tipo: IUIAutomationElement**

Recebe um ponteiro para o primeiro elemento filho.

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 filho 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 primeiro elemento filho será retornado como o primeiro filho em passagens subsequentes.

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