TextureBrush::Metode SetTransform (gdiplusbrush.h)

Artikel
08/24/2023

Metode TextureBrush::SetTransform mengatur matriks transformasi kuas tekstur ini.

Sintaks

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

Parameter

[in] matrix

Jenis: const Matrix*

Penunjuk ke objek Matriks yang menentukan matriks transformasi yang akan digunakan.

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 TextureBrush mempertahankan matriks transformasi yang dapat menyimpan transformasi affine apa pun. Ketika Anda menggunakan kuas tekstur untuk mengisi area, Windows GDI+ mengubah gambar kuas sesuai dengan matriks transformasi kuas dan kemudian mengisi area. Gambar yang diubah hanya ada selama penyajian; gambar yang disimpan dalam objek TextureBrush tidak diubah. Misalnya, Anda memanggil dan kemudian melukis area dengan someTextureBrush.ScaleTransform(3) dan kemudian melukis area dengan someTextureBrush. Lebar gambar kuas tiga kali lipat ketika area dicat, tetapi gambar yang disimpan di someTextureBrush tetap tidak berubah.

Contoh

Contoh berikut membuat kuas tekstur dan mengatur transformasi kuas. Kode kemudian menggunakan kuas yang diubah untuk mengisi elips.

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

   Matrix matrix(2, 0, 0, 1, 0, 0);  // Horizontal stretch

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetTransform(&matrix);
   graphics.FillEllipse(&textureBrush, 0, 0, 400, 200); 
}

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