Metodo IUIAnimationStoryboard::AddTransitionBetweenKeyframes (uianimation.h)

Articolo
08/26/2023

Aggiunge una transizione tra due fotogrammi chiave.

Sintassi

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *transition,
  [in] UI_ANIMATION_KEYFRAME  startKeyframe,
  [in] UI_ANIMATION_KEYFRAME  endKeyframe
);

Parametri

[in] variable

Variabile di animazione per la quale deve essere aggiunta la transizione.

[in] transition

Transizione da aggiungere.

[in] startKeyframe

Fotogramma chiave che specifica l'inizio della nuova transizione.

[in] endKeyframe

Fotogramma chiave che specifica la fine della nuova transizione. Non è possibile che endKeyframe venga visualizzato in precedenza nello storyboard rispetto a startKeyframe.

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_TRANSITION_ALREADY_USED	Questa transizione è già stata aggiunta a uno storyboard o è stata aggiunta a uno storyboard che ha completato la riproduzione ed è stata rilasciata.
UI_E_TRANSITION_ECLIPSED	La transizione potrebbe eclipsere l'inizio di un'altra transizione nello storyboard.
UI_E_START_KEYFRAME_AFTER_END	Il fotogramma chiave iniziale potrebbe verificarsi dopo il fotogramma chiave finale.

Commenti

Questo metodo applica la transizione specificata alla variabile specificata nello storyboard, con l'avvio della transizione e la fine dei fotogrammi chiave specificati. Se la transizione è stata creata con un parametro di durata specificata, tale durata viene sovrascritta con la durata dell'ora compresa tra i fotogrammi chiave iniziale e finale. In caso contrario, l'animazione di Windows accelera o rallenta la transizione in base alle esigenze.

Un fotogramma chiave rappresenta un momento in tempo all'interno di uno storyboard e può essere usato per specificare l'ora di inizio e 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.

Le transizioni devono essere aggiunte nell'ordine in cui verranno riprodotte. Una transizione può iniziare a giocare prima della transizione precedente nel storyboard, in cui il valore iniziale e la velocità visti dalla nuova transizione saranno determinati dallo stato del precedente. Non deve essere possibile iniziare una transizione prima dell'inizio della transizione precedente.

Requisiti


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