Поделиться через


Класс CAnimationColor

Реализует функции цвета, красный, зеленый и синий компоненты которого могут быть анимированы.

Синтаксис

class CAnimationColor : public CAnimationBaseObject;

Участники

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

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

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

Имя Описание
CAnimationColor::AddTransition Добавляет переходы для компонентов Red, Green и Blue.
CAnimationColor::GetB Предоставляет доступ к CAnimationVariable, представляющей синий компонент.
CAnimationColor::GetDefaultValue Возвращает значения по умолчанию для компонентов цвета.
CAnimationColor::GetG Предоставляет доступ к CAnimationVariable, представляющего зеленый компонент.
CAnimationColor::GetR Предоставляет доступ к CAnimationVariable, представляющей красный компонент.
CAnimationColor::GetValue Возвращает текущее значение.
CAnimationColor::SetDefaultValue Задает значение по умолчанию.

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

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

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

Имя Описание
CAnimationColor::operator COLORREF
CAnimationColor::operator= Назначает цвет CAnimationColor.

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

Имя Описание
CAnimationColor::m_bValue Инкапсулированная переменная анимации, представляющая синий компонент цвета анимации.
CAnimationColor::m_gValue Инкапсулированная переменная анимации, представляющая зеленый компонент цвета анимации.
CAnimationColor::m_rValue Инкапсулированная переменная анимации, представляющая красный компонент цвета анимации.

Замечания

Класс CAnimationColor инкапсулирует три объекта CAnimationVariable и может представлять в приложениях цвет. Например, этот класс можно использовать для анимации цветов любого объекта на экране (например, цвета текста, цвета фона и т. д.). Чтобы использовать этот класс в приложении, просто создайте экземпляр объекта этого класса, добавьте его в контроллер анимации с помощью CAnimationController::AddAnimationObject и вызов AddTransition для каждого перехода для применения к компонентам Red, Green и Blue.

Иерархия наследования

CObject

CAnimationBaseObject

CAnimationColor

Требования

Заголовок: afxanimationcontroller.h

CAnimationColor::AddTransition

Добавляет переходы для компонентов Red, Green и Blue.

void AddTransition(
    CBaseTransition* pRTransition,
    CBaseTransition* pGTransition,
    CBaseTransition* pBTransition);

Параметры

pRTransition
Переход для компонента Red.

pGTransition
Переход для зеленого компонента.

pBTransition
Переход для синего компонента.

Замечания

Вызовите эту функцию, чтобы добавить указанные переходы в внутренний список переходов, применяемых к переменным анимации, представляющим компоненты цвета. При добавлении переходов они не применяются немедленно и хранятся во внутреннем списке. Переходы применяются (добавляются в раскадровки для определенного значения) при вызове CAnimationController::AnimateGroup. Если вам не нужно применять переход к одному из компонентов цвета, можно передать значение NULL.

CAnimationColor::CAnimationColor

Создает объект CAnimationColor.

CAnimationColor();

CAnimationColor(
    COLORREF color,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Параметры

color
Задает цвет по умолчанию.

nGroupID
Указывает идентификатор группы.

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

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

Замечания

Объект построен со значениями по умолчанию для красного, зеленого, синего, идентификатора объекта и идентификатора группы, который будет иметь значение 0. Их можно изменить позже во время выполнения с помощью SetDefaultValue и SetID.

CAnimationColor::GetAnimationVariableList

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

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

Параметры

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

CAnimationColor::GetB

Предоставляет доступ к CAnimationVariable, представляющей синий компонент.

CAnimationVariable& GetB();

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

Ссылка на инкапсулированную CAnimationVariable, представляющую синий компонент.

Замечания

Этот метод можно вызвать для прямого доступа к базовому компоненту CAnimationVariable, представляющего синий компонент.

CAnimationColor::GetDefaultValue

Возвращает значения по умолчанию для компонентов цвета.

COLORREF GetDefaultValue();

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

Значение COLORREF, содержащее значения по умолчанию для компонентов RGB.

Замечания

Вызовите эту функцию, чтобы получить значение по умолчанию, которое ранее было задано конструктором или SetDefaultValue.

CAnimationColor::GetG

Предоставляет доступ к CAnimationVariable, представляющего зеленый компонент.

CAnimationVariable& GetG();

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

Ссылка на инкапсулированную CAnimationVariable, представляющую зеленый компонент.

Замечания

Этот метод можно вызвать для прямого доступа к базовому компоненту CAnimationVariable, представляющего зеленый компонент.

CAnimationColor::GetR

Предоставляет доступ к CAnimationVariable, представляющей красный компонент.

CAnimationVariable& GetR();

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

Ссылка на инкапсулированную CAnimationVariable, представляющую красный компонент.

Замечания

Этот метод можно вызвать для прямого доступа к базовому компоненту CAnimationVariable, представляющего красный компонент.

CAnimationColor::GetValue

Возвращает текущее значение.

BOOL GetValue(COLORREF& color);

Параметры

color
Выход. Содержит текущее значение при возврате этого метода.

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

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

Замечания

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

CAnimationColor::m_bValue

Инкапсулированная переменная анимации, представляющая синий компонент цвета анимации.

CAnimationVariable m_bValue;

CAnimationColor::m_gValue

Инкапсулированная переменная анимации, представляющая зеленый компонент цвета анимации.

CAnimationVariable m_gValue;

CAnimationColor::m_rValue

Инкапсулированная переменная анимации, представляющая красный компонент цвета анимации.

CAnimationVariable m_rValue;

CAnimationColor::operator COLORREF

operator COLORREF();

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

CAnimationColor::operator=

Назначает цвет CAnimationColor.

void operator=(COLORREF color);

Параметры

color
Задает новый цвет анимации.

Замечания

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

CAnimationColor::SetDefaultValue

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

void SetDefaultValue(COLORREF color);

Параметры

color
Задает новые значения по умолчанию для красных, зеленых и синих компонентов.

Замечания

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

См. также

Классы