Bagikan melalui


Fungsi DwmUpdateThumbnailProperties (dwmapi.h)

Updates properti untuk gambar mini Desktop Window Manager (DWM).

Sintaks

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

Parameter

hThumbnailId

Handel ke gambar mini DWM yang akan diperbarui. Gambar mini null atau tidak valid, serta gambar mini yang dimiliki oleh proses lain akan menghasilkan nilai pengembalian E_INVALIDARG.

[in] ptnProperties

Penunjuk ke struktur DWM_THUMBNAIL_PROPERTIES yang berisi properti gambar mini baru.

Menampilkan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Hubungan gambar mini yang dibuat oleh fungsi DwmRegisterThumbnail tidak akan dirender ke jendela tujuan hingga fungsi ini dipanggil. Panggilan berikutnya akan memperbarui gambar mini sesuai dengan properti yang disediakan.

Contoh

Contoh berikut menunjukkan cara mendaftar dan menampilkan gambar mini desktop.


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

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header dwmapi.h
Pustaka Dwmapi.lib
DLL Dwmapi.dll

Lihat juga

Gambaran Umum Gambar Mini DWM

Gambaran Umum Manajer Jendela Desktop

DwmQueryThumbnailSourceSize

DwmUnregisterThumbnail