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
| 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) |
Confira também
Conceitual
Referência