PathGradientBrush::SetWrapMode method (gdipluspath.h)

Artikel
08/24/2023

Metode PathGradientBrush::SetWrapMode mengatur mode pembungkusan sikat gradien jalur ini.

Sintaks

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parameter

[in] wrapMode

Jenis: WrapMode

Elemen enumerasi WrapMode yang menentukan bagaimana area yang dicat dengan jalur sikat gradien akan diratakan. Nilai defaultnya adalah WrapModeClamp.

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

Persegi panjang pembatas kuas gradien jalur adalah persegi panjang terkecil yang mencakup jalur batas kuas. Saat Anda mengecat persegi panjang pembatas dengan kuas gradien jalur, hanya area di dalam jalur batas yang akan diisi. Area di dalam persegi panjang pembatas tetapi di luar jalur batas tidak terisi.

WrapModeClamp (mode bungkus default) menunjukkan bahwa tidak ada lukisan yang terjadi di luar persegi panjang pembatas kuas. Semua mode bungkus lainnya menunjukkan bahwa area di luar persegi panjang pembatas kuas akan diratakan. Setiap petak peta adalah salinan (mungkin membalik) jalur yang diisi di dalam persegi panjang pembatasnya.

Contoh

Contoh berikut membuat objek PathGradientBrush berdasarkan jalur segitiga. Kode memanggil metode PathGradientBrush::SetWrapMode dari objek PathGradientBrush untuk mengatur mode bungkus kuas ke WrapModeTileFlipX. Metode Graphics::FillRectangle menggunakan jalur sikat gradien untuk memiringkan area yang luas.

Output kode adalah kisi petak peta. Saat Anda berpindah dari satu petak peta ke petak berikutnya dalam baris tertentu, gambar (jalur batas yang diisi di dalam persegi panjang pembatas) dibalik secara horizontal.

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

   Point points[] = {
      Point(0, 0), 
      Point(100, 0), 
      Point(100, 100)};

   Color colors[] = {
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      Color(255, 0, 255, 0)};  // green

   INT count = 3;

   PathGradientBrush pthGrBrush(points, 3);
   pthGrBrush.SetSurroundColors(colors, &count);
   pthGrBrush.SetWrapMode(WrapModeTileFlipX);

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

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