Funzione DwmExtendFrameIntoClientArea (dwmapi.h)

Articolo
02/26/2024

Estende la cornice della finestra nell'area client.

Sintassi

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

Parametri

[in] hWnd

Handle alla finestra in cui verrà estesa la cornice nell'area client.

[in] pMarInset

Puntatore a una struttura MARGIN che descrive i margini da usare durante l'estensione del frame nell'area client.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione deve essere chiamata ogni volta che la composizione di Desktop Window Manager (DWM) viene disattivata. Gestire il messaggio WM_DWMCOMPOSITIONCHANGED per la notifica di modifica della composizione.

Usare i valori di margine negativi per creare l'effetto "foglio di vetro" in cui l'area client viene sottoposta a rendering come superficie solida senza bordo finestra.

Esempio

L'esempio seguente illustra come estendere il margine inferiore, creando un frame inferiore di grandi dimensioni.


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;
}

L'esempio seguente illustra l'effetto "foglio di vetro" in cui viene eseguito il rendering dell'area client senza un bordo finestra.


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;
}

Requisiti

Requisito	Valore
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 di DWM Blur

Condividi tramite