Expand Minimize

GetWindowPlacement function

Retrieves the show state and the restored, minimized, and maximized positions of the specified window.

Syntax


BOOL WINAPI GetWindowPlacement(
  _In_     HWND hWnd,
  _Inout_  WINDOWPLACEMENT *lpwndpl
);

Parameters

hWnd [in]

Type: HWND

A handle to the window.

lpwndpl [in, out]

Type: WINDOWPLACEMENT*

A pointer to the WINDOWPLACEMENT structure that receives the show state and position information. Before calling GetWindowPlacement, set the length member to sizeof(WINDOWPLACEMENT). GetWindowPlacement fails if lpwndpl-> length is not set correctly.

Return value

Type:

Type: BOOL

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. For additional remarks on the proper use of window placement coordinates, see WINDOWPLACEMENT.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
SetWindowPlacement
WINDOWPLACEMENT
Conceptual
Windows

 

 

Community Additions

ADD
Show:
© 2014 Microsoft