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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | dcomp.h |
| Bibliothèque | Dcomp.lib |
| DLL | Dcomp.dll |