IUIAnimationStoryboard::AddKeyframeAtOffset-Methode (uianimation.h)

Fügt einen Keyframe im angegebenen Offset aus einem vorhandenen Keyframe hinzu.

Syntax

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

Parameter

[in] existingKeyframe

Der vorhandene Keyframe. Verwenden Sie zum Hinzufügen eines Keyframes am Anfang des Storyboards den speziellen Keyframe UI_ANIMATION_KEYFRAME_STORYBOARD_START.

[in] offset

Der Offset aus dem vorhandenen Keyframe, bei dem ein neuer Keyframe hinzugefügt werden soll.

[out] keyframe

Der zu hinzufügende Keyframe.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Windows Animation Error Codes für eine Liste der Fehlercodes.

Bemerkungen

Ein Keyframe stellt einen Moment innerhalb eines Storyboards dar und kann verwendet werden, um die Anfangs- und Endzeiten der Übergänge anzugeben. Da Keyframes am Ende der Übergänge hinzugefügt werden können, werden ihre Offsets vom Anfang des Storyboards möglicherweise erst bekannt, wenn das Storyboard wiedergegeben wird.

Beispiele

Im folgenden Code wird ein Keyframe mit einem festen Offset von 0,3 Sekunden vom Keyframe am Anfang des Storyboards hinzugefügt.

const UI_ANIMATION_SECONDS offset = 0.3;

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7, Windows Vista und Platform Update für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile uianimation.h
DLL UIAnimation.dll

Weitere Informationen

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddTransitionAtKeyframe

IUIAnimationStoryboard::AddTransitionBetweenKeyframes

UI_ANIMATION_KEYFRAME