IDCompositionVisual::SetOffsetY(IDCompositionAnimation*)-Methode (dcomp.h)

Animiert den Wert der OffsetY-Eigenschaft dieses Visuals. Die OffsetY-Eigenschaft gibt den neuen Offset des Visuals entlang der y-Achse relativ zum übergeordneten Visual an.

Syntax

HRESULT SetOffsetY(
  [in] IDCompositionAnimation *animation
);

Parameter

[in] animation

Typ: IDCompositionAnimation*

Ein Animationsobjekt, das bestimmt, wie sich der Wert der OffsetY-Eigenschaft im Laufe der Zeit ändert. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Diese Methode erstellt eine Kopie der angegebenen Animation. Wenn das Animationsobjekt, auf das vom Animationsparameter verwiesen wird, nach diesem Aufruf geändert wird, wirkt sich die Änderung nicht auf die OffsetY-Eigenschaft aus, es sei denn, diese Methode wird erneut aufgerufen. Wenn die OffsetY-Eigenschaft zuvor animiert wurde, ersetzt diese Methode diese Animation durch die neue Animation.

Diese Methode schlägt fehl, wenn die Animation ein ungültiger Zeiger ist oder nicht von derselben IDCompositionDevice-Schnittstelle erstellt wurde, die dieses Visual erstellt hat. Die Schnittstelle darf keine benutzerdefinierte Implementierung sein. Mit dieser Methode können nur schnittstellen verwendet werden, die von Microsoft DirectComposition erstellt wurden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dcomp.h
Bibliothek	Dcomp.lib
DLL	Dcomp.dll

Weitere Informationen

IDCompositionVisual

IDCompositionVisual::SetOffsetX

IDCompositionVisual::SetTransform