BringWindowToTop

	BOOL BringWindowToTop(hwnd)
	HWND hwnd;	/* handle of window	*/

The BringWindowToTop function brings a pop-up or child window (including an MDI child window) to the top of a stack of overlapping windows. In addition, it activates pop-up, top-level, and MDI child windows.

Parameters

hwnd

Identifies the pop-up or child window to bring to the top.

Return Value

The return value is TRUE if the function was successful, or FALSE if an error occurred. Use the GetLastError function to obtain extended error information.

Comments

This function should be used to uncover any window that is partially or completely obscured by any overlapping windows.

Calling this function is similar to calling the SetWindowPos function to change a window's position in the z-order. The BringWindowToTop function does not make a window a top-level window.