Класс 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.
Иерархия наследования
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), необходимо повторно включить эти события.