XQtLoading 使用文档
简介
XQtLoading 是一个自定义的加载动画组件,旨在为用户提供可配置的旋转花瓣动画效果。它可以在应用程序中用于指示加载状态,提升用户体验。
特征
- 可配置性:用户可以根据需求调整旋转周期、缩放周期、最大/最小缩放比例、花瓣数量及颜色等参数。
- 易于集成:可以轻松地将 XQtLoading 组件添加到现有的 Qt 界面中。
- 动态效果:提供流畅的动画效果,能够吸引用户的注意力。
使用说明
- 创建实例:
XQtLoading *loading = new XQtLoading(this);
- 配置参数:
-
- 设置旋转周期(毫秒):
loading->setRotationDuration(1500);
-
- 设置缩放周期(毫秒):
loading->setScaleDuration(800);
-
- 设置最大缩放比例:
loading->setMaxScale(1.8);
-
- 设置最小缩放比例:
loading->setMinScale(0.8);
-
- 设置最少花瓣数:
loading->setMinPetals(4);
-
- 设置最多花瓣数:
loading->setMaxPetals(12);
-
- 设置花瓣颜色:
loading->setColor("blue");
- 开始和停止动画:
-
- 开始动画:
loading->startAnimation();
-
- 停止动画并隐藏:
loading->stopAndHide();
注意事项
- 确保在使用 XQtLoading 之前包含正确的头文件:
#include "xqt_loading.hpp"
- 建议在需要时显示加载组件,不需要时隐藏或删除,以避免不必要的资源占用。
- 可以通过 QVBoxLayout 或其他布局管理器将 XQtLoading 添加到界面中。
示例代码
以下是一个简单的示例,展示如何在 Qt 应用程序中使用 XQtLoading 组件:
#include "xqt_loading.hpp"// 在构造函数中
XQtLoading *loading = new XQtLoading(this);
loading->setFixedSize(100, 100);
loading->setRotationDuration(1500);
loading->setScaleDuration(800);
loading->setMaxScale(1.8);
loading->setMinScale(0.8);
loading->setMinPetals(4);
loading->setMaxPetals(12);
loading->setColor("blue");
loading->startAnimation();
通过以上步骤,可以轻松地在您的 Qt 应用程序中集成和使用 XQtLoading 组件。