Version 0.2.0.1 Build 2015.01.23
天池开源软件库 for Qt5.x
##Tianchi 是为简化使用,把常用单位汇集在一起的简单类库。
###让 QtCreator / QtDesigner 能够在设计时使用 Tianchi 的可视化控件:
把 bin/designer/tianchi4qtc.dll 复制到:C:\Qt\Qt5.4.0\Tools\QtCreator\bin\plugins\designer
如果需要单独使用 QtDesigner: 请复制到:C:\Qt\Qt5.4.0\5.4\mingw491_32\plugins\designer
###Tianchi 库的使用方法
####1. 最简便的直接使用方式(直接包含源码编译):
在您的工程文件(xxx.pro)中直接包括 tianchi.pri, 例如:
include (.../tianchi/myProject.pri)
建议您复制一个 tianchi.pri 文件,打开并删除掉不需要的包含单元。
####2. 动态链接库方式
打开并编译 tianchi/tianchi.pro , 生成动态链接库
会生成动态链接库:bin/Qt5Tianchi.dll(.so)
以及生成编译连接库:bin/Qt5Tianchi.lib(.a)
在 Debug 模式下文件名会追加一个 d 字母。
使用时把编译连接库加到 .pro 中:
LIBS += -lQt5Tianchi
如果编译时找不到该连接库,请追加指定目录:
LIBS += -L.../tianchi/bin
Debug / Release 自动识别连接的方式是:
Debug: -lQt5Tianchid
Release: -lQt5Tianchi
####3. 静态链接库
打开工程文件并编译 tianchi/tianchi_lib.pro , 生成静态链接库
会生成静态链接库:bin/Qt5Tianchi.lib(.a)
编译时连接的设置方式参见第2点。
####4. 直接使用单组源代码文件
Tianchi 设计时尽量保持单组文件型式,所以只要把对应
的 .h/.cpp/.ui/.qrc 以及相关图片文件,直接复制或引
用到工程文件中即可使用.
部分使用第三方开源库的源码需要同时引入第三方库, 具
体请参见 tianchi/tianchi.pri 中的引入内容
bin/ 编译生成文件的目录
tianchi4qtc.dll Windows版天池的 QtCreator / QtDesigner 可视化插件
请复制到:C:\Qt\Qt5.4.0\Tools\QtCreator\bin\plugins\designer
help/
Doxyfile Doxygen 生成文档的配置文件
tianchi.chm 帮助文件
sample/ 演示程序目录
sample.pro 演示程序的工程文件,采用直接包含天池库方式
tianchi/
tianchi.pro 生成动态链接库
tianchi_lib.pro 生成静态链接库
tianchi.pri 包含所有模块的引入文件
Common/
tcCommon.h/.cpp 一些常用的公共单元。根据 Tianchi 的 common & utils 进行了合并整理
tcInvoke.h/.cpp 映射信号槽的执行对象
Component/ Qt IDE 的控件,由于Qt限制,必须为全小写文件名
QSint/ QSint 开源组件(部分), 参见:http://www.oschina.net/p/qsint
Tianchi/ Tianchi 组件
qcustomplot.h/.cpp QCustomPlot 图表控件,参见:http://www.qcustomplot.com/
tcDateEdit.h/.cpp 允许输入为空的日期选择插件(IDE控件)
tcColorWheel.h/.cpp 取色控件(IDE控件)
wwWidgets/ wwWidgets 开源组件(部分), 参见:http://www.wysota.eu.org/wwwidgets
Encrypt/
tcAES.h/.cpp AES 加密/解密(使用 Crypto++)
tcRSA.h/.cpp RSA 加密/解密(使用 Crypto++)
cryptopp/ Crypto++5.6.2 加密/解密开源库
Gui/
tcAutoCursor.h/.cpp 鼠标光标的设置和自动恢复处理
tcGuiCommon.h/.cpp 一些GUI相关的公共单元。
tcImageAdjust.h/.cpp 图片简单处理(柔化, 锐化, 灰度化, 黑白化, 底片化, 浮雕化)
IO/
tcExcel.h/.cpp 通过 OLE 方式操作 Microsoft Excel(仅限 Windows 下使用,要求已安装 Excel)
tcExcelReader.h/.cpp 通过 OLE 方式读取 Microsoft Excel, WPS(Linux 下仅支持WPS)
tcIO.h/.cpp 目录、文件等操作功能
tcLog.h/.cpp 简单的文本日志输出功能
Multimedia/
tcTextToSpeech.h/.cpp 文字转为语音进行播放,仅限 Windows 下使用
Network/
tcDownloader.h/.cpp 网络文件下载器,目前仅实现 http 文件下载
tcFtp.h/.cpp Ftp 操作
tcHttp.h/.cpp http/https 请求由异步转为同步,即堵塞等待。常用于登录时等待返回
tcUdp.h/.cpp Udp协议的接收服务器,以及发送和广播功能
OS/
tcAdminAuthorization.h 操作系统管理员权限的判断和提升权限执行程序
tcAdminAuthorization_mac.cpp 本机管理员提权,MacOS实现
tcAdminAuthorization_win.cpp 本机管理员提权,Windows实现
tcAdminAuthorization_x11.cpp 本机管理员提权,Linux/BSD实现
tcChinese.h/.cpp/.inc Windows 下汉字转拼音功能
tcOS.h/.cpp 操作系统相关功能
tcRunOnceChecker.h/.cpp 程序单实例判断,检查是否当前程序是第一次启动
tcSelfRestarter.h/.cpp 实现程序退出后自动重启
tcSystemInfo.h/.cpp 磁盘、内存等系统信息
tcSystemInfo_mac.cpp 磁盘、内存等系统信息,MacOS实现
tcSystemInfo_win.cpp 磁盘、内存等系统信息,Windows实现
tcSystemInfo_x11.cpp 磁盘、内存等系统信息,Linux/BSD实现
tcWindows.h/.cpp Microsoft Windows 系统功能,只能在Windows上使用
QRCode/ 二维码编码解码模块
tcQrencode.h/.cpp 二维码编码
qrencode/ 二维码编码的开源库
tcZxing.h/.cpp 二维码解码
zxing/ 二维码解码的开源库 (VC2010下无法编译,请自行去除)
Widgets/
tcPageTurnWidget.h/.cpp 翻页按钮组
tcScreenshot.h/.cpp/.ui 截屏功能
tcShadowDialog.h/.cpp/.ui/.qrc 含阴影和可缩放的无边对话框父类
images/ tcShadowDialog 使用到的图片
close.png
tcStyleToolDialog.h/.cpp/.ui 无边框窗口加阴影,缩放功能
tcViewHeaderSetupDialog.h/.cpp/.ui/.qrc QTreeWidget 列头设置对话框
images/ tcViewHeaderSetupDialog 使用到的图片
alignBottom.png
alignCenter.png
alignLeft.png
alignRight.png
alignTop.png
tcWidget.h/.cpp QWidget 相关扩展
tianchi4qtc/ Qt Designer 组件
tianchi4qtc.pro 组件工程文件。
注意: 必须以 Release 模式编译 !!!
Windows 下必须用 VC2010+ 下编译 !!!
XChinux / www.qtcn.org 坛主
cnhemiya / 南果梨
roywillow
younghz
渡世白玉
foxgod
Jonix