Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IUIAnimationStoryboard::AddKeyframeAtOffset method

Adds a keyframe at the specified offset from an existing keyframe.

Syntax


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

Parameters

existingKeyframe [in]

The existing keyframe. To add a keyframe at an offset from the start of the storyboard, use the special keyframe UI_ANIMATION_KEYFRAME_STORYBOARD_START.

offset [in]

The offset from the existing keyframe at which a new keyframe is to be added.

keyframe [out]

The keyframe to be added.

Return value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See Windows Animation Error Codes for a list of error codes.

Remarks

A keyframe represents a moment in time within a storyboard and can be used to specify the start and end times of transitions. Because keyframes can be added at the ends of transitions, their offsets from the start of the storyboard may not be known until the storyboard is playing.

Examples

The following code adds a keyframe at a fixed offset of 0.3 seconds from the keyframe at the start of the storyboard.


const UI_ANIMATION_SECONDS offset = 0.3;

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

Requirements

Minimum supported client

Windows 7, Windows Vista and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

None supported

Header

UIAnimation.h

IDL

UIAnimation.idl

DLL

UIAnimation.dll

See also

IUIAnimationStoryboard
IUIAnimationStoryboard::AddKeyframeAfterTransition
IUIAnimationStoryboard::AddTransitionAtKeyframe
IUIAnimationStoryboard::AddTransitionBetweenKeyframes
UI_ANIMATION_KEYFRAME

 

 

Show:
© 2017 Microsoft