Doc: Update the animation framework overview

- Clarify how the object ownership works
- Language clean up
- Update the snippets

Pick-to: 6.4 6.3 6.2
Task-number: QTBUG-106071
Change-Id: I7caf42a150ef82dee920df4d03db6fd988796bd4
Reviewed-by: Jan Arve Sæther <jan-arve.saether@qt.io>

1 files changed, 89 insertions, 5 deletions

diff --git a/src/corelib/doc/snippets/code/src_corelib_animation_qpropertyanimation.cpp b/src/corelib/doc/snippets/code/src_corelib_animation_qpropertyanimation.cpp
index e50581a2c8..f8b74cd542 100644
--- a/src/corelib/doc/snippets/code/src_corelib_animation_qpropertyanimation.cpp
+++ b/src/corelib/doc/snippets/code/src_corelib_animation_qpropertyanimation.cpp
@@ -3,10 +3,94 @@
 
 
 //! [0]
-    QPropertyAnimation *animation = new QPropertyAnimation(myWidget, "geometry");
-    animation->setDuration(10000);
-    animation->setStartValue(QRect(0, 0, 100, 30));
-    animation->setEndValue(QRect(250, 250, 100, 30));
+#include <QApplication>
+#include <QPushButton>
+#include <QPropertyAnimation>
+//! [1]
+class MyButtonWidget : public QWidget
+{
+public:
+    MyButtonWidget(QWidget *parent = nullptr);
+};
 
-    animation->start();
+MyButtonWidget::MyButtonWidget(QWidget *parent) : QWidget(parent)
+{
+    QPushButton *button = new QPushButton(tr("Animated Button"), this);
+    QPropertyAnimation *anim = new QPropertyAnimation(button, "pos", this);
+    anim->setDuration(10000);
+    anim->setStartValue(QPoint(0, 0));
+    anim->setEndValue(QPoint(100, 250));
+    anim->start();
+}
+
+int main(int argc, char *argv[])
+{
+    QApplication a(argc, argv);
+    MyButtonWidget buttonAnimWidget;
+    buttonAnimWidget.resize(QSize(800, 600));
+    buttonAnimWidget.show();
+    return a.exec();
+}
+//! [1]
 //! [0]
+
+
+//! [easing-curve]
+MyButtonWidget::MyButtonWidget(QWidget *parent) : QWidget(parent)
+{
+    QPushButton *button = new QPushButton(tr("Animated Button"), this);
+    QPropertyAnimation *anim = new QPropertyAnimation(button, "pos", this);
+    anim->setDuration(10000);
+    anim->setStartValue(QPoint(0, 0));
+    anim->setEndValue(QPoint(100, 250));
+    anim->setEasingCurve(QEasingCurve::OutBounce);
+    anim->start();
+}
+//! [easing-curve]
+
+
+//! [animation-group1]
+MyButtonWidget::MyButtonWidget(QWidget *parent) : QWidget(parent)
+{
+    QPushButton *bonnie = new QPushButton(tr("Bonnie"), this);
+    QPushButton *clyde = new QPushButton(tr("Clyde"), this);
+
+    QPropertyAnimation *anim1 = new QPropertyAnimation(bonnie, "pos", this);
+    anim1->setDuration(3000);
+    anim1->setStartValue(QPoint(0, 0));
+    anim1->setEndValue(QPoint(100, 250));
+
+    QPropertyAnimation *anim2 = new QPropertyAnimation(clyde, "pos", this);
+    anim2->setDuration(3000);
+    anim2->setStartValue(QPoint(100, 250));
+    anim2->setEndValue(QPoint(500, 500));
+
+    QParallelAnimationGroup *parallelAnim = new QParallelAnimationGroup;
+    parallelAnim->addAnimation(anim1);
+    parallelAnim->addAnimation(anim2);
+    parallelAnim->start();
+}
+//! [animation-group1]
+
+//! [animation-group2]
+MyButtonWidget::MyButtonWidget(QWidget *parent) : QWidget(parent)
+{
+    QPushButton *bonnie = new QPushButton(tr("Bonnie"), this);
+    QPushButton *clyde = new QPushButton(tr("Clyde"), this);
+
+    QPropertyAnimation *anim1 = new QPropertyAnimation(bonnie, "pos", this);
+    anim1->setDuration(3000);
+    anim1->setStartValue(QPoint(0, 0));
+    anim1->setEndValue(QPoint(100, 250));
+
+    QPropertyAnimation *anim2 = new QPropertyAnimation(clyde, "pos", this);
+    anim2->setDuration(3000);
+    anim2->setStartValue(QPoint(0, 0));
+    anim2->setEndValue(QPoint(200, 250));
+
+    QSequentialAnimationGroup *sequenceAnim = new QSequentialAnimationGroup;
+    sequenceAnim->addAnimation(anim1);
+    sequenceAnim->addAnimation(anim2);
+    sequenceAnim->start();
+}
+//! [animation-group2]