Bagikan melalui

Fungsi DwmSetWindowAttribute (dwmapi.h)

  • Artikel

Menetapkan nilai atribut penyajian non-klien Desktop Window Manager (DWM) untuk jendela. Untuk panduan pemrograman, dan contoh kode, lihat Mengontrol penyajian wilayah non-klien.

Sintaksis

HRESULT DwmSetWindowAttribute(
  [in] HWND    hwnd,
  [in] DWORD   dwAttribute,
  [in] LPCVOID pvAttribute,
  [in] DWORD   cbAttribute
);

Parameter

[in] hwnd

Handel ke jendela yang nilai atributnya akan diatur.

[in] dwAttribute

Bendera yang menjelaskan nilai mana yang akan ditetapkan, ditentukan sebagai nilai enumerasi DWMWINDOWATTRIBUTE . Parameter ini menentukan atribut mana yang akan diatur, dan parameter pvAttribute menunjuk ke objek yang berisi nilai atribut.

[in] pvAttribute

Penunjuk ke objek yang berisi nilai atribut yang akan diatur. Jenis set nilai tergantung pada nilai parameter dwAttribute. Topik enumerasi DWMWINDOWATTRIBUTE menunjukkan, di baris untuk setiap bendera, jenis nilai apa yang harus Anda berikan penunjuk ke dalam parameter pvAttribute .

[in] cbAttribute

Ukuran, dalam byte, dari nilai atribut yang diatur melalui parameter pvAttribute. Jenis set nilai, dan oleh karena itu ukurannya dalam byte, tergantung pada nilai parameter dwAttribute.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahanHRESULT .

Jika Komposisi Desktop telah dinonaktifkan (Windows 7 dan yang lebih lama), maka fungsi ini mengembalikan DWM_E_COMPOSITIONDISABLED.

Komentar

Tidak valid untuk memanggil fungsi ini dengan parameter dwAttribute diatur ke DWMWA_NCRENDERING_ENABLED. Untuk mengaktifkan atau menonaktifkan penyajian non-klien, Anda harus menggunakan atribut DWMWA_NCRENDERING_POLICY, dan mengatur nilai yang diinginkan. Untuk informasi selengkapnya, dan contoh kode, lihat Mengontrol penyajian wilayah non-klien.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Platform Target Windows
Header dwmapi.h
Pustaka Dwmapi.lib
DLL Dwmapi.dll; Uxtheme.dll

Lihat juga