# qtcanpool

**Repository Path**: cradle08/qtcanpool

## Basic Information

- **Project Name**: qtcanpool
- **Description**: A fancy qt class library
- **Primary Language**: C++
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 173
- **Created**: 2022-11-02
- **Last Updated**: 2022-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


### 简介
本项目是根据 QtCreator 源码结构总结出的一套通用的项目管理模板。核心库为基于 QtWidgets 的 qcanpool，同时，集成常用组件和第三方类库。

qtcanpool 旨在提供给用户优秀的项目管理方式、多样的选择、优质的控件……

### 仓库
- [github](https://github.com/canpool/qtcanpool)
- [码云](https://gitee.com/icanpool/qtcanpool)

### 教程
- [使用教程](https://blog.csdn.net/canpool/category_10631139.html)
- [初学教程](https://blog.csdn.net/liang19890820/article/details/50277095)
- [学习之路](https://www.devbean.net/category/qt-study-road-2/)

### 目录
|一级目录|二级目录|说明|
|:------|:------|:------|
|demos||丰富的例子|
|doc||文档|
|projects||项目目录，其中提供简单的模板 template，用户可以持续添加自己的项目在此目录，<br>从而实现一套框架管理多项目
|src||源代码文件
||libs|基础类库，包含 qcanpool 等
||shared|共享的实用代码文件

### 环境
- Qt 5.15.2 MinGW/MSVC2019 64bit
- 其它环境未测试，推荐使用 [QT LTS](https://download.qt.io/official_releases/qt/) 版本

### 版本
- 格式：x.y.z
- 说明：主版本.次版本.补丁版本

### 分支
- [master](https://gitee.com/icanpool/qtcanpool/tree/master/)：V2 版本的主分支
- [v1_master](https://gitee.com/icanpool/qtcanpool/tree/v1_master/)：V1 版本的主分支

说明：
- v1_master 分支停止维护，只修复严重 bug

### 协议
* 遵循 [MulanPSL2](./LICENSE) 开源许可协议

### 规范
* [Google C++ Style Guide](http://google.github.io/styleguide/cppguide.html)
* [Qt 编程风格与规范](https://blog.csdn.net/qq_35488967/article/details/70055490)
* 源文件采用 UTF-8 编码

### 贡献
* 欢迎提交 issue 对关心的问题发起讨论
* 欢迎 Fork 仓库，pull request 贡献

### 交流
* QQ群：831617934

### 例子
1）<font size=4>fancydemo</font>
![qcanpool](./doc/pics/fancydemo.png)

2）<font size=4>fancytitlebar</font>
![fancytitlebar](./doc/pics/fancytitlebar.png)
支持 windows 原生特性（毛玻璃预览，半屏和¼屏等显示效果）

### 体验
下载源码，使用 qtcreator 打开 qtcanpool.pro，然后右击 fancydemo 并单击 Run 体验，如下所示：
![run](./doc/pics/run.png)

### 其它
1）ribbon 控件
- [QtitanRibbon](https://www.devmachines.com/qtitanribbon-overview.html)：一款商用的遵循 Microsoft Ribbon UI 的组件
- [SARibbon](https://gitee.com/czyt1988/SARibbon)：一款轻量级的 Ribbon 控件

2）docking 控件
- [Qt-Advanced-Docking-System](https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System)：一款比 Qt 自带的 QDockWidget 高级的 Docking 系统。已经应用到 qtcreator 中。

### 拓展
1、[fancycontrols](https://gitee.com/icanpool/fancycontrols)

精选的 Qt 控件，每个控件独占一个分支，分支名以 fancy 命名，如：[fancytitlebar](https://gitee.com/icanpool/fancycontrols/tree/fancytitlebar/)，[fancytoolbutton](https://gitee.com/icanpool/fancycontrols/tree/fancytoolbutton/)，[fancydock](https://gitee.com/icanpool/fancycontrols/tree/fancydock/)，[fancyribbon](https://gitee.com/icanpool/fancycontrols/tree/fancyribbon/) 等。

1）fancytoolbutton
![fancytoolbutton](./doc/pics/fancytoolbutton.png)