PySide超入門【第21回 | 応用編】QPropertyAnimationで簡単GUIアニメーションの作り方解説

GUIアプリケーションの操作性や見た目を向上させるために、アニメーションは非常に有効な手段です。PySide（Qt）では、QPropertyAnimation クラスを使ってウィジェットのプロパティを時間をかけて滑らかに変化させることができます。

本記事では、QPropertyAnimation の基本的な使い方から、主なプロパティやメソッドの解説、よくある質問まで詳しく解説していきます。
これをマスターすれば、ボタンの移動やフェードイン・アウト、サイズ変更など、多彩なアニメーションを簡単に実装できるようになります。

QPropertyAnimationとは？

QPropertyAnimation は、対象オブジェクトの指定したプロパティの値を、開始値から終了値まで時間をかけて変化させるアニメーションを実現するクラスです。
主にGUI部品の移動、サイズ変更、色の変更などに使われます。

基本コード

from PySide6.QtWidgets import QApplication, QWidget, QPushButton
from PySide6.QtCore import QPropertyAnimation, QRect
import sys

app = QApplication(sys.argv)

class Window(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("QPropertyAnimationの例")
        self.resize(400, 300)

        self.button = QPushButton("動くボタン", self)
        self.button.setGeometry(50, 50, 100, 40)

        # アニメーション設定
        self.anim = QPropertyAnimation(self.button, b"geometry")
        self.anim.setDuration(1000)  # 1秒
        self.anim.setStartValue(QRect(50, 50, 100, 40))
        self.anim.setEndValue(QRect(250, 200, 100, 40))
        self.anim.start()

window = Window()
window.show()
sys.exit(app.exec())

主なプロパティとメソッド一覧（全解説）

各プロパティ・メソッド 詳細解説

【1】アニメーションの対象を設定

概要：アニメーションをかけたいオブジェクトを設定します。
メソッド：setTargetObject(obj)
使い方：

self.anim.setTargetObject(self.button)

【2】アニメーションさせるプロパティ名を設定

概要：アニメーションで変化させるオブジェクトのプロパティ名を指定します。QPropertyAnimation で指定できるのは、Qt のオブジェクトが Q_PROPERTY として公開しているプロパティ名だけです。
メソッド：setPropertyName(bytes)
使い方：

self.anim.setPropertyName(b"geometry")

【3】開始値を設定

概要：アニメーション開始時のプロパティの値を設定します。
引数：アニメーション対象プロパティに応じた型（例：int, float, QColor, QRect など）
メソッド：setStartValue(value)
使い方：QRect(x, y, width, height)

self.anim.setStartValue(QRect(0, 0, 100, 30))

【4】終了値を設定

概要：アニメーション終了時のプロパティの値を設定します。
引数：アニメーション対象プロパティに応じた型（例：int, float, QColor, QRect など）
メソッド：setEndValue(value)
使い方：QRect(x, y, width, height)

self.anim.setEndValue(QRect(250, 250, 100, 30))

【5】アニメーションの継続時間を設定

概要：アニメーションが完了するまでの時間（ミリ秒）を設定します。
メソッド：setDuration(int)
使い方：

self.setDuration(5000)  # 5秒

【6】アニメーションのイージング曲線を設定

概要：アニメーションの進み方（速度カーブ）を設定します。例えば 線形、加速、減速、弾む、跳ねる、弾性のように伸び縮みする などです。
メソッド：setEasingCurve(QEasingCurve)
使い方：

from PySide6.QtCore import QEasingCurve
self.anim.setEasingCurve(QEasingCurve.OutBounce)

【7】アニメーションの開始

概要：設定したアニメーションを開始します。
メソッド：start()
使い方：

self.anim.start()

【8】アニメーションの停止

概要：実行中のアニメーションを停止します。
メソッド：stop()
使い方：

self.anim.stop()

【9】アニメーションのループ回数を設定

概要：アニメーションを繰り返す回数を設定します。-1で無限ループになります。
メソッド：setLoopCount(int)
使い方：

self.anim.setLoopCount(3)  # 3回繰り返す

【10】アニメーションの現在の進行状況を取得

概要：アニメーションの現在の進行度（0〜1）を取得します。
メソッド：currentTime()
使い方：

time = self.anim.currentTime()
print(time)
# 0

【11】アニメーションの状態を取得

概要：アニメーションが動いているか停止しているかを取得します。
メソッド：state()
使い方：

from PySide6.QtCore import QAbstractAnimation
if self.anim.state() == QAbstractAnimation.Running:
    print("動作中")

# 動作中

【12】アニメーションの一時停止

概要：実行中のアニメーションを一時停止します。
メソッド：pause()
使い方：

self.anim.pause()

【13】アニメーションの再開

概要：一時停止したアニメーションを再開します。
メソッド：resume()
使い方：

self.anim.resume()

【14】アニメーションの進行方向を設定

概要：アニメーションの再生方向を設定します（順再生・逆再生）。
メソッド：setDirection(QAbstractAnimation.Direction)
使い方：

from PySide6.QtCore import QAbstractAnimation
self.anim.setDirection(QAbstractAnimation.Backward)

【15】アニメーションの進行方向を取得

概要：現在のアニメーションの方向を取得します。
メソッド：direction()
使い方：

dir = self.anim.direction()
print(dir)
# Direction.Backward

【16】アニメーション終了時のシグナル

概要：アニメーションが終了したときに発行されるシグナルです。
シグナル：finished
使い方：

def __init__(self):
    self.anim.finished.connect(self.on_animation_finished)

def on_animation_finished(self):
    print("アニメーションが終了しました！")

# アニメーションが終了しました

よくある質問（FAQ）

QPropertyAnimationはどんなプロパティに使えますか？

Qtのオブジェクトで、プロパティとして登録されているものに使えます。例えば、geometry（位置・サイズ）、pos（位置）、size（サイズ）、windowOpacity（透明度）などです。

アニメーションの速度を変えたいときは？

setDuration() で時間を調整できます。短くすると速く、長くするとゆっくり動きます。

アニメーションの進み方（曲線）を変更できますか？

はい、setEasingCurve() に QEasingCurve の各種プリセットを設定できます。例えば、OutBounce や InOutQuad などがあります。

アニメーションを途中で止めることはできますか？

stop() メソッドでアニメーションを停止できます。

複数のアニメーションを連続で実行したい場合は？

QSequentialAnimationGroup を使うと複数の QPropertyAnimation を順番に実行できます。

まとめ

本記事では、PySide6のQPropertyAnimationを使ったGUIアニメーションの基本から応用までを解説しました。プロパティの設定や動作のカスタマイズ方法を理解することで、より魅力的で動きのあるインターフェースを実装できるようになります。

次回は、GUIの時間制御や繰り返し処理で欠かせないQTimerについて詳しく解説します。タイマーを使ったイベント発火の仕組みや実践的な活用例を紹介しますので、ぜひご期待ください！

使える.py

PySide超入門【第22回 | 応用編】時計・カウンター・プログレスバーを作ろう！QTimer徹底解説 | 使える.py GUIアプリケーションを作るときに「一定間隔で処理を実行したい」「自動的に画面を更新したい」という場面はよくあります。例えば「時計アプリで1秒ごとに時間を更新する」…