Share via

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.

Sintaks

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

Parameter

hwnd

Handel ke jendela yang nilai atributnya akan diatur.

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, dalam baris untuk setiap bendera, jenis nilai apa yang harus Anda berikan penunjuk ke dalam parameter pvAttribute .

cbAttribute

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

Nilai kembali

Jenis: HRESULT

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

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

Keterangan

Tidak valid untuk memanggil fungsi ini dengan parameter dwAttribute yang 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

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; Uxtheme.dll

Lihat juga