LinearGradientBrush::SetWrapMode method (gdiplusbrush.h)

Artikel
08/23/2023

Metode LinearGradientBrush::SetWrapMode mengatur mode pembungkusan kuas gradien linier ini.

Sintaks

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parameter

[in] wrapMode

Jenis: WrapMode

Elemen enumerasi WrapMode yang menentukan bagaimana area yang dilukis dengan sikat gradien linier ini akan diurutkan. Nilai parameter ini harus menjadi salah satu elemen berikut:

WrapModeTile
WrapModeTileFlipX
WrapModeTileFlipy
WrapModeTileFlipXY

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

Garis batas kuas gradien linier membentuk petak peta. Saat Anda melukis area dengan sikat gradien linier, petak peta berulang. Kuas gradien linier mungkin memiliki petak peta alternatif yang dibalik ke arah tertentu, seperti yang ditentukan oleh mode pembungkusan. Membalik memiliki efek membalikkan urutan warna.

Mode bungkus default ke WrapModeTile saat objek LinearGradientBrush dibangun.

Contoh

Contoh berikut membuat sikat gradien linier dan menggunakannya untuk mengisi persegi panjang. Selanjutnya, kode memodifikasi mode bungkus kuas dan menggunakan kuas yang dimodifikasi untuk mengisi persegi panjang lain.

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

   LinearGradientBrush linGrBrush( 
      Rect(0, 0, 100, 50),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   // Fill a large area using the gradient brush with the default wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetWrapMode(WrapModeTileFlipX);

   // Fill a large area using the gradient brush with the new wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 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