IDCompositionDevice ::CreateVisual, méthode (dcomp.h)
Crée un objet visuel.
Syntaxe
HRESULT CreateVisual(
[out] IDCompositionVisual **visual
);
Paramètres
[out] visual
Type : IDCompositionVisual**
Nouvel objet visuel. Ce paramètre ne doit pas avoir la valeur 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 nouvel objet visuel a une valeur statique zéro pour les propriétés OffsetX et OffsetY, et NULL pour les propriétés Transform, Clip et Content. Initialement, le visuel n’entraîne pas de modification du contenu d’une fenêtre. Le visuel doit être ajouté en tant qu’enfant d’un autre visuel, ou en tant que racine d’une cible de composition, avant qu’il ne puisse affecter l’apparence d’une fenêtre.
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 |