Share via


Função GetAncestor (winuser.h)

Recupera o identificador para o ancestral da janela especificada.

Sintaxe

HWND GetAncestor(
  [in] HWND hwnd,
  [in] UINT gaFlags
);

Parâmetros

[in] hwnd

Digite: HWND

Um identificador para a janela cujo ancestral deve ser recuperado. Se esse parâmetro for a janela da área de trabalho, a função retornará NULL.

[in] gaFlags

Tipo: UINT

O ancestral a ser recuperado. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
GA_PARENT
1
Recupera a janela pai. Isso não inclui o proprietário, como faz com a função GetParent .
GA_ROOT
2
Recupera a janela raiz percorrendo a cadeia de janelas pai.
GA_ROOTOWNER
3
Recupera a janela raiz de propriedade percorrendo a cadeia de janelas pai e proprietário retornada por GetParent.

Valor retornado

Digite: HWND

O valor retornado é o identificador para a janela ancestral.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-window-l1-1-1 (introduzido no Windows 8.1)

Confira também

Conceitual

GetParent

Referência

Windows