Класс CAnimationRect
Реализует функции прямоугольника, стороны которого могут быть анимированы.
Синтаксис
class CAnimationRect : public CAnimationBaseObject;
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| CAnimationRect::CAnimationRect | Перегружен. Создает объект анимации rect. |
Открытые методы
| Имя | Описание |
|---|---|
| CAnimationRect::AddTransition | Добавляет переходы для левых, верхних, правых и нижних координат. |
| CAnimationRect::GetBottom | Предоставляет доступ к CAnimationVariable, представляющей нижняя координата. |
| CAnimationRect::GetDefaultValue | Возвращает значения по умолчанию для границ прямоугольника. |
| CAnimationRect::GetLeft | Предоставляет доступ к CAnimationVariable, представляющей левую координату. |
| CAnimationRect::GetRight | Предоставляет доступ к CAnimationVariable, представляющей правую координату. |
| CAnimationRect::GetTop | Предоставляет доступ к CAnimationVariable, представляющей верхнюю координату. |
| CAnimationRect::GetValue | Возвращает текущее значение. |
| CAnimationRect::SetDefaultValue | Задает значение по умолчанию. |
Защищенные методы
| Имя | Описание |
|---|---|
| CAnimationRect::GetAnimationVariableList | Помещает инкапсулированные переменные анимации в список. (Переопределения CAnimationBaseObject::GetAnimationVariableList.) |
Открытые операторы
| Имя | Описание |
|---|---|
| CAnimationRect::operator RECT | Преобразует CAnimationRect в RECT. |
| CAnimationRect::operator= | Назначает прямоугольник CAnimationRect. |
Открытые члены данных
| Имя | Описание |
|---|---|
| CAnimationRect::m_bFixedSize | Указывает, имеет ли прямоугольник фиксированный размер. |
Защищенные члены данных
| Имя | Описание |
|---|---|
| CAnimationRect::m_bottomValue | Инкапсулированная переменная анимации, представляющая нижний предел прямоугольника анимации. |
| CAnimationRect::m_leftValue | Инкапсулированная переменная анимации, представляющая левую границу прямоугольника анимации. |
| CAnimationRect::m_rightValue | Инкапсулированная переменная анимации, представляющая правую границу прямоугольника анимации. |
| CAnimationRect::m_szInitial | Задает начальный размер прямоугольника анимации. |
| CAnimationRect::m_topValue | Инкапсулированная переменная анимации, представляющая верхнюю границу прямоугольника анимации. |
Замечания
Класс CAnimationRect инкапсулирует четыре объекта CAnimationVariable и может представлять в приложениях прямоугольник. Чтобы использовать этот класс в приложении, просто создайте экземпляр объекта этого класса, добавьте его в контроллер анимации с помощью CAnimationController::AddAnimationObject и вызова AddTransition для каждого перехода, который будет применен к левым, правым и нижним координатам.
Иерархия наследования
CAnimationRect
Требования
Заголовок: afxanimationcontroller.h
CAnimationRect::AddTransition
Добавляет переходы для левых, верхних, правых и нижних координат.
void AddTransition(
CBaseTransition* pLeftTransition,
CBaseTransition* pTopTransition,
CBaseTransition* pRightTransition,
CBaseTransition* pBottomTransition);
Параметры
pLeftTransition
Указывает переход для левой стороны.
pTopTransition
Указывает переход для верхней стороны.
pRightTransition
Указывает переход для правой стороны.
pBottomTransition
Указывает переход для нижней стороны.
Замечания
Вызовите эту функцию, чтобы добавить указанные переходы во внутренний список переходов, применяемых к переменным анимации для каждой прямоугольники. При добавлении переходов они не применяются немедленно и хранятся во внутреннем списке. Переходы применяются (добавляются в раскадровки для определенного значения) при вызове CAnimationController::AnimateGroup. Если вам не нужно применять переход к одной из сторон прямоугольника, можно передать значение NULL.
CAnimationRect::CAnimationRect
Создает объект CAnimationRect.
CAnimationRect();
CAnimationRect(
const CRect& rect,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
CAnimationRect(
const CPoint& pt,
const CSize& sz,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
CAnimationRect(
int nLeft,
int nTop,
int nRight,
int nBottom,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
Параметры
rect
Задает прямоугольник по умолчанию.
nGroupID
Указывает идентификатор группы.
nObjectID
Указывает идентификатор объекта.
dwUserData
Задает определяемые пользователем данные.
пт
Координата левого верхнего угла.
sz
Размер прямоугольника.
nLeft
Указывает координату левой границы.
nTop
Указывает координату верхней границы.
nRight
Указывает координату правой границы.
nBottom
Указывает координату нижней границы.
Замечания
Объект построен со значениями по умолчанию для левого, верхнего, правого и нижнего, идентификатора объекта и идентификатора группы, который будет иметь значение 0. Их можно изменить позже во время выполнения с помощью SetDefaultValue и SetID.
CAnimationRect::GetAnimationVariableList
Помещает инкапсулированные переменные анимации в список.
virtual void GetAnimationVariableList(
CList<CAnimationVariable*,
CAnimationVariable*>& lst);
Параметры
lst
Когда функция возвращается, она содержит указатели на четыре объекта CAnimationVariable, представляющих координаты прямоугольника.
CAnimationRect::GetBottom
Предоставляет доступ к CAnimationVariable, представляющей нижняя координата.
CAnimationVariable& GetBottom();
Возвращаемое значение
Ссылка на инкапсулированную CAnimationVariable, представляющую нижнюю координату.
Замечания
Этот метод можно вызвать, чтобы получить прямой доступ к базовой CAnimationVariable, представляющей нижняя координата.
CAnimationRect::GetDefaultValue
Возвращает значения по умолчанию для границ прямоугольника.
CRect GetDefaultValue();
Возвращаемое значение
Значение CRect, содержащее значения по умолчанию для левого, правого, верхнего и нижнего.
Замечания
Вызовите эту функцию, чтобы получить значение по умолчанию, которое ранее было задано конструктором или SetDefaultValue.
CAnimationRect::GetLeft
Предоставляет доступ к CAnimationVariable, представляющей левую координату.
CAnimationVariable& GetLeft();
Возвращаемое значение
Ссылка на инкапсулированную CAnimationVariable, представляющую левую координату.
Замечания
Этот метод можно вызвать, чтобы получить прямой доступ к базовой CAnimationVariable, представляющей левую координату.
CAnimationRect::GetRight
Предоставляет доступ к CAnimationVariable, представляющей правую координату.
CAnimationVariable& GetRight();
Возвращаемое значение
Ссылка на инкапсулированную CAnimationVariable, представляющую правильную координату.
Замечания
Этот метод можно вызвать, чтобы получить прямой доступ к базовой CAnimationVariable, представляющей правильную координату.
CAnimationRect::GetTop
Предоставляет доступ к CAnimationVariable, представляющей верхнюю координату.
CAnimationVariable& GetTop();
Возвращаемое значение
Ссылка на инкапсулированную CAnimationVariable, представляющую верхнюю координату.
Замечания
Этот метод можно вызвать, чтобы получить прямой доступ к базовой CAnimationVariable, представляющей верхнюю координату.
CAnimationRect::GetValue
Возвращает текущее значение.
BOOL GetValue(CRect& rect);
Параметры
rect
Выход. Содержит текущее значение при возврате этого метода.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если текущее значение успешно получено; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Вызовите эту функцию, чтобы получить текущее значение прямоугольника анимации. Если этот метод завершается ошибкой или базовыми COM-объектами для левого, верхнего, правого и нижнего не инициализированы, прямоугольник содержит значение по умолчанию, которое ранее было задано в конструкторе или SetDefaultValue.
CAnimationRect::m_bFixedSize
Указывает, имеет ли прямоугольник фиксированный размер.
BOOL m_bFixedSize;
Замечания
Если этот элемент имеет значение true, размер прямоугольника фиксирован, а нижний и нижний значения пересчитываются каждый раз, когда верхний левый угол перемещается в соответствии с фиксированным размером. Задайте для этого значения значение TRUE, чтобы легко переместить прямоугольник по экрану. В этом случае переходы, применяемые к правым и нижним координатам, игнорируются. Размер сохраняется внутренне при создании объекта и (или) вызове SetDefaultValue. По умолчанию этот элемент имеет значение FALSE.
CAnimationRect::m_bottomValue
Инкапсулированная переменная анимации, представляющая нижний предел прямоугольника анимации.
CAnimationVariable m_bottomValue;
CAnimationRect::m_leftValue
Инкапсулированная переменная анимации, представляющая левую границу прямоугольника анимации.
CAnimationVariable m_leftValue;
CAnimationRect::m_rightValue
Инкапсулированная переменная анимации, представляющая правую границу прямоугольника анимации.
CAnimationVariable m_rightValue;
CAnimationRect::m_szInitial
Задает начальный размер прямоугольника анимации.
CSize m_szInitial;
CAnimationRect::m_topValue
Инкапсулированная переменная анимации, представляющая верхнюю границу прямоугольника анимации.
CAnimationVariable m_topValue;
CAnimationRect::operator RECT
Преобразует CAnimationRect в RECT.
operator RECT();
Возвращаемое значение
Текущее значение прямоугольника анимации в качестве RECT.
Замечания
Эта функция внутренне вызывает GetValue. Если GetValue по какой-то причине завершается сбоем, возвращаемый RECT будет содержать значения по умолчанию для всех координат прямоугольника.
CAnimationRect::operator=
Назначает прямоугольник CAnimationRect.
void operator=(const RECT& rect);
Параметры
rect
Новое значение прямоугольника анимации.
Замечания
Рекомендуется сделать это перед началом анимации, так как этот оператор вызывает SetDefaultValue, который воссоздает базовые COM-объекты для цветовых компонентов, если они созданы. Если вы подписали этот объект анимации на события (ValueChanged или IntegerValueChanged), необходимо повторно включить эти события.
CAnimationRect::SetDefaultValue
Задает значение по умолчанию.
void SetDefaultValue(const CRect& rect);
Параметры
rect
Задает новые значения по умолчанию для левого, верхнего, правого и нижнего.
Замечания
Используйте эту функцию, чтобы задать значение по умолчанию для объекта анимации. Эти методы присваивают значения по умолчанию границам прямоугольника. Он также воссоздает базовые COM-объекты, если они были созданы. Если вы подписали этот объект анимации на события (ValueChanged или IntegerValueChanged), необходимо повторно включить эти события.