Função GetParent (winuser.h)

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

Confira também

Conceitual

GetAncestor

Getwindow

Referência

Setparent

Windows

Estilos do Windows