LinearGradientBrush::Metode GetTransform (gdiplusbrush.h)

Artikel
08/23/2023

Metode LinearGradientBrush::GetTransform mendapatkan matriks transformasi dari sikat gradien linier ini.

Sintaks

Status GetTransform(
  [out] Matrix *matrix
);

Parameter

[out] matrix

Jenis: Matriks*

Penunjuk ke objek Matriks yang menerima matriks transformasi.

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

Objek LinearGradientBrush mempertahankan matriks transformasi yang dapat menyimpan transformasi affine apa pun. Ketika Anda menggunakan sikat gradien linier untuk mengisi area, GDI + mengubah garis batas kuas sesuai dengan matriks transformasi kuas dan kemudian mengisi area. Batas yang diubah hanya ada selama penyajian; batas yang disimpan dalam objek LinearGradientBrush tidak diubah.

Contoh

Contoh berikut membuat sikat gradien linier dan mengatur matriks transformasinya. Selanjutnya, kode mendapatkan matriks transformasi kuas dan melanjutkan untuk memeriksa atau menggunakan elemen matriks.

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

   // Construct a linear gradient brush, and set its transformation.
   LinearGradientBrush linGrBrush( 
      Point(0, 0),
      Point(200, 0),
      Color(255, 255, 0, 0),    // red
      Color(255, 0, 0, 255));   // blue

   Matrix matrixSet(0, 1, -1, 0, 0, 0);

   linGrBrush.SetTransform(&matrixSet);

   // Obtain information about the linear gradient brush.
   Matrix matrixGet;
   REAL   elements[6];

   linGrBrush.GetTransform(&matrixGet);
   matrixGet.GetElements(elements);  

   for(INT j = 0; j <= 5; ++j)
   {
       // Inspect or use the value in elements[j].
   }
}

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