PathGradientBrush::SetBlendBellShape method (gdipluspath.h)

Artikel
03/05/2024

Metode PathGradientBrush::SetBlendBellShape mengatur bentuk campuran sikat gradien jalur ini.

Sintaks

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

Parameter

[in] focus

Jenis: NYATA

Angka riil yang menentukan di mana warna tengah akan berada pada intensitas tertingginya. Angka ini harus dalam rentang 0 hingga 1.

[in, optional] scale

Jenis: NYATA

Opsional. Angka riil yang menentukan intensitas maksimum warna tengah yang dipadukan dengan warna batas. Angka ini harus dalam rentang 0 hingga 1. Nilai default adalah 1.

Nilai kembali

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, saat Anda berpindah dari batas gradien jalur ke titik tengah, warna berubah secara bertahap dari warna batas ke warna tengah. Anda dapat menyesuaikan posisi dan perpaduan warna batas dan tengah dengan memanggil metode PathGradientBrush::SetBlendBellShape .

Contoh

Contoh berikut membuat objek PathGradientBrush berdasarkan elips. Kode ini memanggil metode PathGradientBrush::SetBlendBellShape dari objek PathGradientBrush , melewati fokus 0,2 dan skala 0,7. Kemudian kode menggunakan kuas gradien jalur untuk melukis persegi panjang yang berisi elips.

VOID Example_SetBlendShape(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a path that consists of a single ellipse.
   GraphicsPath path;
   path.AddEllipse(0, 0, 200, 100);

   // Use the path to construct a brush.
   PathGradientBrush pthGrBrush(&path);

   // Set the color at the center of the path to red.
   pthGrBrush.SetCenterColor(Color(255, 255, 0, 0));

   // Set the color along the entire boundary of the path to blue.
   Color colors[] = {Color(255, 0, 0, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   pthGrBrush.SetBlendBellShape(0.2f, 0.7f);

   // The color is blue on the boundary and at the center.
   // At points that are 20 percent of the way from the boundary to the
   // center, the color is 70 percent red and 30 percent blue.

   graphics.FillRectangle(&pthGrBrush, 0, 0, 300, 300); 
}

Persyaratan

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