BringWindowToTop

2.x

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

The BringWindowToTop function brings the given 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. The BringWindowToTop function should be used to uncover any window that is partially or completely obscured by any overlapping windows.

Parameters

hwnd

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

Return Value

The return value is nonzero if the function is successful. Otherwise, it is zero.

Comments

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.