DwmExtendFrameIntoClientArea-Funktion (dwmapi.h)

Erweitert den Fensterrahmen auf den Clientbereich.

Syntax

HRESULT DwmExtendFrameIntoClientArea(
       HWND          hWnd,
  [in] const MARGINS *pMarInset
);

Parameter

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

Weitere Informationen

Übersicht über DWM Blur Behind