Metodo IUIAnimationStoryboard2::RepeatBetweenKeyframes (uianimation.h)

Articolo
03/03/2024

Crea un ciclo tra due fotogrammi chiave.

Sintassi

HRESULT RepeatBetweenKeyframes(
  [in] UI_ANIMATION_KEYFRAME                   startKeyframe,
  [in] UI_ANIMATION_KEYFRAME                   endKeyframe,
  [in] DOUBLE                                  cRepetition,
  [in] UI_ANIMATION_REPEAT_MODE                repeatMode,
  [in] IUIAnimationLoopIterationChangeHandler2 *pIterationChangeHandler,
  [in] UINT_PTR                                id,
  [in] BOOL                                    fRegisterForNextAnimationEvent
);

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. endKeyframe non deve verificarsi in precedenza nello storyboard rispetto a startKeyframe.

[in] cRepetition

Numero di volte in cui il ciclo deve essere ripetuto; l'ultima iterazione di un ciclo può terminare frazionariamente tra fotogrammi chiave. Il valore zero indica che la parte specificata di uno storyboard non verrà riprodotta. Un valore di UI_ANIMATION_REPEAT_INDEFINITELY (-1) indica che il ciclo si ripeterà per un periodo illimitato fino a quando lo storyboard non viene tagliato o concluso.

[in] repeatMode

Modello per l'iterazione del ciclo.

Il valore UI_ANIMATION_REPEAT_MODE_ALTERNATE (1) specifica che l'inizio del ciclo deve alternare tra fotogrammi chiave (k1-k2>, k2-k1>, k1-k2> e così via).

Il valore UI_ANIMATION_REPEAT_MODE_NORMAL (0) specifica che l'inizio del ciclo deve iniziare con il primo fotogramma chiave (k1-k2>, k1-k2>, k1-k2> e così via).

Nota Se repeatMode ha un valore di UI_ANIMATION_REPEAT_MODE_ALTERNATE (1) e cRepetition ha un valore di UI_ANIMATION_REPEAT_INDEFINITELY (-1), il ciclo termina nel fotogramma chiave finale.

[in] pIterationChangeHandler

Gestore per ogni evento di iterazione del ciclo. Il valore predefinito è 0.

[in] id

ID ciclo da passare a pIterationChangeHandler. Il valore predefinito è 0.

[in] fRegisterForNextAnimationEvent

Se true, specifica che pIterationChangeHandler verrà incorporato nella stima dell'intervallo di tempo fino all'evento di animazione successivo restituito dal metodo IUIAnimationManager2::EstimateNextEventTime . Il valore predefinito è 0 o false.

Valore restituito

Se questo metodo 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 di animazione di Windows .

Commenti

Questo metodo indirizza uno storyboard a riprodurre ripetutamente l'intervallo tra i fotogrammi chiave specificati prima di riprodurre il resto dello storyboard. Se viene specificato un numero di ripetizioni finito, il ciclo riproduce sempre tale numero di volte. Se viene specificato UI_ANIMATION_REPEAT_INDEFINITELY (-1), il ciclo viene ripetuto fino alla conclusione dello storyboard, nel qual caso l'iterazione corrente del ciclo viene completata e il resto dello storyboard viene riprodotto. Uno storyboard che scorre all'infinito termina anche se viene troncato.

I cicli annidati e sovrapposti non sono supportati.

Un fotogramma chiave rappresenta un momento nel tempo all'interno di uno storyboard e può essere usato per specificare l'ora di inizio o di fine delle transizioni. Poiché i fotogrammi chiave possono essere aggiunti alla fine delle transizioni, gli offset dall'inizio dello storyboard potrebbero non essere noti fino a quando non viene riprodotto lo storyboard.

Requisiti

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

Vedi anche

IUIAnimationStoryboard2

IUIAnimationStoryboard2::AddKeyframeAfterTransition

IUIAnimationStoryboard2::AddKeyframeAtOffset

Condividi tramite