LinearGradientBrush::LinearGradientBrush(constRect&,constColor&,constColor&,LinearGradientMode) method (gdiplusbrush.h)

Artikel
08/23/2023

Membuat objek LinearGradientBrush::LinearGradientBrush berdasarkan persegi panjang dan mode arah.

Sintaks

void LinearGradientBrush(
  [in, ref] const Rect &       rect,
  [in, ref] const Color &      color1,
  [in, ref] const Color &      color2,
  [in]      LinearGradientMode mode
);

Parameter

[in, ref] rect

Jenis: const Rect

Referensi ke persegi panjang yang menentukan titik awal dan akhir gradien. Arah gradien, yang ditentukan oleh mode, memengaruhi bagaimana titik-titik ini ditentukan. Dimensi persegi panjang memengaruhi arah gradien untuk mode diagonal maju dan mode diagonal mundur.

[in, ref] color1

Jenis: const Color

Referensi ke objek Warna yang menentukan warna pada garis batas awal sikat gradien linier ini.

[in, ref] color2

Jenis: const Color

Referensi ke objek Warna yang menentukan warna pada garis batas akhir dari sikat gradien linier ini.

[in] mode

Jenis: LinearGradientMode

Elemen enumerasi LinearGradientMode yang menentukan arah gradien.

Nilai kembali

Tidak ada

Keterangan

Batas awal gradien adalah garis lurus yang melewati titik awal atau batas rekor persegi panjang. Batas akhir gradien adalah garis lurus yang sejajar dengan garis batas awal dan yang melewati titik akhir atau batas persegi panjang. "Garis arah," garis lurus imajiner, tegak lurus ke garis batas. Warna gradien konstan sepanjang garis yang sejajar dengan garis batas. Gradien secara bertahap berubah dari warna awal ke warna akhir di sepanjang garis arah.

Mode ini memengaruhi batas gradien:

Mode vertikal Garis batas sejajar dengan bagian atas (dan bawah) dari rect persegi panjang. Garis batas awal dan akhir adalah bagian atas dan bawah, masing-masing, dari rect persegi panjang.
Mode horizontal Garis batas sejajar dengan kiri (dan kanan) dari rect persegi panjang. Garis batas awal dan akhir adalah kiri dan kanan, masing-masing, dari rect persegi panjang.
Mode diagonal maju Garis batas sejajar dengan garis diagonal yang ditentukan oleh sudut kanan atas dan sudut kiri bawah rect persegi panjang. Garis batas awal melewati titik awal (sudut kiri atas rect persegi panjang). Garis batas akhir melewati titik akhir (sudut kanan bawah rect persegi panjang). Perhatikan bahwa titik awal dan akhir berlawanan dengan titik awal dan akhir untuk mode diagonal mundur.
Mode diagonal mundur Garis batas sejajar dengan garis diagonal yang ditentukan oleh sudut kiri atas dan sudut kanan bawah rect persegi panjang. Garis batas awal melewati titik awal (sudut kanan atas rect persegi panjang). Garis batas akhir melewati titik akhir (sudut kiri bawah rect persegi panjang). Perhatikan bahwa titik awal dan akhir berlawanan dengan titik awal dan akhir untuk mode diagonal maju.

Contoh

Contoh berikut membuat kuas gradien linier menggunakan LinearGradientModeVertical untuk pengaturan mode.

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

   LinearGradientBrush linGrBrush(
      Rect(20, 10, 200, 100),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      LinearGradientModeVertical);
   myGraphics.FillRectangle(&linGrBrush, 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	gdiplusbrush.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll