DwmUpdateThumbnailProperties-Funktion (dwmapi.h)
Updates die Eigenschaften für eine DwM-Miniaturansicht (Desktop Window Manager) aus.
Syntax
HRESULT DwmUpdateThumbnailProperties(
HTHUMBNAIL hThumbnailId,
[in] const DWM_THUMBNAIL_PROPERTIES *ptnProperties
);
Parameter
hThumbnailId
Das Handle für die DWM-Miniaturansicht, die aktualisiert werden soll. Null- oder ungültige Miniaturansichten sowie Miniaturansichten, die anderen Prozessen gehören, führen zu einem Rückgabewert von E_INVALIDARG.
[in] ptnProperties
Ein Zeiger auf eine DWM_THUMBNAIL_PROPERTIES-Struktur , die die neuen Miniaturansichtseigenschaften enthält.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Von der DwmRegisterThumbnail-Funktion erstellte Miniaturansichtsbeziehungen werden erst im Zielfenster gerendert, wenn diese Funktion aufgerufen wird. Nachfolgende Aufrufe aktualisieren die Miniaturansicht entsprechend den bereitgestellten Eigenschaften.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie die Desktopminiaturansicht registrieren und anzeigen.
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;
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwmapi.h |
| Bibliothek | Dwmapi.lib |
| DLL | Dwmapi.dll |
Weitere Informationen
Übersicht über DWM-Miniaturansichten