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

Confira também

Visão geral da miniatura do DWM

Visão geral do Gerenciador de Janelas da Área de Trabalho

DwmQueryThumbnailSourceSize

DwmUnregisterThumbnail