Metodo IUIAnimationStoryboard2::AddTransitionBetweenKeyframes (uianimation.h)

Articolo
08/26/2023

Aggiunge una transizione tra due fotogrammi chiave.

Sintassi

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable2   *variable,
  [in] IUIAnimationTransition2 *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 deve essere possibile che endKeyframe venga visualizzato in precedenza nello storyboard rispetto a startKeyframe.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Codice restituito	Descrizione
UI_E_TRANSITION_ALREADY_USED	Questa transizione è già stata aggiunta a uno storyboard o è stata aggiunta a uno storyboard che ha terminato la riproduzione ed è stata rilasciata.
UI_E_TRANSITION_ECLIPSED	La transizione potrebbe eclissare l'inizio di un'altra transizione nello storyboard.
UI_E_START_KEYFRAME_AFTER_END	Il fotogramma chiave iniziale può verificarsi dopo il fotogramma chiave finale.

Per un elenco di codici di errore, vedere Codici di errore di animazione di Windows .

Commenti

Questo metodo applica la transizione specificata alla variabile specificata nello storyboard, con l'inizio della transizione e termina con i fotogrammi chiave specificati. Se la transizione è stata creata con un parametro di durata specificato, tale durata viene sovrascritta con la durata dell'intervallo di tempo compreso 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 nel tempo all'interno di uno storyboard e può essere usato per specificare l'ora di inizio e 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.

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

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