简述

QSequentialAnimationGroup类提供动画的串行组。

QSequentialAnimationGroup是一个串行运行动画的QAnimationGroup，在另一个动画播放结束之后，开启一个新的动画，根据添加到动画组的顺序（使用addAnimation() 或 insertAnimation()）来播放动画，当最后一个动画完成以后，动画组随之完成。

在动画组中每一个时刻最多只有一个动画处于激活状态，可以通过currentAnimation()获得，空组则没有当前动画。

详细描述

一个串行动画组可以被当做任何其它动画，即：它可以被开始、停止、添加到其它动画组中，也可以通过addPause() 或 insertPause()为动画组添加一个暂停。

  1. QSequentialAnimationGroup *group = new QSequentialAnimationGroup;
  3. group->addAnimation(anim1);
  4. group->addAnimation(anim2);
  6. group->start();

这个例子中，anim1、anim2是QPropertyAnimation。

公共函数

  • QPauseAnimation * addPause(int msecs)
    为动画组添加一个msecs毫秒级的暂停。暂停被认为是一种特殊类型的动画，因此animationCount将增加一个。
  • QAbstractAnimation * currentAnimation() const
    返回大年时刻的动画

  • QPauseAnimation * insertPause(int index, int msecs)
    为动画组添加一个msecs毫秒级的暂停，index为动画索引。

    信号

  • void currentAnimationChanged(QAbstractAnimation * current)
    当前动画发生变化时，发射此信号。

    示例

    下面，我们通过QSequentialAnimationGroup来构建一个串行动画组，并添加属性动画QPropertyAnimation，这里也可以使用addAnimation()添加其它动画/动画组，就不予演示了。 ```cpp

QT_BEGIN_NAMESPACE namespace Ui { class Widget; } QT_END_NAMESPACE

class Widget : public QWidget { Q_OBJECT

public: Widget(QWidget parent = nullptr); ~Widget(); protected slots: void startAnimation(); void onCurrentAnimationChanged(QAbstractAnimation current); private: Ui::Widget ui; QSequentialAnimationGroup m_group; };

Widget::Widget(QWidget* parent) : QWidget(parent) , ui(new Ui::Widget) { ui->setupUi(this);
ui->label->setFixedSize(100, 30); ui->label_2->setFixedSize(120, 30);

  1. QPropertyAnimation pAnimation1(ui->label, "geometry");
  2. pAnimation1.setDuration(1000);
  3. pAnimation1.setStartValue(QRect(0, 0, 100, 30));
  4. pAnimation1.setEndValue(QRect(120, 130, 100, 30));
  5. pAnimation1.setEasingCurve(QEasingCurve::OutBounce);
  7. QPropertyAnimation pAnimation2(ui->label_2, "geometry");
  8. pAnimation2.setDuration(1000);
  9. pAnimation2.setStartValue(QRect(120, 130, 120, 30));
  10. pAnimation2.setEndValue(QRect(170, 0, 120, 30));
  11. pAnimation2.setEasingCurve(QEasingCurve::OutInCirc);
  13. m_group = new QSequentialAnimationGroup(this);
  15. // 添加动画
  16. m_group->addAnimation(&pAnimation1);
  18. // 暂停1秒
  19. m_group->addPause(1000);
  20. m_group->addAnimation(&pAnimation2);
  22. // 循环2次
  23. m_group->setLoopCount(2);
  25. // 从后向前执行
  26. m_group->setDirection(QAbstractAnimation::Backward);
  28. connect(m_group, SIGNAL(currentAnimationChanged(QAbstractAnimation*)),
  29.     this, SLOT(onCurrentAnimationChanged(QAbstractAnimation*)));
  31. connect(ui->pushButton, &QPushButton::clicked, this, &Widget::startAnimation);

}

void Widget::startAnimation() { m_group->start(); }

void Widget::onCurrentAnimationChanged(QAbstractAnimation current) { QPropertyAnimation pAnimation = dynamic_cast(current); if (pAnimation == NULL) return;

  1. QLabel* pLabel = dynamic_cast<QLabel*>(pAnimation->targetObject());
  2. if (pLabel != NULL)
  3.     pLabel->setText(pLabel->text() + ".");

}

  1. <a name="q8Wjy"></a>
  2. # 论坛示例
  3. ```cpp
  4. MainWindow::MainWindow(QWidget *parent)
  5.     : CustomWindow(parent)
  6. {
  7.     ...
  9.     QPushButton *pStartButton = new QPushButton(this);
  10.     pStartButton->setText(QString::fromLocal8Bit("开始动画"));
  12.     QList<QLabel *> list;
  13.     QStringList strList;
  14.     strList << QString::fromLocal8Bit("一去丶二三里") << QString::fromLocal8Bit("青春不老，奋斗不止");
  16.     for (int i = 0; i < strList.count(); ++i)
  17.     {
  18.         QLabel *pLabel = new QLabel(this);
  19.         pLabel->setText(strList.at(i));
  20.         pLabel->setAlignment(Qt::AlignCenter);
  21.         list.append(pLabel);
  22.     }
  24.     // 动画一
  25.     QPropertyAnimation *pAnimation1 = new QPropertyAnimation(list.at(0), "geometry");
  26.     pAnimation1->setDuration(1000);
  27.     pAnimation1->setStartValue(QRect(0, 0, 100, 30));
  28.     pAnimation1->setEndValue(QRect(120, 130, 100, 30));
  29.     pAnimation1->setEasingCurve(QEasingCurve::OutBounce);
  31.     // 动画二
  32.     QPropertyAnimation *pAnimation2 = new QPropertyAnimation(list.at(1), "geometry");
  33.     pAnimation2->setDuration(1000);
  34.     pAnimation2->setStartValue(QRect(120, 130, 120, 30));
  35.     pAnimation2->setEndValue(QRect(170, 0, 120, 30));
  36.     pAnimation2->setEasingCurve(QEasingCurve::OutInCirc);
  38.     m_pGroup = new QSequentialAnimationGroup(this);
  40.     // 添加动画
  41.     m_pGroup->addAnimation(pAnimation1);
  43.     // 暂停1秒
  44.     m_pGroup->addPause(1000);
  45.     m_pGroup->addAnimation(pAnimation2);
  47.     // 循环2次
  48.     m_pGroup->setLoopCount(2);
  50.     // 从后向前执行
  51.     m_pGroup->setDirection(QAbstractAnimation::Backward);
  53.     // 连接信号槽
  54.     connect(m_pGroup, SIGNAL(currentAnimationChanged(QAbstractAnimation*)),
  55.             this, SLOT(onCurrentAnimationChanged(QAbstractAnimation*)));
  57.     connect(pStartButton, SIGNAL(clicked(bool)), this, SLOT(startAnimation()));
  59.     ...
  60. }
  1. // 开始动画
  2. void MainWindow::startAnimation()
  3. {
  4.     m_pGroup->start();
  5. }
  7. // 动画切换时会调用
  8. void MainWindow::onCurrentAnimationChanged(QAbstractAnimation *current)
  9. {
  10.     QPropertyAnimation *pAnimation = dynamic_cast<QPropertyAnimation *>(current);
  11.     if (pAnimation == NULL)
  12.         return;
  14.     QLabel *pLabel = dynamic_cast<QLabel *>(pAnimation->targetObject());
  15.     if (pLabel != NULL)
  16.         pLabel->setText(pLabel->text() + ".");
  17. }