GetWindowPlacement
The GetWindowPlacement
function retrieves the show state and the restored, minimized, and maximized
positions of the specified window.
BOOL GetWindowPlacement(
|
HWND hWnd, |
// handle of window |
|
WINDOWPLACEMENT *lpwndpl |
// address of
structure for position data |
|
); |
|
Parameters
hWnd
Identifies
the window.
lpwndpl
Points to the
WINDOWPLACEMENT
structure that receives the show state and position information.
Before
calling GetWindowPlacement, set the length member of the WINDOWPLACEMENT
structure to sizeof(WINDOWPLACEMENT).
GetWindowPlacement fails if lpwndpl->length is not set
correctly.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The flags
member of WINDOWPLACEMENT retrieved by this function is always zero. If
the window identified by the hWnd parameter is maximized, the showCmd
member is SW_SHOWMAXIMIZED. If the window is minimized, showCmd is
SW_SHOWMINIMIZED. Otherwise, it is SW_SHOWNORMAL.
The length
member of WINDOWPLACEMENT must be set to sizeof(WINDOWPLACEMENT).
If this member is not set correctly, the function returns FALSE.
See Also