DwmExtendFrameIntoClientArea-Funktion (dwmapi.h)
Erweitert den Fensterrahmen auf den Clientbereich.
Syntax
HRESULT DwmExtendFrameIntoClientArea(
[in] HWND hWnd,
[in] const MARGINS *pMarInset
);
Parameter
[in] hWnd
Das Handle für das Fenster, in dem der Frame in den Clientbereich erweitert wird.
[in] pMarInset
Ein Zeiger auf eine MARGINS-Struktur , die die Ränder beschreibt, die beim Erweitern des Frames in den Clientbereich verwendet werden sollen.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Funktion muss immer dann aufgerufen werden, wenn die DWM-Komposition (Desktop Window Manager) umgeschaltet wird. Behandeln Sie die WM_DWMCOMPOSITIONCHANGED Meldung für die Benachrichtigung über Kompositionsänderungen.
Verwenden Sie negative Randwerte, um den Effekt "Glasscheibe" zu erstellen, bei dem der Clientbereich als durchgehende Oberfläche ohne Fensterrahmen gerendert wird.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie den unteren Rand erweitern und einen großen unteren Rahmen erstellen.
HRESULT ExtendIntoClientBottom(HWND hwnd)
{
// Set margins, extending the bottom margin
MARGINS margins = {0,0,0,25};
HRESULT hr = S_OK;
// Extend frame on the bottom of client area
hr = DwmExtendFrameIntoClientArea(hwnd,&margins);
if (SUCCEEDED(hr))
{
// ...
}
return hr;
}
Im folgenden Beispiel wird der Effekt "Glasscheibe" veranschaulicht, bei dem der Clientbereich ohne Fensterrahmen gerendert wird.
HRESULT ExtendIntoClientAll(HWND hwnd)
{
// Negative margins have special meaning to DwmExtendFrameIntoClientArea.
// Negative margins create the "sheet of glass" effect, where the client area
// is rendered as a solid surface with no window border.
MARGINS margins = {-1};
HRESULT hr = S_OK;
// Extend the frame across the entire window.
hr = DwmExtendFrameIntoClientArea(hwnd,&margins);
if (SUCCEEDED(hr))
{
// ...
}
return hr;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |