METODE IDCompositionVisual3::SetTransform(IDCompositionTransform3D*) (dcomp.h)

Artikel
08/23/2023

Mengatur properti Transformasi visual ini ke objek transformasi 3D yang ditentukan.

Sintaks

HRESULT SetTransform(
  [in, optional] IDCompositionTransform3D *transform
);

Parameter

[in, optional] transform

Jenis: IDCompositionTransform3D*

Objek transformasi yang digunakan untuk memodifikasi sistem koordinat visual ini. Parameter ini dapat menunjuk ke antarmuka IDCompositionTransform atau salah satu antarmuka turunannya. Parameter ini bisa NULL.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.

Keterangan

Mengatur properti Transformasi mengubah sistem koordinat seluruh subtree visual yang berakar pada visual ini. Jika properti Klip visual ini ditentukan, persegi panjang klip juga diubah.

Jika properti Transformasi sebelumnya menentukan matriks transformasi, objek transformasi yang baru ditentukan menggantikan matriks transformasi.

Transformasi yang ditentukan oleh properti Transformasi diterapkan setelah properti OffsetX dan OffsetY. Dengan kata lain, efek pengaturan properti Transformasi dan properti OffsetX dan OffsetY sama dengan mengatur hanya properti Transformasi pada grup transformasi di mana anggota pertama grup adalah objek IDCompositionTranslateTransform yang memiliki nilai OffsetX dan OffsetY yang sama. Namun, Anda harus menggunakan metode IDCompositionVisual::SetOffsetX dan SetOffsetY jika memungkinkan karena sedikit lebih cepat.

Metode ini gagal jika transformasi adalah penunjuk yang tidak valid atau jika tidak dibuat oleh antarmuka IDCompositionDevice yang sama yang membuat visual ini. Antarmuka tidak boleh berupa implementasi kustom; hanya antarmuka yang dibuat oleh Microsoft DirectComposition yang dapat digunakan dengan metode ini.

Jika parameter transformasi adalah NULL, sistem koordinat visual ini hanya diubah oleh properti OffsetX dan OffsetY-nya. Mengatur properti Transformasi ke NULL setara dengan mengaturnya ke objek IDCompositionMatrixTransform di mana matriks yang ditentukan adalah matriks identitas. Namun, aplikasi harus mengatur properti Transformasi ke NULL jika memungkinkan karena sedikit lebih cepat.

Jika properti OffsetX dan OffsetY diatur ke 0, dan properti Transformasi diatur ke NULL, sistem koordinat visual sama dengan induknya.

Persyaratan


Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	dcomp.h
Pustaka	Dcomp.lib
DLL	Dcomp.dll