DwmUpdateThumbnailProperties, fonction (dwmapi.h)

Mises à jour les propriétés d’une miniature du Gestionnaire de fenêtres bureau (DWM).

Syntaxe

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

Paramètres

hThumbnailId

Handle de la miniature DWM à mettre à jour. Les miniatures null ou non valides, ainsi que les miniatures appartenant à d’autres processus, entraînent une valeur de retour de E_INVALIDARG.

[in] ptnProperties

Pointeur vers une structure DWM_THUMBNAIL_PROPERTIES qui contient les nouvelles propriétés de miniature.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Les relations de miniatures créées par la fonction DwmRegisterThumbnail ne sont pas rendues dans la fenêtre de destination tant que cette fonction n’est pas appelée. Les appels suivants mettent à jour la miniature en fonction des propriétés fournies.

Exemples

L’exemple suivant montre comment inscrire et afficher la miniature du Bureau.

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;	
}

Spécifications

Voir aussi

Vue d’ensemble des miniatures DWM

Vue d’ensemble du Gestionnaire de fenêtres du Bureau

DwmQueryThumbnailSourceSize

DwmUnregisterThumbnail