自定义QT控件（插件）流程

标题：自定义QT控件（插件）流程
作者：kagula
时间：2015-03-30
环境：
[1]VS2010SP1
[2]QT5.41，安装路径为“C:\Qt\5.4\msvc2010_opengl”
[3]Qt5 Addins 1.24(for Visual Studio Plugin)


关键词:
    QT Widget
内容概要：
    介绍开发QT插件(自定义QT Widget)DLL文件的流程。


正文
第一步：新建项目"kagulaQt541Plugin"项目
[Qt5 Projects]->[Qt5 Designer Plugin]，向导为我们新建了两个class。
class“KagulaQT541Plugin”，继承了QObject和QDesignerCustomWidgetInterface两个class。
只能有一个这样的类，这个类告诉QT Designer如何加载这个控件。
class“KagulaQT541”，继子 QWidget，是我们要编写的自定义Widget。


第二步：
参考资料[1]我们编写自己的第一个自定义Widget。
修改kagula541.h文件，添加下面的头文件
#include <QtDesigner/QDesignerExportWidget>
在这个头文件里，在“class”关键词后面"QDESIGNER_WIDGET_EXPORT"宏，这里你的项目才能导出这个class，
而QT App（调用者）才能通过这个宏调用“Plugin DLL”这个class的实现。


第三步：引用自定义插件
新建调用者项目，在调用者项目中，
[3-1]添加，头文件搜索路径。
[3-2]添加，库文件搜索路径，Debug对应Debug，Release对应Release。


第四步：部署与运行
    QT插件项目以Release方式编译，在“D:\workspace\KagulaQT541Plugin\Win32\Release”目录下生成“KagulaQT541Plugin.dll”
把这个文件复制到“C:\Qt\5.4\msvc2010_opengl\plugins\designer”目录，启动“QT designer”[帮助]->[关于插件]可以看到插件已经正常加载。
如果复制“Debug”版本插件DLL，QT designer装载你的插件DLL会失败！ 
    更方便的方法是，打开插件project
    右键单击项目名称，调出properties对话框（要在Release模式下面）
    [Configuration Properties]->[BuildEvents]->[Post Build Event]修改
    [Command Line]属性
echo on
copy  "$(SolutionDir)$(Platform)\$(Configuration)\$(ProjectName).dll"  "C:\Qt\5.4\msvc2010_opengl\plugins\designer"
echo off
    [Description]属性
Copy plugin dll to Qt5 plugin directory...


备注：
  [a]自定义Widget一般需要添加属性，如何使用属性参考资料[2]。
  [b]修改插件位置，参考资料[3]。
  [c]调用者要进入插件的断点，需要满足两个条件[c1]插件的project同调用者在同一个solution里[c2]插件源码路径同调用者源码路径在同一级solution路径下。
参考资料
[1]《Custom Widget Plugin Example》
http://doc.qt.io/qt-5/qtdesigner-customwidgetplugin-example.html
[2]《Integrating a Custom Widget into Qt Designer》
如何为自定义widget添加属性示例
http://www.ics.com/blog/integrating-custom-widget-qt-designer
[3]《Qt loads plugins of release version on a debug build - Mac only》
https://forum.qt.io/topic/1268/qt-loads-plugins-of-release-version-on-a-debug-build-mac-only