Grafis::SetCompositingMode method (gdiplusgraphics.h)

Artikel
08/24/2023

Metode Graphics::SetCompositingMode mengatur mode komposit objek Grafis ini.

Sintaks

Status SetCompositingMode(
  [in] CompositingMode compositingMode
);

Parameter

[in] compositingMode

Jenis: CompositingMode

Elemen enumerasi CompositingMode yang menentukan mode komposit.

Menampilkan nilai

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Misalkan Anda membuat objek SolidBrush berdasarkan warna yang memiliki komponen alfa 192, yaitu sekitar 75 persen dari 255. Jika objek Grafis Anda memiliki mode komposit yang diatur ke CompositingModeSourceOver, maka area yang diisi dengan kuas padat adalah campuran yang 75 persen warna kuas dan 25 persen warna latar belakang. Jika objek Grafis Anda memiliki mode komposit yang diatur ke CompositingModeSourceCopy, warna latar belakang tidak dipadukan dengan warna kuas. Namun, warna yang dirender oleh kuas memiliki intensitas yaitu 75 persen dari apa jadinya jika komponen alfa adalah 255.

Anda tidak dapat menggunakan CompositingModeSourceCopy bersama dengan TextRenderingHintClearTypeGridFit.

Contoh

Contoh berikut membuat objek Grafis dan mengatur mode kompositnya ke CompositingModeSourceOver. Kode ini membuat objek SolidBrush berdasarkan warna yang memiliki komponen alfa 128. Kode meneruskan alamat kuas itu ke metode Graphics::FillRectangle dari objek Graphics untuk mengisi persegi panjang dengan warna yang merupakan campuran setengah-setengah dari warna kuas dan warna latar belakang. Kemudian kode mengatur mode komposit objek Grafis ke CompositingModeSourceCopy dan mengisi persegi panjang kedua dengan kuas yang sama. Dalam persegi panjang kedua itu, warna kuas tidak dipadukan dengan warna latar belakang.

VOID Example_SetCompositingMode(HDC hdc)
{
   Graphics graphics(hdc);
   
   // Create a SolidBrush object with an alpha-blended color.
   SolidBrush alphaBrush(Color(180, 255, 0, 0));

   // Set the compositing mode to CompositingModeSourceOver,
   // and fill a rectangle.
   graphics.SetCompositingMode(CompositingModeSourceOver);
   graphics.FillRectangle(&alphaBrush, 0, 0, 100, 100);

   // Set the compositing mode to CompositingModeSourceCopy,
   // and fill a rectangle.
   graphics.SetCompositingMode(CompositingModeSourceCopy);
   graphics.FillRectangle(&alphaBrush, 100, 0, 100, 100);
}

Persyaratan


Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusgraphics.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll