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で導入)

関連項目

概念

リファレンス

SetWindowPlacement

WINDOWPLACEMENT

Windows