Metode LinearGradientBrush::SetInterpolationColors (gdiplusbrush.h)

Artikel
02/26/2024

Metode LinearGradientBrush::SetInterpolationColors mengatur warna yang akan diinterpolasi untuk kuas gradien linier ini dan posisi campuran yang sesuai.

Sintaks

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

Parameter

[in] presetColors

Jenis: const Color*

Penunjuk ke array objek Warna yang menentukan warna yang akan diinterpolasi untuk sikat gradien linier ini. Warna indeks tertentu dalam array presetColors sesuai dengan posisi campuran indeks yang sama dalam array blendPositions .

[in] blendPositions

Jenis: const REAL*

Penunjuk ke array bilangan riil yang menentukan posisi campuran. Setiap angka dalam array menentukan persentase jarak antara batas awal dan batas akhir dan berada dalam rentang dari 0,0 hingga 1,0, di mana 0,0 menunjukkan batas awal gradien dan 1,0 menunjukkan batas akhir. Harus ada setidaknya dua posisi yang ditentukan: posisi pertama, yaitu selalu 0,0f, dan posisi terakhir, yaitu selalu 1,0f. Jika tidak, perilaku tidak ditentukan. Posisi campuran antara 0,0 dan 1,0 menunjukkan garis, paralel dengan garis batas, yang merupakan pecahan jarak tertentu dari batas awal ke batas akhir. Misalnya, posisi campuran 0,7 menunjukkan garis yang 70 persen dari jarak dari batas awal ke batas akhir. Warnanya konstan pada garis yang sejajar dengan garis batas.

[in] count

Jenis: INT

Bilangan bulat yang menentukan jumlah elemen dalam array presetColors . Ini sama dengan jumlah elemen dalam array blendPositions .

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 .

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