Funzione DwmUpdateThumbnailProperties (dwmapi.h)
Aggiornamenti le proprietà per un'anteprima di Desktop Window Manager (DWM).
Sintassi
HRESULT DwmUpdateThumbnailProperties(
HTHUMBNAIL hThumbnailId,
[in] const DWM_THUMBNAIL_PROPERTIES *ptnProperties
);
Parametri
hThumbnailId
Handle per l'anteprima DWM da aggiornare. Le anteprime Null o non valide, nonché le anteprime di proprietà di altri processi genereranno un valore restituito di E_INVALIDARG.
[in] ptnProperties
Puntatore a una struttura DWM_THUMBNAIL_PROPERTIES che contiene le nuove proprietà di anteprima.
Valore restituito
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Le relazioni di anteprima create dalla funzione DwmRegisterThumbnail non verranno visualizzate nella finestra di destinazione finché non viene chiamata questa funzione. Le chiamate successive aggiorneranno l'anteprima in base alle proprietà specificate.
Esempio
Nell'esempio seguente viene illustrato come registrare e visualizzare l'anteprima del 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;
}
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | dwmapi.h |
| Libreria | Dwmapi.lib |
| DLL | Dwmapi.dll |
Vedi anche
Panoramica dell'anteprima di DWM