DwmUpdateThumbnailProperties 関数 (dwmapi.h)
デスクトップ ウィンドウ マネージャー (DWM) のサムネイルのプロパティを更新します。
構文
HRESULT DwmUpdateThumbnailProperties(
HTHUMBNAIL hThumbnailId,
[in] const DWM_THUMBNAIL_PROPERTIES *ptnProperties
);
パラメーター
hThumbnailId
更新する DWM サムネイルへのハンドル。 null または無効なサムネイル、および他のプロセスが所有するサムネイルは、戻り値E_INVALIDARGになります。
[in] ptnProperties
新しいサムネイル プロパティを含む DWM_THUMBNAIL_PROPERTIES 構造体へのポインター。
戻り値
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
解説
DwmRegisterThumbnail 関数によって作成されたサムネイル リレーションシップは、この関数が呼び出されるまで、変換先ウィンドウにレンダリングされません。 以降の呼び出しでは、指定されたプロパティに従ってサムネイルが更新されます。
例
次の例では、デスクトップのサムネイルを登録して表示する方法を示します。
HRESULT UpdateDesktop(HWND hwnd)
{
HRESULT hr = S_OK;
// Register the thumbnail
SIZE size = {100,100};
HTHUMBNAIL thumbnail = NULL;
hr = DwmRegisterThumbnail(hwnd, FindWindow(_T("Progman"), NULL), &size, &thumbnail);
if (SUCCEEDED(hr))
{
// The destination rectangle size
RECT dest = {0,50,100,150};
// Set the thumbnail properties for use
DWM_THUMBNAIL_PROPERTIES dskThumbProps;
dskThumbProps.dwFlags = DWM_TNP_RECTDESTINATION | DWM_TNP_VISIBLE | DWM_TNP_SOURCECLIENTAREAONLY;
// Use the window frame and client area
dskThumbProps.fSourceClientAreaOnly = FALSE;
dskThumbProps.fVisible = TRUE;
dskThumbProps.opacity = (255 * 70)/100;
dskThumbProps.rcDestination = dest;
// Display the thumbnail
hr = DwmUpdateThumbnailProperties(thumbnail,&dskThumbProps);
if (SUCCEEDED(hr))
{
// ...
}
}
return hr;
}
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dwmapi.h |
| Library | Dwmapi.lib |
| [DLL] | Dwmapi.dll |