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 |