IDCompositionTranslateTransform3D::SetOffsetY(IDCompositionAnimation*)-Methode (dcomp.h)
Animiert den Wert der OffsetY-Eigenschaft eines 3D-Übersetzungstransformationseffekts. Die OffsetY-Eigenschaft gibt den Abstand an, der entlang der y-Achse übersetzt werden soll.
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 Objekt, auf das vom Animationsparameter verwiesen wird, nach dem Aufrufen dieser Methode 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 das Aufrufen dieser Methode die vorherige Animation durch die neue Animation.
Diese Methode schlägt fehl, wenn die Animation ein ungültiger Zeiger ist oder nicht von derselben IDCompositionDevice-Schnittstelle wie das betroffene Visual erstellt wurde. Die Schnittstelle darf keine benutzerdefinierte Implementierung sein. Mit dieser Methode können nur schnittstellen verwendet werden, die von Microsoft DirectComposition erstellt wurden.
Anforderungen
Anforderung | Wert |
---|---|
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
IDCompositionTranslateTransform3D