Metodo IUIAnimationStoryboard::AddKeyframeAtOffset (uianimation.h)

Aggiunge un fotogramma chiave all'offset specificato da un fotogramma chiave esistente.

Sintassi

HRESULT AddKeyframeAtOffset(
  [in]  UI_ANIMATION_KEYFRAME existingKeyframe,
  [in]  UI_ANIMATION_SECONDS  offset,
  [out] UI_ANIMATION_KEYFRAME *keyframe
);

Parametri

[in] existingKeyframe

Fotogramma chiave esistente. Per aggiungere un fotogramma chiave in corrispondenza di un offset dall'inizio dello storyboard, usare il UI_ANIMATION_KEYFRAME_STORYBOARD_START del fotogramma chiave speciale.

[in] offset

Offset dal fotogramma chiave esistente in cui deve essere aggiunto un nuovo fotogramma chiave.

[out] keyframe

Fotogramma chiave da aggiungere.

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 .

Commenti

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.

Esempio

Il codice seguente aggiunge un fotogramma chiave in corrispondenza di un offset fisso di 0,3 secondi dal fotogramma chiave all'inizio dello storyboard.

const UI_ANIMATION_SECONDS offset = 0.3;

UI_ANIMATION_KEYFRAME keyframe1;
hr = pStoryboard->AddKeyframeAtOffset(
       UI_ANIMATION_KEYFRAME_STORYBOARD_START,
       offset,
       &keyframe1
);

Requisiti

Vedi anche

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddTransitionAtKeyframe

IUIAnimationStoryboard::AddTransitionBetweenKeyframes

UI_ANIMATION_KEYFRAME