Metodo IUIAnimationStoryboard::RepeatBetweenKeyframes (uianimation.h)

Articolo
03/03/2024

Crea un ciclo tra due fotogrammi chiave specificati.

Sintassi

HRESULT RepeatBetweenKeyframes(
  [in] UI_ANIMATION_KEYFRAME startKeyframe,
  [in] UI_ANIMATION_KEYFRAME endKeyframe,
  [in] INT32                 repetitionCount
);

Parametri

[in] startKeyframe

Fotogramma chiave in corrispondenza del quale deve iniziare il ciclo.

[in] endKeyframe

Fotogramma chiave in corrispondenza del quale il ciclo deve terminare. Non è possibile che endKeyframe venga eseguito in precedenza nello storyboard rispetto a startKeyframe.

[in] repetitionCount

Numero di volte in cui il ciclo deve essere ripetuto; questo parametro deve essere 0 o un numero positivo. Usare UI_ANIMATION_REPEAT_INDEFINITELY (-1) per ripetere il ciclo indefinito fino a quando il storyboard non viene tagliato o concluso.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore dell'animazione di Windows .

Codice restituito	Descrizione
UI_E_START_KEYFRAME_AFTER_END	Il fotogramma chiave iniziale potrebbe verificarsi dopo il fotogramma chiave finale.
UI_E_END_KEYFRAME_NOT_DETERMINED	Potrebbe non essere possibile determinare l'ora dell'intervallo di chiavi finale quando viene raggiunto il fotogramma chiave iniziale.
UI_E_LOOPS_OVERLAP	Due parti ripetute di uno storyboard potrebbero sovrapporsi.

Commenti

Questo metodo indirizza un storyboard per riprodurre l'intervallo tra i fotogrammi chiave specificati ripetutamente prima di riprodurre il resto dello storyboard. Se viene specificato un conteggio di ripetizioni finito, il ciclo esegue sempre il numero di volte. Se viene specificato UI_ANIMATION_REPEAT_INDEFINITELY (-1), il ciclo viene ripetuto fino a quando non viene concluso lo storyboard, nel qual caso l'iterazione corrente del ciclo viene completata e il resto dei giochi dello storyboard. Un storyboard che scorre in modo indefinito termina anche se viene troncato.

I cicli annidati e sovrapposti non sono supportati.

Un fotogramma chiave rappresenta un momento in tempo all'interno di uno storyboard e può essere usato per specificare gli orari di inizio o fine delle transizioni. Poiché i fotogrammi chiave possono essere aggiunti alla fine delle transizioni, gli offset dall'inizio del storyboard potrebbero non essere noti finché non viene riprodotto lo storyboard.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	uianimation.h
DLL	UIAnimation.dll

Vedi anche

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddKeyframeAtOffset

Condividi tramite