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

Vedi anche

IDCompositionAnimation