다음을 통해 공유


CAnimationValue 클래스

비고

MFC(Microsoft Foundation Classs) 라이브러리는 계속 지원됩니다. 그러나 더 이상 기능을 추가하거나 설명서를 업데이트하지 않습니다.

하나의 값을 갖는 애니메이션 개체 기능을 구현합니다.

구문

class CAnimationValue : public CAnimationBaseObject;

멤버

공용 생성자

속성 설명
CAnimationValue::CAnimationValue 오버로드됨. CAnimationValue 개체를 생성합니다.

공용 메서드

속성 설명
CAnimationValue::AddTransition 값에 적용할 전환을 추가합니다.
CAnimationValue::GetValue 오버로드됨. 현재 값을 검색합니다.
CAnimationValue::GetVariable 캡슐화된 애니메이션 변수에 대한 액세스를 제공합니다.
CAnimationValue::SetDefaultValue 기본값을 설정합니다.

보호된 메서드

속성 설명
CAnimationValue::GetAnimationVariableList 캡슐화된 애니메이션 변수를 목록에 넣습니다. (재정의 CAnimationBaseObject::GetAnimationVariableList.)

Public 연산자

속성 설명
CAnimationValue::operator DOUBLE CAnimationValue와 DOUBLE 간의 변환을 제공합니다.
CAnimationValue::operator INT32 CAnimationValue와 INT32 간의 변환을 제공합니다.
CAnimationValue::operator= 오버로드됨. CAnimationValue에 INT32 값을 할당합니다.

보호된 데이터 멤버

속성 설명
CAnimationValue::m_value 애니메이션 값을 나타내는 캡슐화된 애니메이션 변수입니다.

설명

CAnimationValue 클래스는 단일 CAnimationVariable 개체를 캡슐화하고 애플리케이션에 애니메이션 효과를 준 단일 값을 나타낼 수 있습니다. 예를 들어 애니메이션 투명도(페이드 효과), 각도(개체 회전) 또는 단일 애니메이션 값에 따라 애니메이션을 만들어야 하는 다른 경우에 이 클래스를 사용할 수 있습니다. 애플리케이션에서 이 클래스를 사용하려면 이 클래스의 개체를 인스턴스화하고 CAnimationController::AddAnimationObject를 사용하여 애니메이션 컨트롤러에 추가하고 값에 적용할 각 전환에 대해 AddTransition을 호출합니다.

상속 계층 구조

CObject

CAnimationBaseObject

CAnimationValue

요구 사항

헤더: afxanimationcontroller.h

CAnimationValue::AddTransition

값에 적용할 전환을 추가합니다.

void AddTransition(CBaseTransition* pTransition);

매개 변수

pTransition
전환 개체에 대한 포인터입니다.

설명

애니메이션 변수에 적용할 전환의 내부 목록에 전환을 추가하려면 이 함수를 호출합니다. 전환을 추가하면 전환이 즉시 적용되지 않고 내부 목록에 저장됩니다. CAnimationController::AnimateGroup을 호출하면 전환이 적용됩니다(특정 값의 스토리보드에 추가됨).

CAnimationValue::CAnimationValue

CAnimationValue 개체를 생성합니다.

CAnimationValue();

CAnimationValue(
    DOUBLE dblDefaultValue,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

매개 변수

dblDefaultValue
기본값을 지정합니다.

nGroupID
그룹 ID를 지정합니다.

nObjectID
개체 ID를 지정합니다.

dwUserData
는 사용자 정의 데이터를 지정합니다.

설명

기본값, 그룹 ID 및 개체 ID가 0으로 설정된 기본 속성을 사용하여 CAnimationValue 개체를 생성합니다.

CAnimationValue::GetAnimationVariableList

캡슐화된 애니메이션 변수를 목록에 넣습니다.

virtual void GetAnimationVariableList(
    CList<CAnimationVariable*,
    CAnimationVariable*>& lst);

매개 변수


함수가 반환되면 애니메이션된 값을 나타내는 CAnimationVariable에 대한 포인터가 포함됩니다.

CAnimationValue::GetValue

현재 값을 검색합니다.

BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);

매개 변수

dblValue
출력 함수가 반환되면 애니메이션 변수의 현재 값이 포함됩니다.

nValue
출력 함수가 반환되면 애니메이션 변수의 현재 값이 포함됩니다.

반환 값

현재 값이 성공적으로 검색되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

현재 값을 검색하려면 이 함수를 호출합니다. 이 구현은 캡슐화된 COM 개체를 호출하고 호출이 실패하면 이 메서드는 이전에 생성자 또는 SetDefaultValue에서 설정한 기본값을 반환합니다.

CAnimationValue::GetVariable

캡슐화된 애니메이션 변수에 대한 액세스를 제공합니다.

CAnimationVariable& GetVariable();

반환 값

캡슐화된 애니메이션 변수에 대한 참조입니다.

설명

캡슐화된 애니메이션 변수에 액세스하려면 이 메서드를 사용합니다. CAnimationVariable에서 애니메이션 변수를 만들지 않은 경우 포인터가 NULL일 수 있는 기본 IUIAnimationVariable 개체에 액세스할 수 있습니다.

CAnimationValue::m_value

애니메이션 값을 나타내는 캡슐화된 애니메이션 변수입니다.

CAnimationVariable m_value;

CAnimationValue::operator DOUBLE

CAnimationValue와 DOUBLE 간의 변환을 제공합니다.

operator DOUBLE();

반환 값

애니메이션 값의 현재 값입니다.

설명

CAnimationValue와 DOUBLE 간의 변환을 제공합니다. 이 메서드는 내부적으로 GetValue를 호출하고 오류를 확인하지 않습니다. GetValue가 실패하면 반환된 값에는 이전에 생성자 또는 SetDefaultValue에서 설정한 기본값이 포함됩니다.

CAnimationValue::operator INT32

CAnimationValue와 INT32 간의 변환을 제공합니다.

operator INT32();

반환 값

애니메이션 값의 현재 값(정수)입니다.

설명

CAnimationValue와 INT32 간의 변환을 제공합니다. 이 메서드는 내부적으로 GetValue를 호출하고 오류를 확인하지 않습니다. GetValue가 실패하면 반환된 값에는 이전에 생성자 또는 SetDefaultValue에서 설정한 기본값이 포함됩니다.

CAnimationValue::operator=

CAnimationValue에 DOUBLE 값을 할당합니다.

void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);

매개 변수

dblVal
애니메이션 값에 할당할 값을 지정합니다.

nVal
애니메이션 값에 할당할 값을 지정합니다.

설명

CAnimationValue에 DOUBLE 값을 할당합니다. 이 값은 캡슐화된 애니메이션 변수의 기본값으로 설정됩니다. 이 애니메이션 개체를 이벤트(ValueChanged 또는 IntegerValueChanged)에 구독한 경우 이러한 이벤트를 다시 사용하도록 설정해야 합니다.

CAnimationValue::SetDefaultValue

기본값을 설정합니다.

void SetDefaultValue(DOUBLE dblDefaultValue);

매개 변수

dblDefaultValue
기본값을 지정합니다.

설명

이 메서드를 사용하여 기본값을 설정합니다. 애니메이션이 시작되지 않았거나 기본 COM 개체가 만들어지지 않은 경우 기본값이 애플리케이션에 반환됩니다. CAnimationVarible에 캡슐화된 기본 COM 개체가 이미 만들어진 경우 이 메서드가 다시 만들어지므로 EnableValueChanged/EnableIntegerValueChanged 메서드를 다시 호출해야 할 수 있습니다.

참고 항목

클래스