MÉTHODE IDCompositionVisual::SetTransform(IDCompositionTransform*) (dcomp.h)
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 |
Voir aussi
IDCompositionTranslateTransform