# Qt-CustomControl

**Repository Path**: tq520qyj/qt-custom-control

## Basic Information

- **Project Name**: Qt-CustomControl
- **Description**: qt 自定义控件集合
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 27
- **Created**: 2021-02-22
- **Last Updated**: 2025-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# quc是一套和qwt类似的自定义控件插件

## 目录说明
* demo目录为单个控件对应的完整的项目，可以独立使用，每个控件demo下都对应一个项目。
* designer目录为自定义控件的源码目录，可单独编译生成quc.dll作为插件。
* examples为集成到单个可执行文件使用的demo，一个可执行文件包含了所有自定义控件的使用例子。
* sdk目录为生成好的插件dll，可以对照Qt版本和编译器版本自行放到对应目录使用。
* snap目录为自定义控件的使用效果截图。

## 特点
1. 超过60个精美控件，涵盖了各种仪表盘、进度条、指南针、曲线图、标尺、温度计、导航条、导航栏，flatui、高亮按钮、滑动选择器、农历等。远超qwt集成的控件数量。
2. 每个类都可以独立成一个单独的控件，零耦合，每个控件一个头文件和一个实现文件，不依赖其他文件，方便单个控件以源码形式集成到项目中，较少代码量。qwt的控件类环环相扣，高度耦合，想要使用其中一个控件，必须包含所有的代码。
3. 全部纯Qt编写，QWidget+QPainter绘制，支持Qt4.6到Qt5.8的任何Qt版本，支持mingw、msvc、gcc等编译器，不乱码，可直接集成到Qt Creator中，和自带的控件一样使用，大部分效果只要设置几个属性即可，极为方便。
4. 每个控件都有一个对应的单独的包含该控件源码的DEMO，方便参考使用。同时还提供一个所有控件使用的集成的DEMO。
5. 每个控件的源代码都有详细中文注释，都按照统一设计规范编写，方便学习自定义控件的编写。
6. 每个控件默认配色和DEMO对应的配色都非常精美。
7. 超过60个可见控件，5个不可见控件。
8. 部分控件提供多种样式风格选择，多种指示器样式选择。
9. 所有控件自适应窗体拉伸变化。
10. 集成fontawesome图形字体，享受图形字体带来的乐趣。

## 设计规范
1. 所有命名均为首字母小写，例如setValue；
2. 私有变量及函数不建议使用下划线；
3. 设置用set开头，获取值用get开头；
4. 公共方法和公有槽都要注释，私有的变量和方法建议注释。
5. 方法及变量类似的含义的，可以靠在一起分组，不同分组间空一行。
6. 所有公共方法，函数体超过一行的在头文件中只声明，实现文件中写具体方法。
7. void类型的公共方法全部改为公共槽。

### 头文件依次排列顺序
#### 属性
* public:			构造函数及析构函数
* protected:		重写的方法，例如paintEvent等。
* private:		私有变量
* private slots:	私有槽函数
* public:			公共方法
* public slots:	公有槽函数
* signal:			信号

## 精美颜色：
* 天蓝色：	100, 184, 255   52, 152, 219  33, 183, 232   103, 202, 223
* 淡红色：	255, 107, 107   231, 76, 60   245, 102, 118  249, 126, 129
* 淡绿色：	24, 189, 155    26, 188, 156  1, 174, 103    131, 211, 182
* 褐黑色：	97, 117, 118    52, 73, 94
* 淡背景色：	211, 236, 255  199, 229, 255







补充

参考链接

https://gitee.com/feiyangqingyun/QUCSDK?_from=gitee_search