BeginDeferWindowPos

複数ウィンドウ位置構造体のためのメモリを割り当て、その構造体へのハンドルを返す。

BeginDeferWindowPos nNumWindows

nNumWindows : [int] 型: int 位置情報を格納するウィンドウの初期数。必要に応じて DeferWindowPos 関数が構造体のサイズを増加させる。

(プラグイン / モジュール : user32.dll)

解説

複数ウィンドウ位置構造体のためのメモリを割り当て、その構造体へのハンドルを返す。

[戻り値]
型: HDWP
関数が成功した場合、戻り値は複数ウィンドウ位置構造体を識別する。構造体を割り当てるシステムリソースが不足している場合、戻り値は
NULL。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
複数ウィンドウ位置構造体は内部構造体であり、アプリケーションから直接アクセスすることはできない。
DeferWindowPos は、これから移動される 1
つまたは複数のウィンドウの目的位置に関する情報を構造体に書き込む。EndDeferWindowPos
関数はこの構造体へのハンドルを受け取り、構造体に格納された情報に基づいてウィンドウの位置を変更する。nNumWindows
パラメータで指定された初期サイズを超えて構造体のサイズを増やす必要があるが、十分なメモリを割り当てられない場合、システムはウィンドウ位置決めシーケンス全体
(BeginDeferWindowPos、DeferWindowPos、EndDeferWindowPos)
を失敗させる。必要となる最大サイズを指定することで、アプリケーションは処理の早い段階で失敗を検出して処理できる。

情報