飞秋FeiQ(局域网聊天软件)插件开发指南

(2)增加抽屉栏面板
CShortCutDlg shortCutDlg; 在 Onload 函数中 IFQFolderBarPtr bar(CLSID_FQFolderBar); shortCutDlg.m_ptrRoot = m_ptrRoot; shortCutDlg.Create(IDD_DIALOG_SHORTCUT); int m_nAddBar = bar->AddBar(L" 程序快捷方式", (LONG)&shortCutDlg);
软件交流群：153376930
形式如 ||测试 Group||||测试 其中 || 和 可选。|| 表示分隔符。在名称前加 || 表示 在添加的菜单项上面添加分隔符. 在名称前后 || 表示在添加的菜单项下面添加分隔符. 是上下级菜单的关系。例子 中测试菜单的父菜单是测试 Group。当测试 Group 不存在时，程序会自动创建这组菜单*/
(3)交互控制
以上已经实现了插件在 FeiQ 添加菜单的功能，用户在点击菜单的时候，就可以在插件 中进行响应，具体操作的步骤: HRESULT COfficeChatModule::MenuOnInvoke(enum FQ_UI_TYPE Type, long Id, VARIANT Parameter ) { //点击自定义的菜单后，会触发此事件 if(Id == m_AddMenuID) { //这里写你要实现的代码 } } 设置菜单项的状态： HRESULT COfficeChatModule::XMenuSink::raw_OnQueryState(enum FQ_UI_TYPE Type, long Id, VARIANT Parameter, BSTR * bstrText, enum FQ_UI_ITEM_STATE * State ) {
在程序退出时，删除加载的函数: HRESULT COfficeChatModule::OnUnload() { IFQUICommand* pUICmd = dynamic_cast<IFQUICommand* >(&m_xMenuSink); if(m_ptrMenu) { m_ptrMenu->DelItem(FQ_UI_TYPE_TRAY_MENU, m_AddMenuID, pUICmd); } return S_OK; }
软件交流群：153376930
飞秋 FeiQ( 局域网聊天软件)插件开发指南
作者：卢本陶
lubentao@ 版权所有 侵权必究
1、开发前准备
请确保有飞秋 FeiQ.exe 程序，并且确定版本是在 V2.5a 版本以上。只有 V2.5a 版本及 以上版本才支持插件。 如您还没有飞秋 FeiQ.exe 程序，可以去以下地址下载最新版本： /viewthread.php?tid=43&extra=page%3D1 开发环境为:Visual C++6.0
软件交流群：153376930
//如果上面的代码写成： IFQDataPtr pFQData = m_ptrModuleSite->GetData(key, VARIANT_FALSE); //表示得到接收到的数据，但并没有把数据包从队列中删除. ，这样就会提示一 消息框，当用户点击了消息框上的按钮时，就会触发 OnViewData 消息。 } return S_OK; } HRESULT COthelloGameModule::OnViewData(LPCTSTR key, LPCTSTR Result) { //当在 OnDataReceived 中，没有将 Key 中的数据包从队列中删除的话，将弹出一 个提示框，用户点击提示框的按钮时，将触发 OnViewData 事件 CString strKey = key; IFQDataPtr pFQData = m_ptrModuleSite->GetData(key, VARIANT_TRUE); if(strKey == FQDK_MODULE_KEY_ASKCOMEGAME) { //是否同意对方的邀请 CString strResult = Result; _bstr_t bstrRecvIP = pFQData->GetString(FQDK_SENDER);// 这 个值 是系 统发 送时自动加上的 if(strResult == "接受") { } } return S_OK; }
第二步：设置插件的信息。
软件交流群：153376930
完成点 Finish 完成之后，可以自动生成如下函数:
软件交流群：153376930
这些自动生成的代码， 已经定义了 FeiQ 的接口函数， 一个插件的基本框架已经搭建成功， 用户只需要在这些接口函数里添加自己的功能。 创建完成一个插件工程之后，就需要考虑在 FeiQ 程序界面能体现出该插件，如菜单、 面 板；具体怎么操作可以查看示例中的几个插件源代码。
软件交流群：153376930
METHOD_PROLOGUE(COfficeChatModule, MenuSink) if(Id == pThis->m_AddMenuID1) { //这里设置菜单的属性，如选中，不可用，更改菜单名称 } }
(4)数据的发送和接收
数据的发送： IFQDataPtr pFQSendData(CLSID_FQData); pFQSendData->SetString(FQDK_KEY, FQDK_MODULE_KEY_CHAT); pFQSendData->SetString(FQDK_MODULE_KEY_CONTENT, (LPCTSTR)m_strChat); m_ptrModuleSite->SendData((LPCTSTR)strPlayBuddyIp, pFQSendData); 注意每次发送数据时，必须要设置 FQDK_KEY 的值。 数据发送结果的查看： 数据发送完成后，将解发 OnSendDataResult 的消息。 HRESULT COthelloGameModule::OnSendDataResult(LPCTSTR Sender, LPCTSTR key, enum FQ_SENDDATA_RESULT nResult) { I f(strKey == FQDK_MODULE_KEY_ASKPLGUIN) { //如果是询问是否有插件 if(nResult == FQ_MODULE_SEND_DATA_RESULT_OK) { //发送成功 } } return S_OK; } 数据的接收： 数据到达时，数据会触发 OnDataReceived 消息 HRESULT COthelloGameModule::OnDataReceived(LPCTSTR key) { //当接收到数据包的时候，激发此事件 CString strKey = key; if(strKey == FQDK_MODULE_KEY_ASKPLGUIN) { IFQDataPtr pFQData = m_ptrModuleSite->GetData(key, VARIANT_TRUE); //得到接收到的数据，并将此数据包从队列中删除.
保存：
IFQDataPtr cfgPtr;//得到配置信息 m_ptrRoot->get_mConfig(&cfgPtr); cfgPtr->SetLong(L"OFFICECHAT", g_bOfficeChat);//保存进配置 用户只要把值设置成 cfgPtr 配置信息中，主程序退出时，会自动保存此数据。
更好飞秋插件开发文档及技巧可去飞秋论坛查看： /forumdisplay.php?fid=263 作者： 卢本陶
3、界面上的体现
(1)增加菜单
在 OnLoad(IDispatch* FQModuleSite)函数中增加菜单，这函数在程序启动时自动加载。 IFQModuleSitePtr m_ptrModuleSite; IFQRootPtr m_ptrRoot; int m_AddMenuID; HRESULT COfficeChatModule::OnLoad(IDispatch* FQModuleSite) { m_ptrModuleSite = FQModuleSite; m_ptrModuleSite->get_FQRoot(&m_ptrRoot); CComBSTR identeriferMenu("FeiQ.Menu"); m_ptrMenu = m_ptrRoot->Module[(_bstr_t)identeriferMenu]; IFQUICommand* pUICmd = dynamic_cast<IFQUICommand* >(&m_xMenuSink); m_AddMenuID = m_ptrMenu->AddItem(FQ_UI_TYPE_TRAY_MENU, " 退 出 (&C)", pUICmd, " 办公模式对话框||", 101); return S_OK; } /*菜单 Text 说明:
设置:
HRESULT COthelloGameModule::OnConfig() { //当用户点击插件管理及设置中的设置按钮时，会自动进入此函数 CSetDlg setDlg; setDlg.fontSend = g_fontSend; if(setDlg.DoModal() == IDOK) { g_fontSend = setDlg.fontSend; } return S_OK; }
软件交流群：153376930
g_bOfficeChat = FALSE; } long nSendMsgEnter = 0; if(cfgPtr->raw_GetLong(L"BGCHAT_SENDMODE", &nSendMsgEnter) == S_OK) { g_bSendMsgEnter = nSendMsgEnter; } }