Qt动画的简单使用（QPropertyAnimation，含源码和注释）

一、Qt动画示例图（移动、缩放、不透明度）

下图为使用不同属性实现的效果，源码在本文第四节（源码含详细注释）。

二、什么是Qt动画

QPropertyAnimation是Qt自带的动画类，该类可以实现简单的控件动画效果，比如对控件的移动、缩放、不透明度这些来做动画效果（使用某效果之前需要使用setPropertyName函数指定需要的动画属性名，以下三个是Qt已经定义好的）。

1. 移动（pos）：主要实现移动效果，如从某个点移动到另一个点，所使用的变量类型为QPoint等。
2. 缩放（geometry）：可实现缩放和移动效果，该属性可以实现指定控件的缩放，并且在缩放的基础上还能实现移动。
3. 不透明度（windowOpacity）：实现控件的透明度设置（不过该属性只能对顶级窗口使用，对普通控件这些无效）。

三、遇到的问题

1. QPropertyAnimation::setPropertyName: you can’t change the property name of a running animation
   该情况是在改变正在使用的动画属性。有可能是在使用某动画时（动画时间未结束时），再次调用该效果；如本文中使用的动画，当动画正在播放时多次点击按钮时出现。

2. QPropertyAnimation: you’re trying to animate a non-existing property windsowOpacity of your QObject
   该情况为使用了不存在的动画属性名。这种情况需要修改动画属性名或自定义属性名（自定义属性名可以先了解Q_PROPERTY）

3. QPropertyAnimation::updateState (动画属性名): Changing state of an animation without target
   该情况为没有指定动画的使用对象，使用setTargetObject函数设置使用对象即可

4. 使用QPropertyAnimation最好不要使用局部变量，运行完后局部变量直接释放，动画就会没效果

四、源码

CMainWindow.h

#ifndef CMAINWINDOW_H
#define CMAINWINDOW_H

#include <QMainWindow>
#include <QPropertyAnimation>

namespace Ui {
class CMainWindow;
}

class CMainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit CMainWindow(QWidget *parent = 0);
    ~CMainWindow();

private slots:

    void on_posMoveBtn_clicked();   //pos

    void on_rectMoveBtn_clicked();  //geometry

    void on_opacityAnimationBtn_clicked();  //opacity

private:
    Ui::CMainWindow *ui;

    QPropertyAnimation *m_animation;        //动画对象指针
};

#endif // CMAINWINDOW_H

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

CMainWindow.cpp

#include "CMainWindow.h"
#include "ui_CMainWindow.h"

CMainWindow::CMainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::CMainWindow)
{
    ui->setupUi(this);
    //创建动画对象空间（初始化可以指定动画控件和动画需使用的动画属性名）
    m_animation = new QPropertyAnimation();
    m_animation->setTargetObject(ui->label);    //设置使用动画的控件
    m_animation->setEasingCurve(QEasingCurve::Linear); //设置动画效果
    //!统一的效果可以在对象创建的位置设置（如动画属性名、动画时间、动画使用对象等）
    //! 不同的设置在使用位置单独设置即可
}

CMainWindow::~CMainWindow()
{
    delete m_animation;
    delete ui;
}

void CMainWindow::on_posMoveBtn_clicked()
{
    //pos:按点移动的动画（移动）
    m_animation->setPropertyName("pos");    //指定动画属性名
    m_animation->setDuration(3000);    //设置动画时间（单位：毫秒）
    m_animation->setStartValue(ui->label->pos());  //设置动画起始位置在label控件当前的pos
    m_animation->setEndValue(ui->label->pos() + QPoint(200, 100)); //设置动画结束位置
    m_animation->start();   //启动动画
}

void CMainWindow::on_rectMoveBtn_clicked()
{
    //geometry:按矩形的动画（移动和缩放）
    m_animation->setPropertyName("geometry");   //指定动画属性名
    m_animation->setDuration(3000);    //设置动画时间（单位：毫秒）
    m_animation->setStartValue(ui->label->rect());  //设置动画起始位置

    //获取控件初始的大小
    int width = ui->label->rect().width();
    int height = ui->label->rect().height();

    //设置动画步长值，以及在该位置时的长宽
    m_animation->setKeyValueAt(0.5, QRect(ui->label->pos() - QPoint(100, 50)
                                  ,QSize( width + 50, height + 35)));

    m_animation->setEndValue(QRect(ui->label->pos() - QPoint(100, 50)
                             ,QSize( width, height))); //设置动画结束位置及其大小
    m_animation->start();   //启动动画
}

void CMainWindow::on_opacityAnimationBtn_clicked()
{
    //windowOpacity：不透明度（注意该效果只对顶级窗口有效哦）
    m_animation->setTargetObject(this);     //重设动画使用对象
    m_animation->setPropertyName("windowOpacity");  //指定动画属性名
    m_animation->setDuration(2000);     //设置动画时间（单位：毫秒）

    //设置动画步长值，以及在该位置时显示的透明度
    m_animation->setKeyValueAt(0, 1);
    m_animation->setKeyValueAt(0.5, 0);
    m_animation->setKeyValueAt(1, 0);

    m_animation->setLoopCount(-1);  //当值为-1时，动画一直运行，直到窗口关闭
    m_animation->start();   //启动动画
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

总结

当项目需要实现滑动进入或者循环缩放效果时可以使用QPropertyAnimation类，不过windowOpacity仅限顶级窗口使用，因此某控件单独的不透明度设置需要自定义

相关文档

Qt设置指定控件的不透明度（QPropertyAnimation + 自定义属性实现，含源码和注释）

友情提示——哪里看不懂可私哦，让我们一起互相进步吧
（创作不易，请留下一个免费的赞叭 谢谢 ^o^/)

注：文章为作者编程过程中所遇到的问题和总结，内容仅供参考，若有错误欢迎指出。
注：如有侵权，请联系作者删除