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