MÉTHODE IDCompositionVisual::SetTransform(IDCompositionTransform*) (dcomp.h)

Article
08/23/2023

Définit la propriété Transform de ce visuel sur l’objet de transformation 2D spécifié.

Syntaxe

HRESULT SetTransform(
  [in, optional] IDCompositionTransform *transform
);

Paramètres

[in, optional] transform

Type : IDCompositionTransform*

Objet de transformation utilisé pour modifier le système de coordonnées de ce visuel. Ce paramètre peut pointer vers une interface IDCompositionTransform ou l’une de ses interfaces dérivées. 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 .

Notes

La définition de la propriété Transform transforme le système de coordonnées de l’ensemble de la sous-arborescence visuelle qui est enracinée sur ce visuel. Si la propriété Clip de ce visuel est spécifiée, le rectangle de clip est également transformé.

Si la propriété Transform a précédemment spécifié une matrice de transformation, l’objet transform nouvellement spécifié remplace la matrice de transformation.

Une transformation spécifiée par la propriété Transform est appliquée après les propriétés OffsetX et OffsetY. En d’autres termes, l’effet de définir la propriété Transform et les propriétés OffsetX et OffsetY est le même que de définir uniquement la propriété Transform sur un groupe de transformations où le premier membre du groupe est un objet IDCompositionTranslateTransform qui a les mêmes valeurs OffsetX et OffsetY. Toutefois, vous devez utiliser les méthodes IDCompositionVisual::SetOffsetX et SetOffsetY dans la mesure du possible, car elles sont légèrement plus rapides.

Cette méthode échoue si la transformation est un pointeur non valide ou si elle n’a pas été créée par la même interface IDCompositionDevice que celle qui a créé ce visuel. L’interface ne peut pas être une implémentation personnalisée ; seules les interfaces créées par Microsoft DirectComposition peuvent être utilisées avec cette méthode.

Si le paramètre de transformation est NULL, le système de coordonnées de ce visuel est transformé uniquement par ses propriétés OffsetX et OffsetY. Définir la propriété Transform sur NULL revient à la définir sur un objet IDCompositionMatrixTransform où la matrice spécifiée est la matrice d’identité. Toutefois, une application doit affecter la valeur NULL à la propriété Transform dans la mesure du possible, car elle est légèrement plus rapide.

Si les propriétés OffsetX et OffsetY ont la valeur 0 et que la propriété Transform a la valeur NULL, le système de coordonnées du visuel est identique à celui de son parent.

Spécifications


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