AnimateWindow

ウィンドウを表示または非表示にするときに特殊効果を生成できるようにする。アニメーションは 4 種類: ロール、スライド、折りたたみまたは展開、アルファブレンドフェード。

AnimateWindow hWnd, dwTime, dwFlags

hWnd : [intptr] 型: HWND アニメーションさせるウィンドウへのハンドル。呼び出し元スレッドがこのウィンドウを所有している必要がある。
dwTime : [int] 型: DWORD アニメーションの再生にかかる時間 (ミリ秒)。通常、アニメーションの再生には 200 ミリ秒かかる。
dwFlags : [int] 型: DWORD

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

解説

ウィンドウを表示または非表示にするときに特殊効果を生成できるようにする。アニメーションは 4 種類:
ロール、スライド、折りたたみまたは展開、アルファブレンドフェード。

[戻り値]
型: BOOL 関数が成功した場合、戻り値は 0 以外。関数が失敗した場合、戻り値は 0。次の状況で関数が失敗する:
（以下省略）

[備考]
特殊効果なしでウィンドウを表示・非表示にするには ShowWindow
を使用する。スライドまたはロールアニメーションを使うときは方向を指定する必要がある。AW_HOR_POSITIVE、AW_HOR_NEGATIVE、AW_VER_POSITIVE、AW_VER_NEGATIVE
のいずれかが使用できる。AW_HOR_POSITIVE または AW_HOR_NEGATIVE と AW_VER_POSITIVE または
AW_VER_NEGATIVE
を組み合わせて、ウィンドウを斜めにアニメーションさせることもできる。ウィンドウとその子ウィンドウのウィンドウプロシージャは
WM_PRINT または WM_PRINTCLIENT
メッセージを処理する必要がある。ダイアログボックス、コントロール、コモンコントロールは既に WM_PRINTCLIENT
を処理している。デフォルトのウィンドウプロシージャは既に WM_PRINT
を処理している。子ウィンドウが部分的にクリップされて表示されている場合、アニメーション時にクリップされた部分に穴ができる。AnimateWindow
は RTL ウィンドウをサポートする。ドロップシャドウを持つウィンドウのアニメーションは視覚的にぎくしゃくして気が散るため避けること。

情報