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

Voir aussi

IDCompositionDevice

IDCompositionTarget ::SetRoot

IDCompositionVisual ::AddVisual