Freigeben über


IDCompositionTranslateTransform3D::SetOffsetZ(float)-Methode (dcomp.h)

Ändert den Wert der OffsetZ-Eigenschaft eines Transformationseffekts für die 3D-Übersetzung. Die OffsetZ-Eigenschaft gibt den Abstand an, der entlang der Z-Achse übersetzt werden soll.

Syntax

HRESULT SetOffsetZ(
  [in] float offsetZ
);

Parameter

[in] offsetZ

Typ: float

Der zu übersetzende Abstand entlang der Z-Achse in Pixel.

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 offsetZ-Parameter NaN, positive Unendlichkeit oder negative Unendlichkeit ist.

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

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

IDCompositionTranslateTransform3D

IDCompositionTranslateTransform3D::SetOffsetX

IDCompositionTranslateTransform3D::SetOffsetY