IDCompositionVisual::SetOffsetX(float), méthode (dcomp.h)
Modifie la valeur de la propriété OffsetX de ce visuel. La propriété OffsetX spécifie le nouveau décalage du visuel le long de l’axe X, par rapport au visuel parent.
Syntaxe
HRESULT SetOffsetX(
[in] float offsetX
);
Paramètres
[in] offsetX
Type : float
Nouveau décalage du visuel le long de l’axe X, en pixels.
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
Cette méthode échoue si le paramètre offsetX est NaN, l’infini positif ou l’infini négatif.
La modification de la propriété OffsetX d’un visuel 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é.
Une transformation spécifiée par la propriété Transform est appliquée après la propriété OffsetX. En d’autres termes, l’effet de définir la propriété Transform et la propriété OffsetX est le même que de définir uniquement la propriété Transform sur un objet de groupe de transformations où le premier membre du groupe est un objet IDCompositionTranslateTranslateTransform qui a la même valeur OffsetX que offsetX. Toutefois, vous devez utiliser IDCompositionVisual::SetOffsetX dans la mesure du possible, car il 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.
Si la propriété OffsetX était précédemment animée, cette méthode supprime l’animation et affecte à la propriété la valeur statique spécifiée.
Exemples
Pour obtenir un exemple, consultez How to Build a Simple Visual Tree.
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 |