Função DwmExtendFrameIntoClientArea (dwmapi.h)

Estende o quadro da janela para a área do cliente.

Sintaxe

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

Parâmetros

[in] hWnd

O identificador para a janela na qual o quadro será estendido para a área do cliente.

[in] pMarInset

Um ponteiro para uma estrutura MARGINS que descreve as margens a serem usadas ao estender o quadro para a área do cliente.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa função deve ser chamada sempre que a composição do DWM (Gerenciador de Janelas da Área de Trabalho) for alternada. Manipule a mensagem WM_DWMCOMPOSITIONCHANGED para notificação de alteração de composição.

Use valores de margem negativos para criar o efeito "folha de vidro", em que a área do cliente é renderizada como uma superfície sólida sem borda de janela.

Exemplos

O exemplo a seguir demonstra como estender a margem inferior, criando um quadro inferior grande.

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

O exemplo a seguir demonstra o efeito "folha de vidro" em que a área do cliente é renderizada sem uma borda de janela.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dwmapi.h
Biblioteca	Dwmapi.lib
DLL	Dwmapi.dll

Confira também

Visão geral do desfoque dwm por trás