METODE IDCompositionVisual2::SetOpacityMode (dcomp.h)

Mengatur mode opasitas untuk visual ini.

Sintaks

HRESULT SetOpacityMode(
  [in] DCOMPOSITION_OPACITY_MODE mode
);

Parameter

[in] mode

Mode opasitas yang digunakan saat menyusun visual ke layar.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.

Keterangan

Mode opasitas memengaruhi bagaimana properti Opasitas objek grup efek memengaruhi komposisi sub-pohon visual. DirectComposition mendukung dua mode opasitas: Layer dan Multiply. Dalam mode Lapisan, setiap sub-pohon visual dapat dilihat secara logis sebagai bitmap yang berisi rasterisasi buram dari seluruh sub-pohon tersebut, tempat nilai opasitas kemudian diterapkan. Dengan cara ini, permukaan buram yang tumpang tindih berbaur dengan latar belakang sub-pohon, tetapi tidak satu sama lain. Sebaliknya, dalam mode Kalikan, opasitas diterapkan satu per satu ke setiap permukaan saat dikomposisikan, sehingga permukaan berbaur satu sama lain. Mode kalikan lebih cepat daripada mode Lapisan dan selalu disukai jika pohon visual berisi konten yang sepenuhnya tidak tumpang tindih. Namun, mode Kalikan dapat menghasilkan hasil visual yang tidak diinginkan untuk elemen yang tumpang tindih.

Secara default, visual mewarisi mode opasitas visual induknya, yang dapat mewarisi mode opasitas visual induknya, dan sebagainya. Visual menggunakan mode DCOMPOSITION_OPACITY_MODE_LAYER jika metode ini tidak pernah dipanggil untuk visual, atau jika metode ini dipanggil dengan DCOMPOSITION_OPACITY_MODE_INHERIT. Jika tidak ada visual yang mengatur mode opasitas, default untuk seluruh pohon visual DCOMPOSITION_OPACITY_MODE_LAYER.

Jika parameter opacityMode adalah apa pun selain DCOMPOSITION_OPACITY_MODE_INHERIT, permukaan visual ini terdiri dari mode opasitas yang ditentukan. Selain itu, mode opasitas ini menjadi default baru untuk anak-anak visual saat ini. Artinya, jika mode keburaman dari anak-anak visual ini tidak berubah atau secara eksplisit diatur ke DCOMPOSITION_OPACITY_MODE_INHERIT, permukaan visual anak disusupi menggunakan mode opasitas visual ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	dcomp.h
Pustaka	Dcomp.lib
DLL	Dcomp.dll

Lihat juga

IDCompositionEffectGroup::SetOpacity

IDCompositionVisual2