CAnimationVariable 클래스
애니메이션 변수를 나타냅니다.
구문
class CAnimationVariable;
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CAnimationVariable::CAnimationVariable | 애니메이션 변수 개체를 생성합니다. |
| CAnimationVariable::~CAnimationVariable | 소멸자입니다. CAnimationVariable 개체가 제거될 때 호출됩니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| CAnimationVariable::AddTransition | 전환을 추가합니다. |
| CAnimationVariable::ApplyTransitions | 내부 목록에서 스토리보드로 전환을 추가합니다. |
| CAnimationVariable::ClearTransitions | 전환을 지웁니다. |
| CAnimationVariable::Create | 기본 애니메이션 변수 COM 개체를 만듭니다. |
| CAnimationVariable::CreateTransitions | 이 애니메이션 변수에 적용할 모든 전환을 만듭니다. |
| CAnimationVariable::EnableIntegerValueChangedEvent | IntegerValueChanged 이벤트를 사용하거나 사용하지 않도록 설정합니다. |
| CAnimationVariable::EnableValueChangedEvent | ValueChanged 이벤트를 사용하거나 사용하지 않도록 설정합니다. |
| CAnimationVariable::GetDefaultValue | 기본값을 반환합니다. |
| CAnimationVariable::GetParentAnimationObject | 부모 애니메이션 개체를 반환합니다. |
| CAnimationVariable::GetValue | 오버로드됨. 애니메이션 변수의 현재 값을 반환합니다. |
| CAnimationVariable::GetVariable | IUIAnimationVariable COM 개체에 대한 포인터를 반환합니다. |
| CAnimationVariable::SetDefaultValue | 기본값을 설정하고 IUIAnimationVariable COM 개체를 해제합니다. |
보호된 메서드
| 속성 | 설명 |
|---|---|
| CAnimationVariable::SetParentAnimationObject | 애니메이션 변수와 애니메이션 개체 간의 관계를 설정합니다. |
공용 데이터 멤버
| 속성 | 설명 |
|---|---|
| CAnimationVariable::m_bAutodestroyTransitions | 관련 전환 개체를 삭제할지 여부를 지정합니다. |
보호된 데이터 멤버
| 속성 | 설명 |
|---|---|
| CAnimationVariable::m_dblDefaultValue | IUIAnimationVariable로 전파되는 기본값을 지정합니다. |
| CAnimationVariable::m_lstTransitions | 이 애니메이션 변수에 애니메이션 효과를 주는 전환 목록을 포함합니다. |
| CAnimationVariable::m_pParentObject | 이 애니메이션 변수를 캡슐화하는 애니메이션 개체에 대한 포인터입니다. |
| CAnimationVariable::m_variable | IUIAnimationVariable COM 개체에 대한 포인터를 저장합니다. COM 개체가 아직 만들어지지 않았거나 생성에 실패한 경우 NULL입니다. |
설명
CAnimationVariable 클래스는 IUIAnimationVariable COM 개체를 캡슐화합니다. 스토리보드의 애니메이션 변수에 적용할 전환 목록도 포함됩니다. CAnimationVariable 개체는 애니메이션 개체에 포함되며, 애플리케이션에서 애니메이션 값, 점, 크기, 색 및 사각형을 나타낼 수 있습니다.
상속 계층 구조
CAnimationVariable
요구 사항
헤더: afxanimationcontroller.h
CAnimationVariable::~CAnimationVariable
소멸자입니다. CAnimationVariable 개체가 제거될 때 호출됩니다.
virtual ~CAnimationVariable();
CAnimationVariable::AddTransition
전환을 추가합니다.
void AddTransition(CBaseTransition* pTransition);
매개 변수
pTransition
추가할 전환에 대한 포인터입니다.
설명
이 메서드는 애니메이션 변수에 적용할 전환의 내부 목록에 전환을 추가 하기 위해 호출 됩니다. 애니메이션이 예약된 경우 이 목록을 지워야 합니다.
CAnimationVariable::ApplyTransitions
내부 목록에서 스토리보드로 전환을 추가합니다.
void ApplyTransitions(
CAnimationController* pController,
IUIAnimationStoryboard* pStoryboard,
BOOL bDependOnKeyframes);
매개 변수
pController
부모 애니메이션 컨트롤러에 대한 포인터입니다.
pStoryboard
스토리보드에 대한 포인터입니다.
bDependOnKeyframes
TRUE입니다. 이 메서드가 키 프레임에 의존하는 전환을 추가해야 하는 경우
설명
이 메서드는 내부 목록에서 스토리보드로의 전환을 추가합니다. 최상위 코드에서 여러 번 호출되어 키 프레임에 의존하지 않는 전환을 추가하고 키 프레임에 의존하는 전환을 추가합니다. 기본 애니메이션 변수 COM 개체를 만들지 않은 경우 이 메서드는 이 단계에서 만듭니다.
CAnimationVariable::CAnimationVariable
애니메이션 변수 개체를 생성합니다.
CAnimationVariable(DOUBLE dblDefaultValue = 0.0);
매개 변수
dblDefaultValue
기본값을 지정합니다.
설명
애니메이션 변수 개체를 생성하고 기본값을 설정합니다. 기본값은 변수에 애니메이션 효과를 주지 않거나 애니메이션 효과를 적용할 수 없는 경우에 사용됩니다.
CAnimationVariable::ClearTransitions
전환을 지웁니다.
void ClearTransitions(BOOL bAutodestroy);
매개 변수
bAutodestroy
이 메서드가 전환 개체를 삭제할지 여부를 지정합니다.
설명
이 메서드는 내부 전환 목록에서 모든 전환을 제거합니다. bAutodestroy가 TRUE이거나 m_bAutodestroyTransitions TRUE이면 전환이 삭제됩니다. 그렇지 않으면 호출자가 전환 개체의 할당을 취소해야 합니다.
CAnimationVariable::Create
기본 애니메이션 변수 COM 개체를 만듭니다.
virtual BOOL Create(IUIAnimationManager* pManager);
매개 변수
pManager
애니메이션 관리자에 대한 포인터입니다.
Return Value
애니메이션 변수가 성공적으로 만들어졌으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
이 메서드는 기본 애니메이션 변수 COM 개체를 만들고 기본값을 설정합니다.
CAnimationVariable::CreateTransitions
이 애니메이션 변수에 적용할 모든 전환을 만듭니다.
BOOL CreateTransitions(
IUIAnimationTransitionLibrary* pLibrary,
IUIAnimationTransitionFactory* \*not used*\);
매개 변수
pLibrary
표준 전환 라이브러리를 정의하는 IUIAnimationTransitionLibrary 인터페이스에 대한 포인터입니다.
Return Value
전환이 성공적으로 만들어진 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
이 메서드는 변수의 내부 전환 목록에 추가된 전환을 만들어야 할 때 프레임워크에서 호출됩니다.
CAnimationVariable::EnableIntegerValueChangedEvent
IntegerValueChanged 이벤트를 사용하거나 사용하지 않도록 설정합니다.
void EnableIntegerValueChangedEvent (
CAnimationController* pController,
BOOL bEnable);
매개 변수
pController
부모 컨트롤러에 대한 포인터입니다.
bEnable
TRUE - 이벤트 사용, FALSE - 이벤트를 사용하지 않도록 설정합니다.
설명
ValueChanged 이벤트를 사용하도록 설정하면 프레임워크는 가상 메서드 CAnimationController::OnAnimationIntegerValueChanged를 호출합니다. 이 이벤트를 처리하려면 CAnimationController에서 파생된 클래스에서 재정의해야 합니다. 이 메서드는 애니메이션 변수의 정수 값이 변경될 때마다 호출됩니다.
CAnimationVariable::EnableValueChangedEvent
ValueChanged 이벤트를 사용하거나 사용하지 않도록 설정합니다.
void EnableValueChangedEvent (
CAnimationController* pController,
BOOL bEnable);
매개 변수
pController
부모 컨트롤러에 대한 포인터입니다.
bEnable
TRUE - 이벤트 사용, FALSE - 이벤트를 사용하지 않도록 설정합니다.
설명
ValueChanged 이벤트를 사용하도록 설정하면 프레임워크는 가상 메서드 CAnimationController::OnAnimationValueChanged를 호출합니다. 이 이벤트를 처리하려면 CAnimationController에서 파생된 클래스에서 재정의해야 합니다. 이 메서드는 애니메이션 변수의 값이 변경될 때마다 호출됩니다.
CAnimationVariable::GetDefaultValue
기본값을 반환합니다.
DOUBLE GetDefaultValue() const;
Return Value
기본값입니다.
설명
애니메이션 변수의 기본값을 가져오려면 이 함수를 사용합니다. 기본값은 생성자 또는 SetDefaultValue 메서드에서 설정할 수 있습니다.
CAnimationVariable::GetParentAnimationObject
부모 애니메이션 개체를 반환합니다.
CAnimationBaseObject* GetParentAnimationObject();
Return Value
관계가 설정된 경우 부모 애니메이션 개체에 대한 포인터이거나, 그렇지 않으면 NULL입니다.
설명
부모 애니메이션 개체(컨테이너)에 대한 포인터를 검색하기 위해 이 메서드를 호출할 수 있습니다.
CAnimationVariable::GetValue
애니메이션 변수의 현재 값을 반환합니다.
HRESULT GetValue(DOUBLE& dblValue);
HRESULT GetValue(INT32& nValue);
매개 변수
dblValue
애니메이션 변수의 현재 값입니다.
nValue
애니메이션 변수의 현재 값입니다.
Return Value
S_OK 값이 성공적으로 획득되었거나 기본 애니메이션 변수가 만들어지지 않은 경우입니다. 그렇지 않으면 HRESULT 오류 코드입니다.
설명
이 메서드를 호출하여 애니메이션 변수의 현재 값을 검색할 수 있습니다. 기본 COM 개체를 만들지 않은 경우 함수가 반환될 때 dblValue에 기본값이 포함됩니다.
CAnimationVariable::GetVariable
IUIAnimationVariable COM 개체에 대한 포인터를 반환합니다.
IUIAnimationVariable* GetVariable();
Return Value
IUIAnimationVariable COM 개체에 대한 유효한 포인터이거나, 애니메이션 변수가 만들어지지 않았거나 만들 수 없는 경우 NULL입니다.
설명
이 함수를 사용하여 기본 IUIAnimationVariable COM 개체에 액세스하고 필요한 경우 해당 메서드를 직접 호출합니다.
CAnimationVariable::m_bAutodestroyTransitions
관련 전환 개체를 삭제할지 여부를 지정합니다.
BOOL m_bAutodestroyTransitions;
설명
전환 개체가 내부 전환 목록에서 제거될 때 강제로 삭제하려면 이 값을 TRUE로 설정합니다. 이 값이 FALSE이면 애플리케이션을 호출하여 전환을 삭제해야 합니다. 애니메이션이 예약된 후에는 전환 목록이 항상 지워집니다. 기본값은 FALSE입니다.
CAnimationVariable::m_dblDefaultValue
IUIAnimationVariable로 전파되는 기본값을 지정합니다.
DOUBLE m_dblDefaultValue;
CAnimationVariable::m_lstTransitions
이 애니메이션 변수에 애니메이션 효과를 주는 전환 목록을 포함합니다.
CObList m_lstTransitions;
CAnimationVariable::m_pParentObject
이 애니메이션 변수를 캡슐화하는 애니메이션 개체에 대한 포인터입니다.
CAnimationBaseObject* m_pParentObject;
CAnimationVariable::m_variable
IUIAnimationVariable COM 개체에 대한 포인터를 저장합니다. COM 개체가 아직 만들어지지 않았거나 생성에 실패한 경우 NULL입니다.
ATL::CComPtr<IUIAnimationVariable> m_variable;
CAnimationVariable::SetDefaultValue
기본값을 설정하고 IUIAnimationVariable COM 개체를 해제합니다.
void SetDefaultValue(DOUBLE dblDefaultValue);
매개 변수
dblDefaultValue
새 기본값을 지정합니다.
설명
이 메서드를 사용하여 기본값을 다시 설정합니다. 이 메서드는 내부 IUIAnimationVariable COM 개체를 해제하므로 애니메이션 변수가 다시 만들어지면 기본 COM 개체가 새 기본값을 가져옵니다. 애니메이션 변수를 나타내는 COM 개체가 생성되지 않았거나 변수에 애니메이션이 적용되지 않은 경우 GetValue에서 기본값을 반환합니다.
CAnimationVariable::SetParentAnimationObject
애니메이션 변수와 애니메이션 개체 간의 관계를 설정합니다.
void SetParentAnimationObject(CAnimationBaseObject* pParentObject);
매개 변수
pParentObject
이 변수를 포함하는 애니메이션 개체에 대한 포인터입니다.
설명
이 메서드는 애니메이션 변수와 이를 캡슐화하는 애니메이션 개체 간에 일대일 관계를 설정하기 위해 내부적으로 호출됩니다.