dwmUpdateThumbnailProperties 函数 (dwmapi.h)

项目
08/23/2023

汇报桌面窗口管理器的属性 (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