Função SetParent (winuser.h)

Altera a janela pai da janela filho especificada.

Sintaxe

HWND SetParent(
  [in]           HWND hWndChild,
  [in, optional] HWND hWndNewParent
);

Parâmetros

[in] hWndChild

Digite: HWND

Um identificador para a janela filho.

[in, optional] hWndNewParent

Digite: HWND

Um identificador para a nova janela pai. Se esse parâmetro for NULL, a janela da área de trabalho se tornará a nova janela pai. Se esse parâmetro for HWND_MESSAGE, a janela filho se tornará uma janela somente mensagem.

Retornar valor

Digite: HWND

Se a função for bem-sucedida, o valor retornado será um identificador para a janela pai anterior.

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

Comentários

Um aplicativo pode usar a função SetParent para definir a janela pai de uma janela pop-up, sobreposta ou filho.

Se a janela identificada pelo parâmetro hWndChild estiver visível, o sistema executará o redesenho e a repinização apropriados.

Por motivos de compatibilidade, SetParent não modifica os estilos de janela WS_CHILD ou WS_POPUP da janela cujo pai está sendo alterado. Portanto, se hWndNewParent for NULL, você também deverá limpar o bit WS_CHILD e definir o estilo WS_POPUP depois de chamar SetParent. Por outro lado, se hWndNewParent não for NULL e a janela anteriormente fosse um filho da área de trabalho, você deverá limpar o estilo WS_POPUP e definir o estilo WS_CHILD antes de chamar SetParent.

Ao alterar o pai de uma janela, você deve sincronizar o UISTATE de ambas as janelas. Para obter mais informações, consulte WM_CHANGEUISTATE e WM_UPDATEUISTATE.

Erros ou comportamentos inesperados poderão ocorrer se hWndNewParent e hWndChild estiverem em execução em diferentes modos de reconhecimento de DPI. A tabela a seguir descreve esse comportamento:

Para obter mais informações sobre o reconhecimento de DPI, consulte a documentação do Windows High DPI.

Requisitos

Confira também

Conceitual

GetParent

Referência

Windows