LinearGradientBrush::SetBlendBellShape method (gdiplusbrush.h)

Artikel
08/23/2023

Metode LinearGradientBrush::SetBlendBellShape mengatur bentuk campuran sikat gradien linier ini untuk membuat perpaduan kustom berdasarkan kurva berbentuk bel.

Sintaks

Status SetBlendBellShape(
  [in] REAL focus,
  [in] REAL scale
);

Parameter

[in] focus

Jenis: NYATA

Angka riil yang menentukan posisi warna akhir. Angka ini adalah persentase jarak antara garis batas dan harus dalam rentang 0,0 hingga 1,0.

[in] scale

Jenis: NYATA

Pilihan. Angka riil yang menentukan persentase warna akhir gradien yang dipadukan, pada posisi fokus, dengan warna awal gradien. Angka ini harus dalam rentang dari 0,0 hingga 1,0. Nilai defaultnya adalah 1,0, yang menentukan bahwa warna akhir berada pada intensitas penuh.

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

Secara default, warna berubah secara bertahap dari warna awal (warna pada batas awal sikat gradien linier) ke warna akhir (warna pada batas akhir kuas gradien linier) saat Anda berpindah dari batas awal ke batas akhir. Anda dapat menyesuaikan pemosisian dan perpaduan warna awal dan akhir dengan menggunakan metode LinearGradientBrush::SetBlendBellShape .

Metode LinearGradientBrush::SetBlendBellShape menyesuaikan perpaduan sehingga mengikuti kurva berbentuk lonceng dengan ekstrem basis bel di batas gradien. Warna awal, yang, dalam perpaduan default, berada di batas awal kuas gradien linier, muncul di batas awal dan akhir kuas gradien linier saat perpaduan berbentuk bel diterapkan. Posisi warna akhir, yang, dalam campuran default, berada di batas akhir, berada di suatu tempat di antara batas dan ditentukan oleh nilai fokus. Dengan kata lain, fokus menentukan posisi puncak bel. Misalnya, nilai fokus 0,7 menempatkan puncak pada 70 persen jarak antara batas awal dan akhir. Warna akhir muncul pada puncak ini.

Warna akhir dalam perpaduan berbentuk lonceng adalah persentase gamut antara warna awal perpaduan default gradien dan warna akhir default-blend. Misalnya, misalkan kuas gradien linier dibangun dengan warna merah sebagai warna awal dan biru sebagai warna akhir. Jika LinearGradientBrush::SetBlendBellShape dipanggil dengan nilai skala 0,8, warna akhir dalam campuran berbentuk bel adalah warna yang 80 persen antara merah dan biru (merah 20 persen, biru 80 persen). Nilai skala 1,0 menghasilkan warna akhir yang 100 persen biru.

Contoh

Contoh berikut membuat kuas gradien linier, mengatur perpaduan berbentuk lonceng, dan menggunakan kuas untuk mengisi persegi panjang. Dua kali lebih banyak, kode mengatur perpaduan berbentuk bel dengan nilai yang berbeda dan, setiap kali, menggunakan kuas untuk mengisi persegi panjang.

VOID Example_SetBlendBell(HDC hdc)
{
   Graphics myGraphics(hdc);

   LinearGradientBrush linGrBrush(
      Point(0, 0),
      Point(500, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetBlendBellShape(0.5f, 0.6f);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 500, 50);

   linGrBrush.SetBlendBellShape(0.5f, 0.8f); 
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 500, 50);

   linGrBrush.SetBlendBellShape(0.5f, 1.0f); 
   myGraphics.FillRectangle(&linGrBrush, 0, 150, 500, 50);
}

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	gdiplusbrush.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll