IUIAnimationVariableIntegerChangeHandler::OnIntegerValueChanged 메서드(uianimation.h)

아티클
08/26/2023

애니메이션 변수의 값이 변경되면 발생하는 이벤트를 처리합니다.

이 메서드는 업데이트를 INT32 값으로 받습니다. 업데이트를 DOUBLE 값으로 받으려면 IUIAnimationVariableChangeHandler::OnValueChanged 메서드를 사용합니다.

구문

HRESULT OnIntegerValueChanged(
  [in] IUIAnimationStoryboard *storyboard,
  [in] IUIAnimationVariable   *variable,
  [in] INT32                  newValue,
  [in] INT32                  previousValue
);

매개 변수

[in] storyboard

변수 매개 변수로 지정된 애니메이션 변수에 애니메이션 효과를 주는 스토리보드입니다.

[in] variable

업데이트된 애니메이션 변수입니다.

[in] newValue

변수의 반올림 모드에 따라 반올림된 애니메이션 변수의 새 값입니다.

[in] previousValue

변수의 반올림 모드에 따라 반올림된 애니메이션 변수의 이전 값입니다.

반환 값

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

설명

애니메이션 변수의 반올림 모드는 IUIAnimationVariable::SetRoundingMode 메서드를 사용하여 지정됩니다.

OnIntegerValueChanged 이벤트는 2.2, 2.3, 2.4와 같은 값이 모두 동일한 정수로 반올림되기 때문에 OnValueChanged 이벤트보다 덜 자주 발생할 수 있습니다.

기본적으로 콜백 메서드에서 다른 애니메이션 메서드를 호출하면 호출이 실패하고 UI_E_ILLEGAL_REENTRANCY 반환됩니다. 그러나 이 기본값에는 예외가 있습니다. OnIntegerValueChanged에서 다음 메서드를 성공적으로 호출할 수 있습니다.

요구 사항

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