XQtLoading 使用文档

简介

XQtLoading 是一个自定义的加载动画组件，旨在为用户提供可配置的旋转花瓣动画效果。它可以在应用程序中用于指示加载状态，提升用户体验。

特征

• 可配置性：用户可以根据需求调整旋转周期、缩放周期、最大/最小缩放比例、花瓣数量及颜色等参数。
• 易于集成：可以轻松地将 XQtLoading 组件添加到现有的 Qt 界面中。
• 动态效果：提供流畅的动画效果，能够吸引用户的注意力。

使用说明

1. 创建实例：

XQtLoading *loading = new XQtLoading(this);

1. 配置参数：

• • 设置旋转周期（毫秒）：

loading->setRotationDuration(1500);

• • 设置缩放周期（毫秒）：

loading->setScaleDuration(800);

• • 设置最大缩放比例：

loading->setMaxScale(1.8);

• • 设置最小缩放比例：

loading->setMinScale(0.8);

• • 设置最少花瓣数：

loading->setMinPetals(4);

• • 设置最多花瓣数：

loading->setMaxPetals(12);

• • 设置花瓣颜色：

loading->setColor("blue");

1. 开始和停止动画：

• • 开始动画：

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 组件。