IUIAnimationManager::Update 메서드(uianimation.h)

아티클
03/03/2024

모든 애니메이션 변수의 값을 업데이트.

구문

HRESULT Update(
  [in]            UI_ANIMATION_SECONDS       timeNow,
  [out, optional] UI_ANIMATION_UPDATE_RESULT *updateResult
);

매개 변수

[in] timeNow

현재 시스템 시간입니다. 이 매개 변수는 0.0보다 크거나 같아야 합니다.

[out, optional] updateResult

업데이트의 결과입니다. 이 매개 변수는 이 메서드에 대한 호출에서 생략할 수 있습니다.

반환 값

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

설명

이 메서드를 호출하면 애니메이션 관리자가 timeNow로 이동하여 필요에 따라 스토리보드의 상태를 변경하고 애니메이션 변수를 적절한 보간된 값으로 업데이트합니다. 애니메이션 관리자가 일시 중지되면 스토리보드 또는 변수가 업데이트되지 않습니다. 애니메이션 모드가 UI_ANIMATION_MODE_DISABLED 경우 예약된 모든 스토리보드가 즉시 재생됩니다. 이 호출 중에 변수의 값이 변경되면 updateResult 값이 UI_ANIMATION_UPDATE_VARIABLES_CHANGED. 그렇지 않으면 UI_ANIMATION_UPDATE_NO_CHANGE.

예제

다음 예제에서는 애니메이션 관리자를 현재 시간으로 업데이트합니다. 추가 예제는 애니메이션 관리자 업데이트 및 프레임 그리기를 참조하세요.

// Update the animation manager with the current time
UI_ANIMATION_SECONDS secondsNow;
hr = m_pAnimationTimer->GetTime(
    &secondsNow
    );
if (SUCCEEDED(hr))
{
    UI_ANIMATION_UPDATE_RESULT updateResult;
    hr = m_pAnimationManager->Update(
        secondsNow,
        &updateResult
        );
    if (SUCCEEDED(hr))
    {
        if (updateResult == UI_ANIMATION_UPDATE_VARIABLES_CHANGED)
        {
            ...
        }
    }
}

요구 사항

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