IDCompositionScaleTransform3D::SetScaleZ(float)-Methode (dcomp.h)

Ändert den Wert der ScaleZ-Eigenschaft einer 3D-Skalierungstransformation. Die ScaleZ-Eigenschaft gibt den Skalierungsfaktor entlang der Z-Achse an.

Syntax

HRESULT SetScaleZ(
  [in] float scaleZ
);

Parameter

[in] scaleZ

Typ: float

Der neue Z-Achsen-Skalierungsfaktor.

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 schlägt fehl, wenn der scaleZ-Parameter NaN, positive Unendlichkeit oder negative Unendlichkeit ist.

Wenn die ScaleZ-Eigenschaft zuvor animiert wurde, entfernt diese Methode die Animation und legt die ScaleZ-Eigenschaft auf den angegebenen statischen Wert fest.

Anforderungen

Weitere Informationen

IDCompositionScaleTransform3D

IDCompositionScaleTransform3D::SetScaleX

IDCompositionScaleTransform3D::SetScaleY