python qpropertyanimation

介绍

QPropertyAnimation是Qt框架中的一个类，用于在Qt应用程序中实现动画效果。它可以控制 QWidget 或 QObject 类的属性值随时间的变化而变化，从而实现平滑的动画效果。

在本文中，我们将详细介绍 QPropertyAnimation 的使用方法和一些常见的应用场景。

QPropertyAnimation 的基本用法

首先，我们需要在代码中导入 QPropertyAnimation 类：

from PyQt5.QtCore import QPropertyAnimation

然后，我们可以创建一个 QPropertyAnimation 对象，并传入要进行动画的对象和属性名。下面是一个示例，实现了一个窗口的平移动画效果：

from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
from PyQt5.QtCore import Qt, QPropertyAnimation

class MainWindow(QMainWindow):
    def __init__(self):
        super(MainWindow, self).__init__()

        self.button = QPushButton('Click Me', self)
        self.button.setGeometry(100, 100, 100, 30)

    def animate(self):
        animation = QPropertyAnimation(self.button, b"pos")
        animation.setDuration(1000)  # 设置动画时长，单位为毫秒
        animation.setStartValue(self.button.pos())  # 设置动画起始位置
        animation.setEndValue(self.button.pos() + Qt.QPoint(100, 0))  # 设置动画结束位置
        animation.start()  # 启动动画

if __name__ == '__main__':
    app = QApplication([])
    window = MainWindow()
    window.show()

    window.animate()

    app.exec_()

在上面的代码中，我们首先创建了一个窗口类 MainWindow。该窗口只包含一个按钮 self.button。在 animate 方法中，我们创建了一个 QPropertyAnimation 对象 animation，并指定要对按钮的位置属性 pos 进行动画。setDuration 方法设置了动画的时长为 1000 毫秒，setStartValue 和 setEndValue 方法分别设置了动画起始位置和结束位置。最后，我们通过调用 start 方法启动动画。

运行上面的代码，可以看到按钮从原始位置水平向右移动了 100 像素的距离。

支持的属性类型

QPropertyAnimation 支持对 QWidget 和 QObject 对象的多种属性进行动画。常见的属性类型包括：

Bool: b"propertyName"
Int: i"propertyName"
Float: f"propertyName"
Double: d"propertyName"
Size: s"propertyName"
Rect: r"propertyName"
Point: p"propertyName"
Color: c"propertyName"

以 b"propertyName" 为例，其中 b 表示属性的类型为 Bool，"propertyName" 是要进行动画的属性名。

动画曲线

QPropertyAnimation 支持多种动画曲线类型，用于控制属性值随时间的变化方式。常见的动画曲线类型包括：

线性：animation.setEasingCurve(Qt.QEasingCurve.Linear)
加速：animation.setEasingCurve(Qt.QEasingCurve.InQuad)
减速：animation.setEasingCurve(Qt.QEasingCurve.OutQuad)
先加速后减速：animation.setEasingCurve(Qt.QEasingCurve.InOutQuad)
先减速后加速：animation.setEasingCurve(Qt.QEasingCurve.OutInQuad)

上面的代码演示了如何使用 setEasingCurve 方法来设置动画的曲线类型。

动画信号

QPropertyAnimation 提供了一些信号，用于在动画过程中捕获各个阶段的事件。常用的信号包括：

valueChanged(newValue)：在每个动画帧之间发出，传递当前属性值
finished()：在动画结束时发出

下面是一个示例，演示了如何使用 valueChanged 信号来实时更新窗口标题显示动画进度百分比：

from PyQt5.QtWidgets import QApplication, QMainWindow, QLabel
from PyQt5.QtCore import QPropertyAnimation, Qt

class MainWindow(QMainWindow):
    def __init__(self):
        super(MainWindow, self).__init__()

        self.label = QLabel('Animation in progress...', self)
        self.label.setAlignment(Qt.AlignCenter)
        self.setCentralWidget(self.label)

    def animate(self):
        animation = QPropertyAnimation(self.label, b"windowTitle")
        animation.setDuration(1000)
        animation.setStartValue('0%')
        animation.setEndValue('100%')
        animation.start()

        animation.valueChanged.connect(self.updateWindowTitle)
        animation.finished.connect(self.animationFinished)

    def updateWindowTitle(self, newValue):
        self.setWindowTitle(newValue)

    def animationFinished(self):
        self.setWindowTitle('Animation Finished')

if __name__ == '__main__':
    app = QApplication([])
    window = MainWindow()
    window.show()

    window.animate()

    app.exec_()

在上面的示例中，我们在窗口的标题栏显示动画进度百分比。在 updateWindowTitle 方法中，我们将接收到的新值设置为窗口的标题，从而实现实时更新。在动画完成时，在 animationFinished 方法中我们将标题设置为 “Animation Finished”。

自定义属性动画

除了控制QWidget和QObject类的内置属性，我们还可以通过定义自己的属性来实现动画效果。

例如，我们可以为一个自定义类添加一个新的属性，并对其进行动画处理。下面是一个示例，创建了一个 MyObject 类，添加了一个自定义属性 value，并对该属性进行动画处理：

from PyQt5.QtWidgets import QApplication
from PyQt5.QtCore import QObject, QPropertyAnimation

class MyObject(QObject):
    def __init__(self):
        super(MyObject, self).__init__()
        self._value = 0

    def getValue(self):
        return self._value

    def setValue(self, value):
        self._value = value

    value = property(getValue, setValue)

if __name__ == '__main__':
    app = QApplication([])

    obj = MyObject()
    animation = QPropertyAnimation(obj, b"value")
    animation.setDuration(1000)
    animation.setStartValue(0)
    animation.setEndValue(100)
    animation.start()

    app.exec_()

在上面的示例中，我们首先定义了一个名为 MyObject 的自定义类。该类添加了一个 value 属性，使用 property 函数定义了属性的 getter 和 setter 方法。在 main 函数中，我们创建了一个 MyObject 实例 obj，并对其 value 属性进行动画处理。

小结

本文介绍了 QPropertyAnimation 的基本用法和常见应用场景。QPropertyAnimation 可以用于实现平滑的动画效果，控制 QWidget 和 QObject 对象的属性值随时间的变化而变化。通过对 QPropertyAnimation 的学习和实践，可以为 Python Qt 应用程序添加丰富的动画效果，提升用户体验。