Grafis::Metode TranslateTransform (gdiplusgraphics.h)

Artikel
03/14/2023

Metode Graphics::TranslateTransform memperbarui matriks transformasi dunia objek Grafis ini dengan produk itu sendiri dan matriks terjemahan.

Sintaks

Status TranslateTransform(
  [in]           REAL        dx,
  [in]           REAL        dy,
  [in, optional] MatrixOrder order
);

Parameter

[in] dx

Jenis: NYATA

Angka riil yang menentukan komponen horizontal terjemahan.

[in] dy

Jenis: NYATA

Angka riil yang menentukan komponen vertikal terjemahan.

[in, optional] order

Jenis: MatrixOrder

Opsional. Elemen enumerasi MatrixOrder yang menentukan urutan perkalian. MatrixOrderPrepend menentukan bahwa matriks terjemahan berada di sebelah kiri, dan MatrixOrderAppend menentukan bahwa matriks terjemahan berada di sebelah kanan. Nilai defaultnya adalah MatrixOrderPrepend.

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

Catatan GDI+ menangani kuas secara berbeda ketika skala transformasi dunia kurang dari 100%(1,0f) ke arah x atau y. Jika skala transformasi dunia kurang dari 100%(1,0f), pastikan untuk mengalikan offset untuk TranslateTransform oleh skala transformasi dunia.

Contoh

Contoh berikut mengatur transformasi dunia objek Grafis ke rotasi. Panggilan ke Grafis::TranslateTransform mengalikan matriks transformasi dunia (rotasi) objek Grafis yang ada dengan matriks terjemahan. Argumen MatrixOrderAppend menentukan bahwa perkalian dilakukan dengan matriks terjemahan di sebelah kanan. Pada titik itu, matriks transformasi dunia objek Grafis mewakili transformasi komposit: putar terlebih dahulu, lalu terjemahkan. Panggilan ke DrawEllipse menggambar elips yang diputar dan diterjemahkan.

VOID Example_TranslateTransform(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 255));

   graphics.RotateTransform(30.0f);
   graphics.TranslateTransform(100.0f, 50.0f, MatrixOrderAppend);
   graphics.DrawEllipse(&pen, 0, 0, 200, 80);
}

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	gdiplusgraphics.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll