MÉTHODE IDCompositionVisual3::SetTransform(IDCompositionTransform3D*) (dcomp.h)
Définit la propriété Transform de ce visuel sur l’objet de transformation 3D spécifié.
Syntaxe
HRESULT SetTransform(
[in, optional] IDCompositionTransform3D *transform
);
Paramètres
[in, optional] transform
Type : IDCompositionTransform3D*
Objet transform 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 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 la définition de la propriété Transform et des propriétés OffsetX et OffsetY est identique à la définition de la propriété Transform uniquement sur un groupe de transformations où le premier membre du groupe est un objet IDCompositionTranslateTranslateTransform qui a les mêmes valeurs OffsetX et OffsetY. Toutefois, vous devez utiliser les méthodes IDCompositionVisual::SetOffsetX et SetOffsetY chaque fois que 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 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 transform a la valeur 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 définir la propriété Transform sur NULL chaque fois que 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 le même que 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