Fungsi DwmExtendFrameIntoClientArea (dwmapi.h)

Artikel
08/14/2024

Memperluas bingkai jendela ke area klien.

Sintaks

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

Parameter

[in] hWnd

Handel ke jendela tempat bingkai akan diperluas ke area klien.

[in] pMarInset

Penunjuk ke struktur MARGINS yang menjelaskan margin yang akan digunakan saat memperluas bingkai ke area klien.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi ini harus dipanggil setiap kali komposisi Desktop Window Manager (DWM) diubah. Tangani pesan WM_DWMCOMPOSITIONCHANGED untuk pemberitahuan perubahan komposisi.

Gunakan nilai margin negatif untuk membuat efek "lembar kaca" di mana area klien dirender sebagai permukaan padat tanpa batas jendela.

Contoh

Contoh berikut menunjukkan cara memperluas margin bawah, membuat bingkai bawah besar.


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

Sampel berikut menunjukkan efek "lembar kaca" di mana area klien dirender tanpa batas jendela.


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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	dwmapi.h
Pustaka	Dwmapi.lib
DLL	Dwmapi.dll

Lihat juga

Gambaran Umum DWM Blur Behind

Bagikan melalui