Fungsi SetLayeredWindowAttributes (winuser.h)

Artikel
03/04/2024

Mengatur kunci warna opasitas dan transparansi dari jendela berlapis.

Sintaks

BOOL SetLayeredWindowAttributes(
  [in] HWND     hwnd,
  [in] COLORREF crKey,
  [in] BYTE     bAlpha,
  [in] DWORD    dwFlags
);

Parameter

[in] hwnd

Jenis: HWND

Handel ke jendela berlapis. Jendela berlapis dibuat dengan menentukan WS_EX_LAYERED saat membuat jendela dengan fungsi CreateWindowEx atau dengan mengatur WS_EX_LAYERED melalui SetWindowLong setelah jendela dibuat.

Windows 8: Gaya WS_EX_LAYERED didukung untuk jendela tingkat atas dan jendela anak. Versi Windows sebelumnya mendukung WS_EX_LAYERED hanya untuk jendela tingkat atas.

[in] crKey

Jenis: COLORREF

Struktur COLORREF yang menentukan kunci warna transparansi yang akan digunakan saat menyusun jendela berlapis. Semua piksel yang dicat oleh jendela dalam warna ini akan transparan. Untuk menghasilkan COLORREF, gunakan makro RGB .

[in] bAlpha

Jenis: BYTE

Nilai alfa digunakan untuk menggambarkan tingkat keburaman jendela berlapis. Mirip dengan anggota SourceConstantAlpha dari struktur BLENDFUNCTION . Ketika bAlpha adalah 0, jendela benar-benar transparan. Ketika bAlpha adalah 255, jendela buram.

[in] dwFlags

Jenis: DWORD

Tindakan yang akan diambil. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
LWA_ALPHA 0x00000002	Gunakan bAlpha untuk menentukan tingkat keburaman jendela berlapis.
LWA_COLORKEY 0x00000001	Gunakan crKey sebagai warna transparansi.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Perhatikan bahwa setelah SetLayeredWindowAttributes dipanggil untuk jendela berlapis, panggilan UpdateLayeredWindow berikutnya akan gagal sampai bit gaya lapisan dibersihkan dan diatur lagi.

Untuk informasi selengkapnya, lihat Menggunakan Windows Berlapis.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-window-l1-1-1 (diperkenalkan dalam Windows 8.1)