IDCompositionRotateTransform3D::SetAxisX(IDCompositionAnimation*)-Methode (dcomp.h)

  • Artikel

Animiert den Wert der AxisX-Eigenschaft einer 3D-Drehungstransformation. Die AxisX-Eigenschaft gibt die x-Koordinate für den Achsenvektor der Drehung an. Der Standardwert ist 0 (null).

Syntax

HRESULT SetAxisX(
  [in] IDCompositionAnimation *animation
);

Parameter

[in] animation

Typ: IDCompositionAnimation*

Ein Animationsobjekt, das bestimmt, wie sich der Wert der AxisX-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

Wenn Sie die Achse auf einen nicht standardmäßigen Wert festlegen, sollten Sie immer alle drei Achseneigenschaften (AxisX, AxisY und AxisZ) festlegen.

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 AxisX-Eigenschaft aus, es sei denn, diese Methode wird erneut aufgerufen. Wenn die AxisX-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 die betroffene 3D-Transformation 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

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

IDCompositionRotateTransform3D

IDCompositionRotateTransform3D::SetAxisY

IDCompositionRotateTransform3D::SetAxisZ