Bagikan melalui


Fungsi SetLayeredWindowAttributes (winuser.h)

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)

Lihat juga

AlphaBlend

COLORREF

Konseptual

CreateWindowEx

Sumber Daya Lain

RGB

Referensi

SetWindowLong

TransparentBlt

UpdateLayeredWindow

Menggunakan Windows

Windows