Função DwmUpdateThumbnailProperties (dwmapi.h)
Atualizações as propriedades de uma miniatura do DWM (Gerenciador de Janelas da Área de Trabalho).
Sintaxe
HRESULT DwmUpdateThumbnailProperties(
HTHUMBNAIL hThumbnailId,
[in] const DWM_THUMBNAIL_PROPERTIES *ptnProperties
);
Parâmetros
hThumbnailId
O identificador para a miniatura do DWM a ser atualizada. Miniaturas nulas ou inválidas, bem como miniaturas pertencentes a outros processos resultarão em um valor retornado de E_INVALIDARG.
[in] ptnProperties
Um ponteiro para uma estrutura DWM_THUMBNAIL_PROPERTIES que contém as novas propriedades de miniatura.
Valor retornado
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
As relações em miniatura criadas pela função DwmRegisterThumbnail não serão renderizadas para a janela de destino até que essa função seja chamada. As chamadas subsequentes atualizarão a miniatura de acordo com as propriedades fornecidas.
Exemplos
O exemplo a seguir demonstra como registrar e exibir a miniatura da área de trabalho.
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;
}
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | dwmapi.h |
| Biblioteca | Dwmapi.lib |
| DLL | Dwmapi.dll |
Confira também
Visão geral da miniatura do DWM