Função DwmRegisterThumbnail (dwmapi.h)

Cria uma relação de miniatura do DWM (Gerenciador de Janelas da Área de Trabalho) entre as janelas de destino e de origem.

Sintaxe

HRESULT DwmRegisterThumbnail(
  [in]  HWND        hwndDestination,
  [in]  HWND        hwndSource,
  [out] PHTHUMBNAIL phThumbnailId
);

Parâmetros

[in] hwndDestination

O identificador para a janela que usará a miniatura dwm. Definir o identificador da janela de destino como qualquer outra coisa que não seja um tipo de janela de nível superior resultará em um valor retornado de E_INVALIDARG.

[in] hwndSource

O identificador para a janela a ser usada como a origem da miniatura. Definir o identificador da janela de origem como qualquer outra coisa que não seja um tipo de janela de nível superior resultará em um valor retornado de E_INVALIDARG.

[out] phThumbnailId

Um ponteiro para um identificador que, quando essa função retorna com êxito, representa o registro da miniatura dwm.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Registrar uma relação de miniatura dwm não modificará a composição da área de trabalho; para obter informações sobre o posicionamento em miniatura, consulte a documentação da função DwmUpdateThumbnailProperties .

A janela designada por hwndDestination deve ser a própria janela da área de trabalho ou pertencer ao processo que está chamando DwmRegisterThumbnail. Isso é necessário para impedir que os aplicativos afetem o conteúdo de outros aplicativos.

O identificador de registro em miniatura obtido por essa função não é globalmente exclusivo, mas é exclusivo do processo. Chame a função DwmUnregisterThumbnail para cancelar o registro da miniatura. Isso deve ser feito dentro do processo em que a relação foi registrada.

Exemplos

O exemplo a seguir demonstra como registrar a miniatura da área de trabalho.

HRESULT UpdateDesktop(HWND hwnd)
{
	HRESULT hr = S_OK;

	// Register the thumbnail
	HTHUMBNAIL thumbnail = NULL;

	hr = DwmRegisterThumbnail(hwnd, FindWindow(_T("Progman"), NULL), &thumbnail);
	if (SUCCEEDED(hr))
	{
		// Display the thumbnail using DwmUpdateThumbnailProperties
	}
	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

DwmUpdateThumbnailProperties