LinearGradientBrush::Metode SetTransform (gdiplusbrush.h)

Artikel
02/26/2024

Metode LinearGradientBrush::SetTransform mengatur matriks transformasi sikat gradien linier ini.

Sintaks

Status SetTransform(
  [in] const Matrix *matrix
);

Parameter

[in] matrix

Jenis: const Matrix*

Penunjuk ke objek Matriks yang menentukan matriks transformasi.

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

Objek LinearGradientBrush memiliki persegi panjang yang menentukan batas awal dan akhir gradien dan mode atau sudut yang memengaruhi arah. Jika matriks transformasi kuas diatur untuk mewakili transformasi apa pun selain identitas, maka batas dan arah diubah sesuai dengan matriks tersebut selama penyajian.

Transformasi hanya berlaku selama penyajian. Batas yang disimpan oleh objek LinearGradientBrush tidak diubah oleh metode LinearGradientBrush::SetTransform .

Contoh

Contoh berikut membuat sikat gradien linier dan menggunakannya untuk mengisi persegi panjang. Selanjutnya, kode memodifikasi matriks transformasi kuas dan mengisi persegi panjang dengan kuas yang diubah.

VOID Example_SetTransform(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);

   Matrix matrix(2.0, 0, 0, 1, 0, 0);  // horizontal doubling

   // Fill a large area with the linear gradient brush (no transformation).
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetTransform(&matrix);

   // Fill a large area with the transformed linear gradient brush.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}

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