PathGradientBrush::Metode GetTransform (gdipluspath.h)

Artikel
08/24/2023

Metode PathGradientBrush::GetTransform mendapatkan matriks transformasi dari jalur ini sikat gradien.

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 PathGradientBrush mempertahankan matriks transformasi yang dapat menyimpan transformasi affine apa pun. Ketika Anda menggunakan kuas gradien jalur untuk mengisi area, GDI+ mengubah jalur batas kuas sesuai dengan matriks transformasi kuas dan kemudian mengisi interior jalur yang diubah. Jalur yang diubah hanya ada selama penyajian; jalur batas yang disimpan dalam objek PathGradientBrush tidak diubah.

Contoh

Contoh berikut membuat objek PathGradientBrush berdasarkan array tiga titik. Metode PathGradientBrush::ScaleTransform dan PathGradientBrush::TranslateTransform mengatur elemen matriks transformasi kuas sehingga matriks mewakili transformasi komposit (skala pertama, lalu terjemahkan). Transformasi komposit itu berlaku untuk jalur batas kuas, sehingga panggilan ke FillRectangle mengisi interior segitiga yang merupakan hasil penskalaan dan menerjemahkan jalur batas. Kode memanggil metode PathGradientBrush::GetTransform dari objek PathGradientBrush untuk mendapatkan matriks transformasi kuas dan kemudian memanggil metode GetElements dari objek Matrix yang diambil untuk mengisi array dengan elemen matriks.

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

   // Create a path gradient brush and set its transformation.
   Point pts[] = {Point(0, 0), Point(50, 0), Point(50, 50)};
   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.ScaleTransform(3.0f, 1.0f);
   pthGrBrush.TranslateTransform(10.0f, 30.0f, MatrixOrderAppend);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);

   // Obtain information about the path gradient brush.
   Matrix matrix;
   REAL elements[6];

   pthGrBrush.GetTransform(&matrix);
   matrix.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	gdipluspath.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll