IUIAnimationStoryboard::AddKeyframeAtOffset 메서드(uianimation.h)

아티클
08/26/2023

기존 키 프레임에서 지정된 오프셋에 키 프레임을 추가합니다.

구문

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

매개 변수

[in] existingKeyframe

기존 키 프레임입니다. 스토리보드 시작부터 오프셋에 키 프레임을 추가하려면 특수 키 프레임 UI_ANIMATION_KEYFRAME_STORYBOARD_START 사용합니다.

[in] offset

새 키 프레임을 추가할 기존 키 프레임의 오프셋입니다.

[out] keyframe

추가할 키 프레임입니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 Windows 애니메이션 오류 코드를 참조하세요.

설명

키 프레임은 스토리보드 내의 시간을 나타내며 전환의 시작 및 종료 시간을 지정하는 데 사용할 수 있습니다. 전환 끝에 키 프레임을 추가할 수 있으므로 스토리보드 시작부터 스토리보드가 재생될 때까지 해당 오프셋을 알 수 없습니다.

예제

다음 코드는 스토리보드 시작 시 키 프레임에서 0.3초의 고정 오프셋에 키 프레임을 추가합니다.

const UI_ANIMATION_SECONDS offset = 0.3;

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

요구 사항


지원되는 최소 클라이언트	Windows Vista용 Windows 7, Windows Vista 및 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	uianimation.h
DLL	UIAnimation.dll