TpAnimation 类
V0.2.1TpGUIWidgets
2025-11-14
介绍
动画类；使用指针对象，不要使用对象变量
继承关系
基础信息
| 头文件: | include <TpAnimation.h> |
|---|---|
| Cmake: | None |
| 发布版本: | V0.2.1 |
| 继承类: | TpObject |
| 派生类: |
Public 类型
enum TpAnimation::AnimationType
| 名称 | 值 | 描述 |
|---|---|---|
| Geometry | 0 | 几何属性；位置和大小 |
| Pos | 1 | 位置 |
| Size | 2 | 大小 |
| Height | 3 | 窗体高度 int32_t |
| Width | 4 | 窗体宽度 int32_t |
| WindowOpacity | 5 | 整体不透明度（0透明，1不透明 float |
| BackgroundColor | 6 | 背景颜色 int32_t |
| CustomAnimation | 7 | 自定义动画 ，数值自定义；暂未启用 |
enum TpAnimation::DeletionPolicy
| 名称 | 值 | 描述 |
|---|---|---|
| KeepWhenStopped | 0 | 动画停止时不释放指针 |
| DeleteWhenStopped | 1 | 动画停止时释放指针 |
信号
| 信号名称 | 参数 | 描述 |
|---|---|---|
| finished | 动画完成信号 |
Public 成员函数
| TpAnimation(TpWidget *target, const AnimationType &propertyType) | 动画类构造函数 | |
|---|---|---|
| ~TpAnimation() | ||
| setTargetWidget(TpWidget *target) | 设置动画绑定窗体 | |
| TpWidget * | targetWidget() | 获取当前动画绑定窗体 |
| setLoopCount(const int32_t count) | 设置动画循环次数，默认为1次 | |
| loopCount() | 获取动画循环次数 | |
| setCustomAnimationFunc(CustomAnimationFunc func) | 设置自定义动画处理函数,暂未启用 | |
| setDuration(const uint32_t &timeMs) | 设置动画持续时间 | |
| duration() | 获取动画持续时间 | |
| setStartValue(const TpVariant &value) | 设置动画初始值 | |
| TpVariant | startValue() | 获取动画初始值 |
| setEndValue(const TpVariant &value) | 设置动画终止值 | |
| TpVariant | endValue() | 获取动画终止值 |
| start(const DeletionPolicy &runMode=DeleteWhenStopped) | 启动动画 | |
| pause() | 暂停动画 | |
| stop() | 停止动画 | |
| setKeyValueAt(const float &percent, const TpVariant &value) | 设置在给定步骤使用给定值创建关键帧。给定的步长必须在0到1的范围内 |
成员函数说明
TpAnimation::TpAnimation(TpWidget *target, const AnimationType &propertyType)
动画类构造函数...
动画类构造函数
参数：target: 动画绑定目标
参数：propertyType: 动画类型
virtual TpAnimation::~TpAnimation()
暂无注释...
void TpAnimation::setTargetWidget(TpWidget *target)
设置动画绑定窗体...
设置动画绑定窗体
参数：target: 绑定窗体指针
TpWidget * TpAnimation::targetWidget()
获取当前动画绑定窗体...
获取当前动画绑定窗体
返回值：窗体指针
void TpAnimation::setLoopCount(const int32_t count)
设置动画循环次数，默认为1次...
设置动画循环次数，默认为1次
参数：count: -1为无限循环，需要手动终止动画
int32_t TpAnimation::loopCount()
获取动画循环次数...
获取动画循环次数
返回值：循环次数
void TpAnimation::setCustomAnimationFunc(CustomAnimationFunc func)
设置自定义动画处理函数,暂未启用...
设置自定义动画处理函数,暂未启用
参数：func: 自定义动画值修改函数
void TpAnimation::setDuration(const uint32_t &timeMs)
设置动画持续时间...
设置动画持续时间
参数：timeMs: 时间，单位ms
uint32_t TpAnimation::duration()
获取动画持续时间...
获取动画持续时间
返回值：时间，单位ms
void TpAnimation::setStartValue(const TpVariant &value)
设置动画初始值...
设置动画初始值
参数：value: 初始值，需按照动画对应的数据类型设置
TpVariant TpAnimation::startValue()
获取动画初始值...
获取动画初始值
返回值：初始值
void TpAnimation::setEndValue(const TpVariant &value)
设置动画终止值...
设置动画终止值
参数：value: 需按照动画对应的数据类型设置
TpVariant TpAnimation::endValue()
获取动画终止值...
获取动画终止值
返回值：终止值
void TpAnimation::start(const DeletionPolicy &runMode=DeleteWhenStopped)
启动动画...
启动动画
参数：runMode: 启动模式，默认为动画计算完毕释放指针
void TpAnimation::pause()
暂停动画...
暂停动画
void TpAnimation::stop()
停止动画...
停止动画
void TpAnimation::setKeyValueAt(const float &percent, const TpVariant &value)
设置在给定步骤使用给定值创建关键帧。给定的步长必须在0到1的...
设置在给定步骤使用给定值创建关键帧。给定的步长必须在0到1的范围内
参数：percent: 指定步骤 (0, 1), 为0则会修改StartValue，为1则会修改endValue
参数：value: 步骤对应值
