IDCompositionScaleTransform::SetScaleX(IDCompositionAnimation*)-Methode (dcomp.h)

Animiert den Wert der ScaleX-Eigenschaft einer 2D-Skalierungstransformation. Die ScaleX-Eigenschaft gibt den Skalierungsfaktor entlang der x-Achse an.

Syntax

HRESULT SetScaleX(
  [in] IDCompositionAnimation *animation
);

Parameter

[in] animation

Typ: IDCompositionAnimation*

Ein Animationsobjekt, das bestimmt, wie sich der Wert der ScaleX-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 HRESULT-Fehlercode zurückgegeben. Weitere Informationen finden Sie unter DirectComposition-Fehlercodes für eine Liste der Fehlercodes.

Hinweise

Diese Methode macht eine Kopie der angegebenen Animation. Wenn das objekt, auf das der Animationsparameter verwiesen wird, nach dem Aufrufen dieser Methode geändert wird, wirkt sich die Änderung nicht auf die ScaleX-Eigenschaft aus, es sei denn, diese Methode wird erneut aufgerufen. Wenn die ScaleX-Eigenschaft zuvor animiert wurde, ersetzt das Aufrufen dieser Methode die vorherige Animation durch die neue Animation.

Diese Methode schlägt fehl, wenn Animation ein ungültiger Zeiger ist oder nicht von derselben IDCompositionDevice-Schnittstelle wie die betroffene visuelle Schnittstelle erstellt wurde. Die Schnittstelle kann keine benutzerdefinierte Implementierung sein; Nur von Microsoft DirectComposition erstellte Schnittstellen können mit dieser Methode verwendet werden.

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

IDCompositionScaleTransform

IDCompositionScaleTransform::SetScaleY