Metodo IDCompositionAnimation::End (dcompanimation.h)
Aggiunge un segmento finale che contrassegna la fine di una funzione di animazione.
Sintassi
HRESULT End(
[in] double endOffset,
[in] float endValue
);
Parametri
[in] endOffset
Tipo: double
Offset, in secondi, dall'inizio della funzione di animazione al punto in cui termina la funzione.
[in] endValue
Tipo: float
Valore finale dell'animazione.
Valore restituito
Tipo: HRESULT
Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore DirectComposition .
Commenti
Quando viene raggiunto l'offset specificato, la proprietà o le proprietà interessate da questa animazione vengono impostate sul valore finale specificato e quindi l'animazione si arresta. Se non viene aggiunto alcun segmento finale, il segmento finale della funzione di animazione viene eseguito in modo indefinito. La chiamata a questo metodo è semanticamente identica a rendere l'ultimo segmento della funzione di animazione un polinomio cubico in cui i coefficienti cubi, quadrati e lineari sono tutti zero e il coefficiente costante è il valore finale desiderato.
Poiché i segmenti di animazione devono essere aggiunti in ordine crescente, questo metodo ha esito negativo se il parametro endOffset è minore o uguale al parametro beginOffset del segmento precedente. Questo metodo ha esito negativo anche se si tratta del primo segmento da aggiungere alla funzione di animazione.
Dopo aver chiamato questo metodo, tutti i metodi di questo oggetto di animazione hanno esito negativo, ad eccezione del metodo IDCompositionAnimation::Reset .
Requisiti
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | dcompanimation.h |
| Libreria | Dcomp.lib |
| DLL | Dcomp.dll |