IUIAnimationStoryboard2::AddTransitionAtKeyframe method

Adds a transition that starts at the specified keyframe.

Syntax


HRESULT AddTransitionAtKeyframe(
  [in]  IUIAnimationVariable2 *variable,
  [in]  IUIAnimationTransition2 *transition,
  [in]  UI_ANIMATION_KEYFRAME startKeyframe
);

Parameters

variable [in]

The animation variable for which a transition is to be added.

transition [in]

The transition to be added.

startKeyframe [in]

The keyframe that specifies the beginning of the new transition.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Return codeDescription
UI_E_TRANSITION_ALREADY_USED

This transition has already been added to a storyboard or has been added to a storyboard that has finished playing and been released.

UI_E_TRANSITION_ECLIPSED

The transition might eclipse the beginning of another transition in the storyboard.

 

See Windows Animation Error Codes for a list of error codes.

Remarks

Transitions must be added in the order in which they will be played. A transition may begin playing before the preceding transition in the storyboard has finished, in which case the initial value and velocity seen by the new transition is determined by the state of the preceding one. A transition should not begin before the start of the preceding transition.

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.

Requirements

Minimum supported client

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

Minimum supported server

None supported [desktop apps | Windows Store apps]

Header

UIAnimation.h

IDL

UIAnimation.idl

DLL

UIAnimation.dll

IID

IID_IUIAnimationStoryboard2 is defined as AE289CD2-12D4-4945-9419-9E41BE034DF2

See also

IUIAnimationStoryboard2
IUIAnimationStoryboard2::AddKeyframeAfterTransition
IUIAnimationStoryboard2::AddKeyframeAtOffset
IUIAnimationStoryboard2::AddTransition
IUIAnimationStoryboard2::AddTransitionBetweenKeyframes
IUIAnimationTransition2
IUIAnimationTransitionLibrary2

 

 

Community Additions

ADD
Show:
© 2014 Microsoft