XAnimator QML Type

XAnimator 类型用于对 Item 的 x 位置进行动画处理。更多内容...

Import Statement:	`import QtQuick`
Inherits:	Animator

所有成员的列表，包括继承的成员

详细说明

Animator 类型与普通的 Animation 类型不同。使用 Animator 时，动画可在渲染线程中运行，且动画完成后属性值会跳转至终点。

Item::x 的值会在动画结束后进行更新。

以下代码片段展示了如何将 XAnimator 与 Rectangle 项结合使用。

Rectangle {
    id: xmovingBox
    width: 50
    height: 50
    color: "lightsteelblue"
    XAnimator {
        target: xmovingBox;
        from: 10;
        to: 0;
        duration: 1000
        running: true
    }
}

也可以使用on 关键字将XAnimator直接绑定到Item实例上。

Rectangle {
    width: 50
    height: 50
    color: "lightsteelblue"
    XAnimator on x {
        from: 10;
        to: 0;
        duration: 1000
    }
}

注意： 当使用非多线程渲染循环时，Animator 类型没有任何优势。

注意：建议应用程序 采用基于多线程、异步原则的设计，而不是依赖 Animator 在主（GUI）线程上执行耗时且阻塞的操作时显示动画内容。与其进行漫长且阻塞的操作，不如在 QML 中优先使用WorkerScript 和asynchronous image loading ，并在 C++ 中使用工作线程、并行算法 Qt Concurrent以及协程，从而确保整个应用程序和用户界面始终保持响应。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.