在 MQL5 中创建交易管理面板（第九部分）：代码组织（三）：通信模块（基础篇）
◍ 通信模块怎么接进交易面板
MQL5 里做交易管理面板，到第九部分重点落在通信模块。它负责把面板上各控件的状态、用户点击指令，转成 EA 与主程序之间能互相读懂的消息，避免把 UI 逻辑和订单逻辑揉成一团。 实际工程里，通信模块通常封装成 CommunicationsDialog 类，独立于绘图与下单代码。这样后续改界面不影响发指令的逻辑，回测时也能单独验证消息是否正确传递。 原文给出的示例工程在 2025-11-27 发布，截至统计有 463 次查看、0 条评论，说明这类模块化写法还偏冷门，但代码结构清晰度明显优于把所有功能写进一个 mq5 文件。 外汇与贵金属品种波动大、滑点不可控，用模块化面板做半自动管理时，先在策略测试器跑通信逻辑再上真仓，风险更可控。
「从主面板到通信模块的实例链」
上一节把管理面板拆成了独立模块：主程序 New_Admin_Panel.mq5 只做初始化，真正界面由 AdminHomeDialog 类（定义在 AdminHomeDialog.mqh）掌管，它再通过按钮事件去 new 出 CommunicationsDialog.mqh 里的通信对话框。这条链是事件驱动的——点一下“发送消息”，AdminHomeDialog 才动态创建 CommunicationsDialog 实例并调 Telegram 接口，平时不占资源。 这种结构下每个文件角色单一：.mq5 管启动，AdminHomeDialog 管路由，CommunicationsDialog 管通信。后续要加 FutureDialog 只需在 AdminHomeDialog 里多挂一个按钮和创建分支，不用动主程序。 本次要增强的就是 CommunicationsDialog：它之前只是基础发送框，现在往里塞新功能。外汇与贵金属 EA 涉及自动通信时波动剧烈、断连风险高，模块隔离能降低单点故障扩散概率。
搭一个继承 CAppDialog 的通讯面板类
在 MT5 里写自定义面板，最稳的起手式是继承标准库的 CAppDialog。CommunicationsDialog 和另一个管理面板都从它派生，共享标题栏、边框等基础能力，这种层级让同一套控件逻辑能直接搬进别的项目。 新建 CommunicationsDialog.mqh 后，先用 #ifndef COMMUNICATIONS_DIALOG_MQH 加 #define 做头文件保护，避免重复包含报错。接着把 Dialog.mqh、Button.mqh、Edit.mqh、Label.mqh、ListView.mqh 以及自写的 Telegram.mqh 一并 include，前几个是标准库控件，最后一个负责把消息推到 Telegram。 面板尺寸用宏写死在布局段：COMMS_PANEL_WIDTH 300 像素、COMMS_PANEL_HEIGHT 350 像素，内部边距和垂直间距另用 COMMS_MARGIN_* 与 COMMS_GAP_VERTICAL 控制。颜色全走十六进制，比如 0x808080 深灰给边框，CLR_PANEL_BG 定主背景，控件各自有 CLR_INPUT_BG、CLR_SEND_BG 等独立常量，后续调样式只改 define 即可。 类声明里 private 区放 m_inputBox、m_sendButton、m_clearButton、m_quickMsgLabel、m_quickMessageList，以及 m_chatId、m_botToken 两个字符串；构造函数拿 chatId 和 botToken 入参，并把 8 条快捷短语填进 m_quickMessages 数组。public 区的 Create 方法先调 CAppDialog::Create 拉出基本框体，失败就返 false，随后 Caption("Communications Panel") 设标题，用 ObjectSetInteger 按常量上色，再逐个调辅助函数摆控件，最后把第一条快捷消息预填进输入框并 ChartRedraw()。 事件侧靠 OnEvent 分发：命中发送或清除按钮名就转 OnClickSend / OnClickClear；列表 ON_CHANGE 时按 lparam 下标把对应快捷消息写回输入框。OnClickSend 从输入框取文本，空则提示，非空就调 SendMessageToTelegram 发走，外汇或贵金属自动化场景接这类推送时须留意接口鉴权失效与经纪商环境断连的高风险。Toggle 仅用 IsVisible 判断后 Hide/Show，相当于面板的电灯开关。
class=class="str">"cmt">//+------------------------------------------------------------------+ class=class="str">"cmt">//| CommunicationsDialog.mqh | class=class="str">"cmt">//| Copyright class="num">2000-class="num">2025, MetaQuotes Ltd. | class=class="str">"cmt">//| [MQL5官方文档] | class=class="str">"cmt">//+------------------------------------------------------------------+
◍ 通信面板的头文件与布局常量
在 MT5 里做 Telegram 推送面板，第一步是把界面骨架写进一个独立的 .mqh 头文件，用 #ifndef 守卫避免重复包含，并引入标准控件库与自写的 Telegram 接口。
面板尺寸直接以宏写死：宽 300 像素、高 350 像素，左边距和上边距各 10，控件垂直间隙 10，输入框高 30、按钮宽 80 高 30，列表视图 280×80。这些数字决定了你在图表上拖出面板时的实际占位，改一处宏就能整体重排。
配色全部用十六进制常量定义，例如对话框背景 0x808080 深灰、发送按钮 0x00FF00 亮绿、清除按钮 0xF08080 浅珊瑚。想让面板融入暗色图表，只需把 CLR_PANEL_BG 和 CLR_CLIENT_BG 调低亮度即可。
类 CCommunicationDialog 公开继承 CAppDialog，私有成员先声明了 CEdit m_inputBox 消息输入框与 CButton m_sendButton 发送按钮，后续再补列表和标签。开 MT5 新建 CommunicationsDialog.mqh 把下面代码贴入，就能在编译期确认控件骨架无误。
class="macro">#ifndef COMMUNICATIONS_DIALOG_MQH class="macro">#define COMMUNICATIONS_DIALOG_MQH class="macro">#include <Controls\Dialog.mqh> class="macro">#include <Controls\Button.mqh> class="macro">#include <Controls\Edit.mqh> class="macro">#include <Controls\Label.mqh> class="macro">#include <Controls\ListView.mqh> class="macro">#include "Telegram.mqh" class=class="str">"cmt">// **Layout Defines** class="macro">#define COMMS_PANEL_WIDTH class="num">300 class="macro">#define COMMS_PANEL_HEIGHT class="num">350 class="macro">#define COMMS_MARGIN_LEFT class="num">10 class="macro">#define COMMS_MARGIN_TOP class="num">10 class="macro">#define COMMS_MARGIN_RIGHT class="num">10 class="macro">#define COMMS_GAP_VERTICAL class="num">10 class="macro">#define COMMS_INPUT_HEIGHT class="num">30 class="macro">#define COMMS_BUTTON_WIDTH class="num">80 class="macro">#define COMMS_BUTTON_HEIGHT class="num">30 class="macro">#define COMMS_LISTVIEW_WIDTH class="num">280 class="macro">#define COMMS_LISTVIEW_HEIGHT class="num">80 class="macro">#define COMMS_LABEL_HEIGHT class="num">20 class=class="str">"cmt">// **Color Defines(Hexadecimal Values)** class="macro">#define CLR_PANEL_BG 0x808080 class=class="str">"cmt">// Dark Gray(Dialog background) class="macro">#define CLR_CLIENT_BG 0xD3D3D3 class=class="str">"cmt">// Light Gray(Client area background) class="macro">#define CLR_CAPTION_BG 0x404040 class=class="str">"cmt">// Darker Gray(Caption background) class="macro">#define CLR_CAPTION_TEXT 0xFFFFFF class=class="str">"cmt">// White(Caption text) class="macro">#define CLR_BORDER_BG 0xFFFFFF class=class="str">"cmt">// White(Border background) class="macro">#define CLR_BORDER 0xA9A9A9 class=class="str">"cmt">// Gray(Border class="type">color) class="macro">#define CLR_INPUT_BG 0xFFFFFF class=class="str">"cmt">// White(Input box background) class="macro">#define CLR_INPUT_TEXT 0x000000 class=class="str">"cmt">// Black(Input box text) class="macro">#define CLR_SEND_BG 0x00FF00 class=class="str">"cmt">// Lime Green(Send button background) class="macro">#define CLR_CLEAR_BG 0xF08080 class=class="str">"cmt">// Light Coral(Clear button background) class="macro">#define CLR_BUTTON_TEXT 0x000000 class=class="str">"cmt">// Black(Button text) class="macro">#define CLR_LABEL_TEXT 0xFFFFFF class=class="str">"cmt">// White(Label text) class="macro">#define CLR_LIST_BG 0xFFFFFF class=class="str">"cmt">// White(List view background) class="macro">#define CLR_LIST_TEXT 0x000000 class=class="str">"cmt">// Black(List view text) class=class="str">"cmt">//+------------------------------------------------------------------+ class=class="str">"cmt">//| Class CCommunicationDialog | class=class="str">"cmt">//| Purpose: A dialog for sending Telegram messages with controls | class=class="str">"cmt">//+------------------------------------------------------------------+ class CCommunicationDialog : class="kw">public CAppDialog { class="kw">private: CEdit m_inputBox; class=class="str">"cmt">// Field to edit/send message CButton m_sendButton; class=class="str">"cmt">// Send message button
「把对话面板类收进构造函数」
CCommunicationDialog 这个类把 MT5 图形控件和 Telegram 推送的桥接都包进去了。私有成员里能看到 CButton、CLabel、CListView 分别管清空键、快捷消息标签和列表，外加 chatId、botToken 两个字符串存通信凭证，m_quickMessages 是定长 8 的字符串数组。 构造函数只接 chatId 和 botToken 两个参数，初始化列表直接赋值，随后把 8 条预设短语写死进数组：从 "Updates"、"Close all" 到 "Invalid Signal"。实盘里你若想改快捷语，直接动下标 0~7 这 8 行就行，数组越界会编译报错，所以别顺手加到第 9 条。 这类面板在外汇与贵金属策略中属于高风险辅助工具——信号误发可能触发真实下单指令，建议在模拟盘先验证推送链路。开 MT5 把这段塞进 EA 的 include 里，编译过一遍就能确认控件声明没漏。
CButton m_clearButton; class=class="str">"cmt">// Clear edit box button CLabel m_quickMsgLabel; class=class="str">"cmt">// Label for "QuickMessages" CListView m_quickMessageList; class=class="str">"cmt">// ListView for quick messages class="type">class="kw">string m_chatId; class=class="str">"cmt">// Telegram chat ID class="type">class="kw">string m_botToken; class=class="str">"cmt">// Telegram bot token class="type">class="kw">string m_quickMessages[class="num">8]; class=class="str">"cmt">// Array of quick messages class="kw">public: CCommunicationDialog(const class="type">class="kw">string chatId, const class="type">class="kw">string botToken); ~CCommunicationDialog(); class="kw">virtual class="type">bool Create(const class="type">long chart, const class="type">class="kw">string name, const class="type">int subwin, const class="type">int x1, const class="type">int y1, const class="type">int x2, const class="type">int y2); class="kw">virtual class="type">bool OnEvent(const class="type">int id, const class="type">long &lparam, const class="type">class="kw">double &dparam, const class="type">class="kw">string &sparam); class="type">void Toggle(); class=class="str">"cmt">// Toggle dialog visibility class="kw">private: class=class="str">"cmt">//--- Create dependent controls class="type">bool CreateInputBox(class="type">void); class="type">bool CreateClearButton(class="type">void); class="type">bool CreateSendButton(class="type">void); class="type">bool CreateQuickMsgLabel(class="type">void); class="type">bool CreateQuickMessageList(class="type">void); class=class="str">"cmt">//--- Handlers of dependent controls events class="type">void OnClickSend(class="type">void); class=class="str">"cmt">// Handler for Send button class="type">void OnClickClear(class="type">void); class=class="str">"cmt">// Handler for Clear button }; class=class="str">"cmt">//+------------------------------------------------------------------+ class=class="str">"cmt">//| Constructor | class=class="str">"cmt">//+------------------------------------------------------------------+ CCommunicationDialog::CCommunicationDialog(const class="type">class="kw">string chatId, const class="type">class="kw">string botToken) : m_chatId(chatId), m_botToken(botToken) { class=class="str">"cmt">// Initialize quick messages m_quickMessages[class="num">0] = "Updates"; m_quickMessages[class="num">1] = "Close all"; m_quickMessages[class="num">2] = "In deep profits"; m_quickMessages[class="num">3] = "Hold position"; m_quickMessages[class="num">4] = "Swing Entry"; m_quickMessages[class="num">5] = "Scalp Entry"; m_quickMessages[class="num">6] = "Book profit"; m_quickMessages[class="num">7] = "Invalid Signal"; }