METODE IDCompositionTarget::SetRoot (dcomp.h)

Mengatur objek visual sebagai objek akar baru dari pohon visual.

Sintaks

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

Parameter

[in, optional] visual

Jenis: IDCompositionVisual*

Objek visual yang merupakan akar baru dari pohon 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

Visual dapat berupa akar pohon visual tunggal, atau anak dari visual lain, tetapi tidak dapat keduanya secara bersamaan. Metode ini gagal jika parameter visual sudah menjadi akar pohon visual lain, atau merupakan anak dari visual lain.

Jika visual NULL, pohon visual kosong. Jika ada visual akar non-NULL sebelumnya, visual tersebut tersedia untuk digunakan sebagai akar pohon visual lain, atau sebagai anak dari visual lain.

Contoh

Misalnya, lihat Cara Membangun Pohon Visual Sederhana.

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

IDCompositionDevice::CreateVisual

IDCompositionTarget