Fungsi BufferedPaintSetAlpha (uxtheme.h)

Mengatur alfa ke nilai tertentu dalam persegi panjang tertentu. Alfa mengontrol jumlah transparansi yang diterapkan saat memadukan dengan buffer ke konteks perangkat target tujuan (DC).

Sintaks

HRESULT BufferedPaintSetAlpha(
       HPAINTBUFFER hBufferedPaint,
  [in] const RECT   *prc,
       BYTE         alpha
);

Parameter

hBufferedPaint

Jenis: HPAINTBUFFER

Handel konteks cat yang di-buffer, diperoleh melalui BeginBufferedPaint.

[in] prc

Jenis: const RECT*

Penunjuk ke struktur RECT yang menentukan persegi panjang untuk mengatur alfa. Atur parameter ini ke NULL untuk menentukan seluruh buffer.

alpha

Jenis: BYTE

Nilai alfa yang akan diatur. Nilai alfa dapat berkisar dari nol (sepenuhnya transparan) hingga 255 (sepenuhnya buram).

Nilai kembali

Jenis: HRESULT

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

Keterangan

Fungsi ini mengatur nilai alfa untuk setiap piksel dalam persegi panjang target. Meneruskan nilai alfa 255 membuat piksel sepenuhnya buram. Makro BufferedPaintMakeOpaque , yang didefinisikan dalam uxtheme.h, mengatur nilai alfa ke 255. Biasanya digunakan untuk memanggil GDI untuk menggambar ke dalam buffer memori dan kemudian membuatnya buram untuk menggambarnya di kaca.

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	uxtheme.h
DLL	UxTheme.dll