GetWindowPlacement 関数 (winuser.h)
指定したウィンドウの表示状態と、復元、最小化、最大化された位置を取得します。
構文
BOOL GetWindowPlacement(
[in] HWND hWnd,
[in, out] WINDOWPLACEMENT *lpwndpl
);
パラメーター
[in] hWnd
型: HWND
ウィンドウへのハンドル。
[in, out] lpwndpl
種類: WINDOWPLACEMENT*
show 状態と位置情報を受け取る WINDOWPLACEMENT 構造体へのポインター。
GetWindowPlacement を呼び出す前に、長さのメンバーを に設定しますsizeof(WINDOWPLACEMENT)。
lpwndpl-length> が正しく設定されていない場合、GetWindowPlacement は失敗します。
戻り値
種類: BOOL
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
この関数によって取得される WINDOWPLACEMENT の flags メンバーは常に 0 です。 hWnd パラメーターで識別されるウィンドウが最大化された場合、showCmd メンバーはSW_SHOWMAXIMIZED。 ウィンドウが最小化されている場合、 showCmd はSW_SHOWMINIMIZED。 それ以外の場合は、SW_SHOWNORMAL。
WINDOWPLACEMENT の長さメンバーは sizeof(WINDOWPLACEMENT) に設定する必要があります。 このメンバーが正しく設定されていない場合、関数は FALSE を返します。 ウィンドウ配置座標の適切な使用方法の詳細については、「 WINDOWPLACEMENT」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-window-l1-1-0 (Windows 8で導入) |
関連項目
概念
リファレンス