BeginDeferWindowPos 関数 (winuser.h)

  • [アーティクル]

複数ウィンドウ位置構造体にメモリを割り当て、構造体にハンドルを返します。

構文

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

パラメーター

[in] nNumWindows

型: int

位置情報を格納するウィンドウの初期数。 DeferWindowPos 関数は、必要に応じて構造体のサイズを大きくします。

戻り値

種類: HDWP

関数が成功した場合、戻り値は複数ウィンドウ位置構造を識別します。 構造体の割り当てに使用できるシステム リソースが不足している場合、戻り値は NULL になります。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

複数ウィンドウ位置構造は内部構造です。アプリケーションは直接アクセスできません。

DeferWindowPos は、複数ウィンドウ位置構造に、移動しようとしている 1 つ以上のウィンドウのターゲット位置に関する情報を入力します。 EndDeferWindowPos 関数は、この構造体のハンドルを受け取り、構造体に格納されている情報を使用してウィンドウの位置を変更します。

システムが nNumWindows パラメーターで指定された初期サイズを超えて複数ウィンドウ位置構造のサイズを大きくする必要があるが、そのために十分なメモリを割り当てることができない場合、システムはウィンドウ配置シーケンス全体 (BeginDeferWindowPos、DeferWindowPos、EndDeferWindowPos) を失敗させます。 必要な最大サイズを指定することで、アプリケーションはプロセスの早い段階で障害を検出して処理できます。

要件

要件 値
サポートされている最小のクライアント 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-4 (Windows 10 バージョン 10.0.14393 で導入)

関連項目

概念

DeferWindowPos

EndDeferWindowPos

リファレンス

Setwindowpos

Windows