METODE IDCompositionVisual::SetTransformParent (dcomp.h)

Mengatur properti TransformParent dari visual ini. Properti TransformParent menetapkan sistem koordinat relatif terhadap visual ini.

Sintaks

HRESULT SetTransformParent(
  [in, optional] IDCompositionVisual *visual
);

Parameter

[in, optional] visual

Jenis: IDCompositionVisual*

Visual baru yang menetapkan sistem koordinat dasar untuk visual ini. Parameter ini bisa NULL.

Nilai kembali

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

Sistem koordinat visual dimodifikasi oleh properti OffsetX, OffsetY, dan Transformasi. Biasanya, properti ini mendefinisikan sistem koordinat visual relatif terhadap induk langsungnya. Metode ini menentukan visual relatif terhadap sistem koordinat untuk visual ini. Visual yang ditentukan harus menjadi leluhur dari visual saat ini. Jika bukan leluhur, sistem koordinat didasarkan pada induk langsung visual ini, sama seperti jika properti TransformParent diatur ke NULL. Karena visual dapat direparentasi, properti ini dapat berlaku lagi jika visual yang ditentukan menjadi leluhur visual target melalui operasi reparenting.

Jika parameter visual adalah NULL, sistem koordinat selalu diubah relatif terhadap induk langsung visual. Ini adalah perilaku default jika metode ini tidak digunakan.

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

Persyaratan

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

Lihat juga

IDCompositionVisual