Función DwmUpdateThumbnailProperties (dwmapi.h)

Artículo
08/23/2023

Novedades las propiedades de una miniatura del Administrador de ventanas de escritorio (DWM).

Sintaxis

HRESULT DwmUpdateThumbnailProperties(
       HTHUMBNAIL                     hThumbnailId,
  [in] const DWM_THUMBNAIL_PROPERTIES *ptnProperties
);

Parámetros

hThumbnailId

Identificador de la miniatura de DWM que se va a actualizar. Las miniaturas nulas o no válidas, así como las miniaturas que pertenecen a otros procesos darán lugar a un valor devuelto de E_INVALIDARG.

[in] ptnProperties

Puntero a una estructura DWM_THUMBNAIL_PROPERTIES que contiene las nuevas propiedades en miniatura.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Las relaciones en miniatura creadas por la función DwmRegisterThumbnail no se representarán en la ventana de destino hasta que se llame a esta función. Las llamadas posteriores actualizarán la miniatura según las propiedades proporcionadas.

Ejemplos

En el ejemplo siguiente se muestra cómo registrar y mostrar la miniatura de escritorio.


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 compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dwmapi.h
Library	Dwmapi.lib
Archivo DLL	Dwmapi.dll