IDCompositionAnimation::End-Methode (dcompanimation.h)

  • Artikel

Fügt ein Endsegment hinzu, das das Ende einer Animationsfunktion markiert.

Syntax

HRESULT End(
  [in] double endOffset,
  [in] float  endValue
);

Parameter

[in] endOffset

Typ: double

Der Offset in Sekunden vom Anfang der Animationsfunktion bis zum Ende der Funktion.

[in] endValue

Typ: float

Der endgültige Wert der Animation.

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 der angegebene Offset erreicht ist, werden die von dieser Animation betroffenen Eigenschaften auf den angegebenen Endwert festgelegt, und dann wird die Animation beendet. Wenn kein Endsegment hinzugefügt wird, wird das letzte Segment der Animationsfunktion unbegrenzt ausgeführt. Das Aufrufen dieser Methode ist semantisch identisch damit, dass das letzte Segment der Animationsfunktion ein kubisches Polynom wird, wobei die kubischen, quadratischen und linearen Koeffizienten alle Nullen sind und der konstante Koeffizienten der gewünschte Endwert ist.

Da Animationssegmente in zunehmender Reihenfolge hinzugefügt werden müssen, schlägt diese Methode fehl, wenn der endOffset-Parameter kleiner oder gleich dem beginOffset-Parameter des vorherigen Segments ist. Diese Methode schlägt auch fehl, wenn dies das erste Segment ist, das der Animationsfunktion hinzugefügt wird.

Nachdem diese Methode aufgerufen wurde, schlagen alle Methoden für dieses Animationsobjekt fehl, mit Ausnahme der IDCompositionAnimation::Reset-Methode .

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dcompanimation.h
Bibliothek Dcomp.lib
DLL Dcomp.dll

Weitere Informationen

IDCompositionAnimation