QT之QPropertyAnimation动画类的介绍

简介

QPropertyAnimation是Qt框架中的一个类，它用于在给定时间间隔内对QObject的属性进行动画化的平滑过渡。可以使用QPropertyAnimation实现各种动画效果，如淡入淡出、位移、旋转等。

QPropertyAnimation的初始化需要三个参数：

QPropertyAnimation(QObjecttarget,constQByteArray&propertyName,QObjectparent=nullptr)。第一个参数是目标对象，它是要实施动画的对象。第二个参数是描述字符串常量，它定义了要动画化的属性名称。最后一个参数是可选的父对象。

成员函数

1）void setTargetObject(QObject *target)
设置目标对象。

2）QObject *targetObject() const
返回目标对象。

3）void setPropertyName(const QByteArray &propertyName)
设置属性名称。

4）QByteArray propertyName() const
返回属性名称。

5）void setValue(const QVariant &value)
设置属性的最终值。

6）QVariant value() const
返回属性的最终值。

7）void setFromValue(const QVariant &value)
设置属性的起始值。

8）QVariant fromValue() const
返回属性的起始值。

9）void setDuration(int duration)
设置动画的持续时间。

10）int duration() const
返回动画的持续时间。

11）void setEasingCurve(const QEasingCurve &easing)
设置动画的缓动曲线。

12）QEasingCurve easingCurve() const
返回动画的缓动曲线。

13）void setLoopCount(int count)
设置动画的循环次数。

14）int loopCount() const
返回动画的循环次数。

15）void setLooping(bool enable)
设置动画是否循环播放。

16）bool isLooping() const
返回动画是否循环播放。

17）void start()
启动动画。

18）void stop()
停止动画。

19）QState state() const
返回动画的状态。

20）void setState(QState state)
设置动画的状态。

21）bool isRunning() const
返回动画是否正在运行。

22）bool isPaused() const
返回动画是否已暂停。

23）bool isStopped() const
返回动画是否已停止。

24）void pause()
暂停动画。

25）void resume()
恢复动画的运行。

26）void reset()
重置动画到初始状态。

27）void seek(int ms)
将动画跳转到指定时间位置。

28）int currentTime() const
返回当前动画的时间位置。

29）int totalTime() const
返回动画的总时间长度。

30）void setDirection(QAbstractAnimation::Direction direction)
设置动画的方向（正向或反向）。

31）QAbstractAnimation::Direction direction() const
返回动画的方向。

32）void setReverseDirection(QAbstractAnimation::Direction direction)
设置反向播放时的动画方向。

33）QAbstractAnimation::Direction reverseDirection() const
返回反向播放时的动画方向。

34）void setInterpolationMode(QAbstractAnimation::InterpolationMode mode)
设置插值模式（线性或平滑）。

35）QAbstractAnimation::InterpolationMode interpolationMode() const
返回插值模式。

36）void setStartValue(const QVariant &value)
设置属性的起始值（与fromValue()相同）。

37）QVariant startValue() const
返回属性的起始值（与fromValue()相同）。

38）void setEndValue(const QVariant &value)
设置属性的最终值（与value()相同）。

39）QVariant endValue() const
返回属性的最终值（与value()相同）。

例程

#include <QApplication>  
#include <QGraphicsObject>  
#include <QPropertyAnimation>  
  
class MyObject : public QGraphicsObject  
{  
public:  
    MyObject(QObject *parent = nullptr)  
        : QGraphicsObject(parent)  
    {  
    }  
  
    QRectF boundingRect() const override  
    {  
        return QRectF(0, 0, 50, 50);  
    }  
  
    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override  
    {  
        Q_UNUSED(option);  
        Q_UNUSED(widget);  
        painter->drawRect(boundingRect());  
    }  
};  
  
int main(int argc, char *argv[])  
{  
    QApplication a(argc, argv);  
  
    MyObject object;  
    QPropertyAnimation animation(&object, "pos");  
    animation.setStartValue(QPointF(0, 0));  
    animation.setEndValue(QPointF(100, 100));  
    animation.setDuration(1000);  
    animation.start();  
  
    return a.exec();  
}

在这个示例中，创建了一个MyObject类，它从QGraphicsObject继承而来。在主函数中，创建了MyObject对象和QPropertyAnimation对象。通过调用QPropertyAnimation的start()方法，启动了动画，使得object的位置属性在1秒内从(0,0)平滑过渡到(100,100)。