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 |