Share via


SetParent (Compact 2013)

3/28/2014

This function changes the parent window of the specified child window.

Syntax

HWND SetParent( 
  HWND hWndChild, 
  HWND hWndNewParent 
); 

Parameters

  • hWndChild
    [in] Handle to the child window.
  • hWndNewParent
    [in] Handle to the new parent window. If this parameter is NULL, the desktop window becomes the new parent window.

Return Value

A handle to the previous parent window indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

An application can use the SetParent function to set the parent window of a pop-up, overlapped, or child window. The new parent window and the child window must belong to the same application.

If the window identified by the hWndChild parameter is visible, the system performs the appropriate redrawing and repainting.

For compatibility reasons, SetParent does not modify the WS_CHILD or WS_POPUP window styles of the window whose parent is being changed. Therefore, it is not possible to change a window from parent to child or from child to parent.

Requirements

Header

winuser.h

See Also

Reference

Window Functions
GetParent