Bagikan melalui


LinearGradientBrush::Metode SetTransform (gdiplusbrush.h)

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

Lihat juga

Kuas dan Bentuk Terisi

Membuat Gradien Linear

Mengisi Bentuk dengan Sikat Gradien

LinearGradientBrush

LinearGradientBrush::GetTransform

LinearGradientBrush::ResetTransform

Matrix

Representasi Transformasi Matriks

Rect

Transformasi