# QtPluginTool

**Repository Path**: AOneHabit/qt-plugin-tool

## Basic Information

- **Project Name**: QtPluginTool
- **Description**: QtPluginTool 是一个基于 Qt 的插件工具集，提供多种实用 UI 组件和功能模块，适用于快速开发具有复杂交互界面的应用程序。
- **Primary Language**: C++
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-06-28
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QtPluginTool

QtPluginTool 是一个基于 Qt 的插件工具集，提供多种实用 UI 组件和功能模块，适用于快速开发具有复杂交互界面的应用程序。

## 软件架构

本项目采用模块化设计，主要包含以下模块：

- **UI 插件模块**：提供可复用的 UI 组件，如 `HourGlassWidget`（沙漏控件）、`StatusLightWidget`（状态灯控件）等。
- **视图模块**：包含自定义的 `QListView` 适配器 `CustomListModel` 和 `CustomListItemDelegate`，支持灵活的数据展示。
- **样式模块**：通过 `QSSLoader` 实现动态加载和管理 QSS 样式表，支持主题切换和样式热更新。
- **线程模块**：封装了 `WorkThread` 类，用于执行后台任务，避免主线程阻塞。
- **主程序模块**：`main.cpp` 和 `UiPluginWidget` 构成主界面，集成所有插件组件并提供演示功能。

## 安装教程

1. 克隆项目到本地：
   ```bash
   git clone https://gitee.com/hanshuang741852/qt-plugin-tool.git
   ```

2. 使用 Qt Creator 打开项目文件 `UiPlugin/UiPluginDemo.pro`。

3. 构建并运行项目。

## 使用说明

- **HourGlassWidget**：沙漏控件，可通过 `start()`、`stop()`、`reset()` 控制动画播放。
- **StatusLightWidget**：状态灯控件，支持设置颜色和大小。
- **CustomListModel**：自定义数据模型，支持动态添加、删除数据项。
- **QSSLoader**：全局样式管理器，通过 `LoadStyleSheet()` 加载样式文件，支持实时刷新。
- **WorkThread**：后台线程类，可在子类中重写 `run()` 方法执行耗时任务。

## 参与贡献

欢迎提交 Issue 和 Pull Request。请遵循以下流程：

1. Fork 项目并创建新分支。
2. 修改代码并提交。
3. 编写测试用例（如适用）。
4. 提交 Pull Request 并填写变更说明。

## 特技

- 支持 QSS 动态加载与热更新，提升界面调试效率。
- 提供可复用的 UI 组件，简化界面开发流程。
- 模块化设计，便于扩展和维护。

## 协议

本项目遵循 MIT License，请参阅 [LICENSE](LICENSE) 文件。

donate

![输入图片说明](donate/donate.jpg)