DwmSetIconicThumbnail

ウィンドウまたはタブにサムネイル表現として使用する静的なアイコン形式ビットマップを設定する。タスクバーはこのビットマップを当該ウィンドウまたはタブのサムネイル切り替え対象として使用できる。

DwmSetIconicThumbnail hwnd, hbmp, dwSITFlags

hwnd : [intptr] ウィンドウまたはタブのハンドル。このウィンドウは呼び出し元プロセスに属している必要がある。
hbmp : [intptr] hwnd で指定されたウィンドウを表すビットマップのハンドル。
dwSITFlags : [int] 

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

解説

ウィンドウまたはタブにサムネイル表現として使用する静的なアイコン形式ビットマップを設定する。タスクバーはこのビットマップを当該ウィンドウまたはタブのサムネイル切り替え対象として使用できる。

[戻り値]
関数が成功した場合は S_OK を返す。それ以外の場合は HRESULT エラーコードを返す。

[備考]
アプリケーションは通常、ウィンドウに対する WM_DWMSENDICONICTHUMBNAIL メッセージを受信した後に
DwmSetIconicThumbnail 関数を呼び出す。サムネイルはそのメッセージで指定された最大の x 座標および y
座標を超えてはならない。サムネイルは 32 ビットの色深度を持つ必要もある。アプリケーションは
DwmInvalidateIconicBitmaps
を呼び出すことで、アイコン形式のサムネイルおよびライブプレビュービットマップが古くなっておりリフレッシュすべきであることを Desktop
Window Manager (DWM) に示す。その後 DWM は必要なときにウィンドウから新しいバージョンを要求する。ただし、DWM
のビットマップキャッシュが満杯の場合、DWM は更新版を要求しない。DWM
はビットマップのコピーを使用するが、メモリ制約のためアプリケーションはいつでもこのコピーを解放できる。コピーが解放されてもウィンドウには通知されないが、サムネイルが再度必要になったときに後続の
WM_DWMSENDICONICTHUMBNAIL
リクエストを受け取る場合がある。呼び出し元は元のビットマップの所有権を保持し、不要になった時点でリソースを解放する責任を負う。

情報