IDCompositionScaleTransform3D::SetCenterZ(IDCompositionAnimation*)-Methode (dcomp.h)

Animiert den Wert der CenterZ-Eigenschaft einer 3D-Skalierungstransformation. Die CenterZ-Eigenschaft gibt die Z-Koordinate des Punkts an, über den die Skalierung durchgeführt wird.

Syntax

HRESULT SetCenterZ(
  [in] IDCompositionAnimation *animation
);

Parameter

[in] animation

Typ: IDCompositionAnimation*

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

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. 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 Aufruf dieser Methode geändert wird, wirkt sich die Änderung nicht auf die CenterZ-Eigenschaft aus, es sei denn, diese Methode wird erneut aufgerufen. Wenn die CenterZ-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 kann keine benutzerdefinierte Implementierung sein. mit dieser Methode können nur schnittstellen verwendet werden, die von Microsoft DirectComposition erstellt wurden.

Anforderungen

Weitere Informationen

IDCompositionScaleTransform3D

IDCompositionScaleTransform3D::SetCenterX

IDCompositionScaleTransform3D::SetCenterY