Metode IDirectManipulationViewport::SetViewportTransform (directmanipulation.h)

Artikel
08/23/2023

Menentukan transformasi dari sistem koordinat viewport ke sistem koordinat klien jendela.

Sintaks

HRESULT SetViewportTransform(
  [in] const float *matrix,
  [in] DWORD       pointCount
);

Parameter

[in] matrix

Matriks transformasi, dalam urutan baris:_11, _12, _21, _22, _31, _32.

[in] pointCount

Ukuran matriks transformasi. Nilai ini selalu 6, karena matriks 3x2 digunakan untuk semua transformasi manipulasi langsung.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Panggil fungsi ini untuk menentukan posisi viewport, penskalaan, dan orientasi pada layar. Posisi viewport, penskalaan, orientasi, dan ukuran ditentukan secara unik oleh transformasi viewport dan persegi panjang viewport. Aplikasi dapat menentukan transformasi viewport menggunakan metode ini, dan persegi panjang viewport menggunakan SetViewportRect.

Persegi panjang viewport (area persegi panjang di dalam konten yang terlihat oleh pengguna) ditentukan dalam koordinat viewport. Jika persegi panjang viewport titik kiri atas adalah (0,0), persegi panjang viewport diposisikan tepat di asal sistem koordinat viewport. Offset viewport dari asal sistem koordinat viewport dapat ditentukan dengan dua cara:

Melalui persegi panjang viewport titik kiri atas
Melalui komponen terjemahan transformasi viewport (_31, _32)

Transformasi viewport dikonversi dari sistem koordinat viewport ke sistem koordinat klien jendela. Manipulasi Langsung mengabaikan properti RTL jendela, sehingga asal area klien selalu menjadi titik kiri atas. Transformasi diterapkan dalam urutan berikut:

Offset persegi panjang viewport
Transformasi viewport (dari viewport ke sistem koordinat klien)
Pemetaan klien ke layar (dari klien ke sistem koordinat layar)

Persyaratan


Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	directmanipulation.h

Lihat juga

IDirectManipulationViewport

Bagikan melalui