SetParent, fonction (winuser.h)

Modifie la fenêtre parente de la fenêtre enfant spécifiée.

Syntaxe

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

Paramètres

[in] hWndChild

Type : HWND

Handle vers la fenêtre enfant.

[in, optional] hWndNewParent

Type : HWND

Handle vers la nouvelle fenêtre parente. Si ce paramètre a la valeur NULL, la fenêtre de bureau devient la nouvelle fenêtre parente. Si ce paramètre est HWND_MESSAGE, la fenêtre enfant devient une fenêtre de message uniquement.

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour est un handle de la fenêtre parente précédente.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Une application peut utiliser la fonction SetParent pour définir la fenêtre parente d’une fenêtre contextuelle, superposée ou enfant.

Si la fenêtre identifiée par le paramètre hWndChild est visible, le système effectue le redessinage et le repeint appropriés.

Pour des raisons de compatibilité, SetParent ne modifie pas les styles de fenêtre WS_CHILD ou WS_POPUP de la fenêtre dont le parent est en cours de modification. Par conséquent, si hWndNewParent a la valeur NULL, vous devez également effacer le bit WS_CHILD et définir le style WS_POPUP après avoir appelé SetParent. À l’inverse, si hWndNewParentn’a pas la valeur NULL et que la fenêtre était auparavant un enfant du bureau, vous devez effacer le style WS_POPUP et définir le style WS_CHILD avant d’appeler SetParent.

Lorsque vous modifiez le parent d’une fenêtre, vous devez synchroniser l’UISTATE des deux fenêtres. Pour plus d’informations, consultez WM_CHANGEUISTATE et WM_UPDATEUISTATE.

Des erreurs ou des comportements inattendus peuvent se produire si hWndNewParent et hWndChild s’exécutent dans différents modes de reconnaissance ppp. Le tableau ci-dessous décrit ce comportement :

Pour plus d’informations sur la prise en charge des ppp, consultez la documentation Windows High DPI.

Configuration requise

Voir aussi

Conceptuel

GetParent

Référence

Windows