Função GetParent (winuser.h)

Artigo
03/13/2024

Recupera um identificador para o pai ou proprietário da janela especificada.

Para recuperar um identificador para um ancestral especificado, use a função GetAncestor .

Sintaxe

HWND GetParent(
  [in] HWND hWnd
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela cujo identificador de janela pai deve ser recuperado.

Retornar valor

Digite: HWND

Se a janela for uma janela filho, o valor retornado será um identificador para a janela pai. Se a janela for uma janela de nível superior com o estilo WS_POPUP , o valor retornado será um identificador para a janela do proprietário.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Normalmente, essa função falha por um dos seguintes motivos:

A janela é uma janela de nível superior sem proprietário ou que não tem o estilo WS_POPUP .
A janela proprietário tem WS_POPUP estilo.

Comentários

Para obter a janela de proprietário de uma janela, em vez de usar GetParent, use GetWindow com o sinalizador GW_OWNER . Para obter a janela pai e não o proprietário, em vez de usar GetParent, use GetAncestor com o sinalizador GA_PARENT .

Exemplos

Para obter um exemplo, consulte Inicializando uma caixa de diálogo.

Requisitos

Requisito	Valor
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-0 (introduzido em Windows 8)