开发者文档

作者：康林 (kl222@126.com)

• 设计思想
  • 中国象棋库
  • 界面适配
    • 中国象棋 MFC 扩展动态库
    • 中国象棋 ActiveX 控件
    • 中国象棋 Qt 插件
• 编译
• 使用

设计思想

本项目建立一个 C++ 中国象棋组件。方便集成到应用程序中。 由于界面开发有着不同的开发框架，所以针对界面需要对不同框架进行适配。 而中国象棋算法与结构与界面相对独立，所以本项目把它单独做为一部分。 针对不同的界面开发框架，本项目提供相应的适配。

• 中国象棋库，代码位于 Src 下
  • 中国象棋基本规则
  • 棋局保存和复盘
• 界面适配
  • 中国象棋 MFC 扩展动态库，代码位于 UI/MFC 下
  • 中国象棋 ActiveX 控件，代码位于 UI/ActiveX 下
  • 中国象棋 Qt 插件，代码位于 UI/Qt 下

中国象棋库

代码位于源码树中的 Src 目录下。 它提供中国象棋的基本规则算法与结构。接口详见：ChineseChess.h

• 中国象棋流程控制
• 中国象棋基本规则
• 棋局保存和复盘

界面适配

中国象棋 MFC 扩展动态库

它实现了中国象棋 MFC 扩展动态库。只能由 MFC 程序使用。代码位于 UI/MFC 下，接口详见：ChineseChessView.h。 其使用方式与使用普通的 MFC 类一样。
注意:在使用时，必须在程序初始化时（一般在 main 函数开始时)，必须先调用 ChineseChessViewNewDynLinkLibrary() 初始化资源。

中国象棋 Qt 插件

它实现了中国象棋 Qt 插件，代码位于 UI/Qt 下。接口详见：FrmChineseChess.h。 其使用方式与使用普通Qt控件类一样。它还能在 Qt 设计器中使用。 使用：

• 在程序开始时调用一次 InitResource() 函数，初始化资源。
• 在程序结束时调用一次 CleanResource() 函数，释放资源;
• Qt 设计器中使用
  • 复制安装目录（bin、lib）下的所有动态库文件到 ${Qt_Install_Root}/plugins/designer 下。 就可以在 qt 设计器的控件窗口中看到此插件。然后就与使用普通Qt控件一样。

编译

使用

使用 cmake 项目管理工具（建议使用此方法）

• 使用 ChineseChess

  • 使用 find_package 查找你需要的库。例如,你需要从 ChineseChess 为一个新的界面框架实现中国象棋：

    find_package(ChineseChess)  #查找 ChineseChess 库
    if(ChineseChess_FOUND)
        target_link_libraries(${PROJECT_NAME} PUBLIC ChineseChessControl::ChineseChess)  # 应用链接 ChineseChess 库
    endif()

• 使用 ChineseChessView ，只能由 MFC 程序使用

  find_package(ChineseChessView)  #查找 ChineseChessView 库
  if(ChineseChessView_FOUND)
      target_link_libraries(${PROJECT_NAME} PUBLIC ChineseChessControl::ChineseChessView)  # 应用链接 ChineseChessView 库
  endif()

• 使用 ChineseChessActiveX ，只能由 WINDOWS 程序使用。参见：ActiveX

• 使用 ChineseChessQt

  find_package(ChineseChessQt)  #查找 ChineseChessQt 库
  if(ChineseChessQt_FOUND)
      target_link_libraries(${PROJECT_NAME} PUBLIC ChineseChessControl::ChineseChessQt)  # 应用链接 ChineseChessQt 库
  endif()

使用其它项目管理工具

请详见安装后的目录。然后使用相应项目管理工具特定的方式指定头文件目录与链接库。