Класс CAnimationValue

Реализует функции объекта анимации, имеющего одно значение.

Синтаксис

class CAnimationValue : public CAnimationBaseObject;

Участники

Открытые конструкторы

Имя	Описание
CAnimationValue::CAnimationValue	Перегружен. Создает объект CAnimationValue.

Открытые методы

Имя	Описание
CAnimationValue::AddTransition	Добавляет переход, применяемый к значению.
CAnimationValue::GetValue	Перегружен. Извлекает текущее значение.
CAnimationValue::GetVariable	Предоставляет доступ к инкапсулированной переменной анимации.
CAnimationValue::SetDefaultValue	Задает значение по умолчанию.

Защищенные методы

Имя	Описание
CAnimationValue::GetAnimationVariableList	Помещает инкапсулированную переменную анимации в список. (Переопределения CAnimationBaseObject::GetAnimationVariableList.)

Открытые операторы

Имя	Описание
CAnimationValue::operator DOUBLE	Предоставляет преобразование между CAnimationValue и DOUBLE.
CAnimationValue::operator INT32	Предоставляет преобразование между CAnimationValue и INT32.
CAnimationValue::operator=	Перегружен. Назначает значение INT32 CAnimationValue.

Защищенные члены данных

Имя	Описание
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
Указывает идентификатор группы.

nObjectID
Указывает идентификатор объекта.

dwUserData
указывает определяемые пользователем данные.

Замечания

Создает объект CAnimationValue со свойствами по умолчанию: значение по умолчанию, идентификатор группы и идентификатор объекта имеют значение 0.

CAnimationValue::GetAnimationVariableList

Помещает инкапсулированную переменную анимации в список.

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

Параметры

Lst
Когда функция возвращается, она содержит указатель на CAnimationVariable, представляющий анимированное значение.

CAnimationValue::GetValue

Извлекает текущее значение.

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

Параметры

dblValue
Выход. Когда функция возвращает ее, она содержит текущее значение переменной анимации.

nValue
Выход. Когда функция возвращает ее, она содержит текущее значение переменной анимации.

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если текущее значение было успешно получено; в противном случае ЗНАЧЕНИЕ FALSE.

Замечания

Вызовите эту функцию, чтобы получить текущее значение. Эта реализация вызывает инкапсулированный COM-объект, и если вызов завершается ошибкой, этот метод возвращает значение по умолчанию, заданное ранее в конструкторе или с SetDefaultValue.

CAnimationValue::GetVariable

Предоставляет доступ к инкапсулированной переменной анимации.

CAnimationVariable& GetVariable();

Возвращаемое значение

Ссылка на инкапсулированную переменную анимации.

Замечания

Используйте этот метод для доступа к инкапсулированной переменной анимации. Из CAnimationVariable вы получаете доступ к базовому объекту IUIAnimationVariable, указатель которого может иметь значение NULL, если переменная анимации не создана.

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.

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

Параметры

dblVal
Указывает значение, назначенное значению анимации.

nVal
Указывает значение, назначенное значению анимации.

Замечания

Присваивает двойное значение CAnimationValue. Это значение задается как значение по умолчанию для инкапсулированной переменной анимации. Если вы подписали этот объект анимации на события (ValueChanged или IntegerValueChanged), необходимо повторно включить эти события.

CAnimationValue::SetDefaultValue

Задает значение по умолчанию.

void SetDefaultValue(DOUBLE dblDefaultValue);

Параметры

dblDefaultValue
Указывает значение по умолчанию.

Замечания

Используйте этот метод для задания значения по умолчанию. Значение по умолчанию возвращается приложению, если анимация не запущена и /или базовый COM-объект не был создан. Если базовый COM-объект, инкапсулированный в CAnimationVarible, уже создан, этот метод повторно создает его, поэтому может потребоваться снова вызвать метод EnableValueChanged/EnableIntegerValueChanged.

См. также

Классы