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

Voir aussi

IDCompositionVisual

IDCompositionVisual::SetOffsetY

IDCompositionVisual::SetTransform