IDCompositionTarget ::SetRoot, méthode (dcomp.h)

Définit un objet visuel comme nouvel objet racine d’une arborescence visuelle.

Syntaxe

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

Paramètres

[in, optional] visual

Type : IDCompositionVisual*

Objet visuel qui est la nouvelle racine de cette arborescence visuelle. Ce paramètre peut être NULL.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Remarques

Un visuel peut être soit la racine d’une seule arborescence visuelle, soit l’enfant d’un autre visuel, mais il ne peut pas être les deux en même temps. Cette méthode échoue si le paramètre visuel est déjà à la racine d’une autre arborescence visuelle ou s’il est enfant d’un autre visuel.

Si le visuel a la valeur NULL, l’arborescence du visuel est vide. S’il existait un visuel racine non NULL précédent, ce visuel devient disponible pour être utilisé comme racine d’une autre arborescence visuelle ou comme enfant d’un autre visuel.

Exemples

Pour obtenir un exemple, consultez Création d’une arborescence visuelle simple.

Configuration requise

Voir aussi

IDCompositionDevice ::CreateVisual

IDCompositionTarget