IUIAnimationStoryboard::AddKeyframeAtOffset-Methode (uianimation.h)

Artikel
08/26/2023

Fügt einen Keyframe am angegebenen Offset eines vorhandenen Keyframes 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. Um einen Keyframe am Anfang des Storyboards an einem Offset hinzuzufügen, verwenden Sie den speziellen Keyframe UI_ANIMATION_KEYFRAME_STORYBOARD_START.

[in] offset

Der Offset des vorhandenen Keyframes, an dem ein neuer Keyframe hinzugefügt werden soll.

[out] keyframe

Der hinzuzufügende Keyframe.

Rückgabewert

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

Hinweise

Ein Keyframe stellt einen Moment in einem Storyboard dar und kann verwendet werden, um die Anfangs- und Endzeit von Übergängen anzugeben. Da Keyframes an den Enden von Übergängen hinzugefügt werden können, sind ihre Offsets vom Anfang des Storyboards möglicherweise erst bekannt, wenn das Storyboard wiedergegeben wird.

Beispiele

Der folgende Code fügt einen Keyframe mit einem festen Offset von 0,3 Sekunden vom Keyframe am Anfang des Storyboards hinzu.

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