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 |