←関数一覧に戻る

DwmSetIconicThumbnail 関数

ウィンドウのアイコンサムネイルのビットマップを設定します。
サムネイルはタスクバーのタブとしても使われます。 
HRESULT WINAPI DwmSetIconicThumbnail（
  _In_HWND hwnd、
  _In_HBITMAP hbmp、
  _In_ DWORD dwSITFlags
);

パラメーター


hwnd (HWND) [in]
ウィンドウまたは、タブのハンドル。このウィンドウは呼び出しプロセスに属していなければなりません。

hbmp (HBITMAP) [in]
hwndで指定したウィンドウのサムネイルとして設定するビットマップハンドル。

dwSITFlags (DWORD) [in]
サムネイル表示オプション。
値意味
0(0x00000000)サムネイルの周りにフレームを表示しない
DWM_SIT_DISPLAYFRAME(0x00000001)サムネイルの周りにフレームを表示する


戻り値


この関数が成功すると、S_OK(0)を返します。それ以外の場合は、HRESULTエラーコードを返します。

対象


Windows 7からサポート
Windows Server 2008 R2からサポート

備考


アプリケーションは、WM_DWMSENDICONICTHUMBNAILメッセージを受信した後に、DwmSetIconicThumbnail 関数を呼び出します。
指定するビットマップは32bitの色深度が必要です。
また、ビットマップのサイズは、WM_DWMSENDICONICTHUMBNAIL メッセージで指定されたサイズを使用します。 lParam値の上位ワードに最大幅が、lParam値の下位ワードに最大高さが入っています。

DWMは指定されたビットマップのコピーを使用しますので、元のビットマップは開放してもかまいません。

DwmInvalidateIconicBitmaps 関数を呼び出して、アイコンサムネイルとライブビュービットマップを更新する必要があることをDWMに通知することができます。


Unicode版なし
呼び出すDLLDwmapi.dll、Uxtheme.dll
インポートライブラリDwmapi.lib
定義されているヘッダーDwmapi.h

HSPでの命令登録


#uselib "dwmapi.dll"
#func DwmSetIconicThumbnail "DwmSetIconicThumbnail" int, int, int



(C)2019 inonote / 無断転載禁止