IDCompositionAnimation::End-Methode (dcompanimation.h)
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 |