Функция 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
Header	dwmapi.h
Библиотека	Dwmapi.lib
DLL	Dwmapi.dll