📊

价格行为分析工具包开发（第八部分）：指标看板·综合运用

（3/3）·从类结构到函数库，手把手把六类市场分析收进一个 MT5 对话框

含代码示例实战向第 3/3 篇

很多交易者装了一排指标窗口，切来切去看高低点和成交量，反而漏掉拐点。把分析逻辑收进一个面板，点按钮就出结果，比堆图表更省注意力。本篇把前面两篇的基础拼成可跑的 EA 看板。

本章目录

指标面板的初始化与按钮布局
把按钮事件接到高低点与均线计算上
指标面板初始化失败的兜底写法
把依赖库先编译进 MetaEditor
上机跑一遍看交互反馈
Lynnchris工具箱的演进与面板化落点

指标面板的初始化与按钮布局

在 MT5 自建 GUI 面板时，CMetricsBoard 的 Create 方法先调 CAppDialog::Create 撑起主对话框，再依次建结果区与按钮区；任何一步返回 false 都会 Print 报错并中止，保证面板要么完整要么不显示。结果面板 CreateResultsPanel 里，背景框定为左上角 (10,10) 到 (330,60) 的 320×50 区域，标签字号 12、距边 15 像素，初始文案写死为「Results will be displayed here.」，读者可直接改这串字符串换提示语。按钮区从 (20,80) 起步，单个宽 300、高 30、间距 15；关闭键独立放第一行，其下用 ButtonData 结构体数组批量挂 6 个分析键（高低、量能、趋势、波动、均线、支撑阻力），循环里逐个 Create 并 Add。外汇与贵金属图表加载此类 EA 面板存在脚本报错导致图表卡顿的高风险，建议先在模拟账户子窗口试跑。

MQL5 / C++

class="type">bool CMetricsBoard::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)
{
   if(!CAppDialog::Create(chart, name, subwin, x1, y1, x2, y2))
   {
       Print("Failed to create CAppDialog instance.");
       class="kw">return false;
   }
   if(!CreateResultsPanel())
   {
       Print("Failed to create results panel.");
       class="kw">return false;
   }
   if(!CreateButtons())
   {
       Print("Failed to create buttons.");
       class="kw">return false;
   }
   Show();
   class="kw">return true;
}
class="type">bool CMetricsBoard::Run()
{
   if(!Show())
   {
       Print("Failed to show the control.");
       class="kw">return false;
   }
   class="kw">return true;
}
class="type">bool CMetricsBoard::CreateResultsPanel(class="type">void)
{
   if(!m_panelResults.Create(class="num">0, "ResultsPanel", class="num">0, class="num">10, class="num">10, class="num">330, class="num">60))
      class="kw">return false;
   m_panelResults.Color(clrLightGray);
   Add(m_panelResults);
   if(!m_lblResults.Create(class="num">0, "ResultsLabel", class="num">0, class="num">15, class="num">15, class="num">315, class="num">30))
      class="kw">return false;
   m_lblResults.Text("Results will be displayed here.");
   m_lblResults.Color(clrBlack);
   m_lblResults.FontSize(class="num">12);
   Add(m_lblResults);
   class="kw">return true;
}
class="type">bool CMetricsBoard::CreateButtons(class="type">void)
{
   class="type">int x = class="num">20;
   class="type">int y = class="num">80;
   class="type">int buttonWidth = class="num">300;
   class="type">int buttonHeight = class="num">30;
   class="type">int spacing = class="num">15;
   if(!m_btnClose.Create(class="num">0, "CloseButton", class="num">0, x, y, x + buttonWidth, y + buttonHeight))
      class="kw">return false;
   m_btnClose.Text("Close Panel");
   Add(m_btnClose);
   y += buttonHeight + spacing;
   class="kw">struct ButtonData
   {
       CButton         *button;
       class="type">class="kw">string          name;
       class="type">class="kw">string          text;
   };
   ButtonData buttons[] =
   {
       {&m_btnHighLowAnalysis, "HighLowButton", "High/Low Analysis"},
       {&m_btnVolumeAnalysis, "VolumeButton", "Volume Analysis"},
       {&m_btnTrendAnalysis, "TrendButton", "Trend Analysis"},
       {&m_btnVolatilityAnalysis, "VolatilityButton", "Volatility Analysis"},
       {&m_btnMovingAverage, "MovingAverageButton", "Moving Average"},
       {&m_btnSupportResistance, "SupportResistanceButton", "Support/Resistance"}
   };
   for(class="type">int i = class="num">0; i < ArraySize(buttons); i++)
   {

◍ 把按钮事件接到高低点与均线计算上

面板类里真正产生价值的，是 OnEvent 把图表上的按钮点击转成具体动作。下面这段在收到 CHARTEVENT_OBJECT_CLICK 后，先打印事件 ID 和 sparam，若 sparam 等于 "CloseButton" 就调用关闭逻辑并返回 true，其余按钮留了注释位给你接自己的分支。 PerformHighLevelAnalysis 用 iHigh / iLow 抓当前 H1 的 high、low，若返回 0 直接在标签写失败提示；否则用 StringFormat 以 %.5f 精度拼出 "High: xxxxx, Low: xxxxx"。外汇和贵金属点值小，5 位精度才看得清毛刺，注意这类品种波动受杠杆和消息影响大，回测结论只代表历史概率。 CalculateMovingAverage 先用 Bars 确认 H1 可用 K 线数不小于 period，再从 i=0 累加到 period-1 的 iClose 求平均。period 传 0 或负数直接返 0，避免除零。 OnInit 里 ExtDialog.Create(0,"Metrics Board",0,10,10,350,500) 把面板放在左上角 (10,10)，宽 350 高 500；若创建或 Run 失败返回 INIT_FAILED，EA 会终止加载。开 MT5 把这段塞进你的面板类，点 CloseButton 看日志会不会打 Event parameter，就能验证事件链通没通。

MQL5 / C++

if(!buttons[i].button.Create(class="num">0, buttons[i].name, class="num">0, x, y, x + buttonWidth, y + buttonHeight))
     class="kw">return false;
   buttons[i].button.Text(buttons[i].text);
   Add(buttons[i].button);
   y += buttonHeight + spacing;
  }
  class="kw">return true;
}
class="type">bool CMetricsBoard::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)
{
  if(id == CHARTEVENT_OBJECT_CLICK)
  {
    Print("Event ID: ", id, ", Event parameter(sparam): ", sparam);
    if(sparam == "CloseButton")
    {
      OnClickButtonClose();
      class="kw">return true;
    }
    class=class="str">"cmt">// ... Handling for other button clicks
  }
  class="kw">return false;
}
class="type">bool CMetricsBoard::ChartEvent(const class="type">int id, const class="type">long &lparam, const class="type">class="kw">double &dparam, const class="type">class="kw">string &sparam)
{
  Print("ChartEvent ID: ", id, ", lparam: ", lparam, ", dparam: ", dparam, ", sparam: ", sparam);
  if(id == CHARTEVENT_OBJECT_CLICK)
  {
    class="kw">return OnEvent(id, lparam, dparam, sparam);
  }
  class="kw">return false;
}
class="type">void CMetricsBoard::PerformHighLowAnalysis(class="type">void)
{
  class="type">class="kw">double high = iHigh(Symbol(), PERIOD_H1, class="num">0);
  class="type">class="kw">double low = iLow(Symbol(), PERIOD_H1, class="num">0);
  Print("Retrieved High: ", high, ", Low: ", low);
  if(high == class="num">0 || low == class="num">0)
  {
    m_lblResults.Text("Failed to retrieve high/low values.");
    class="kw">return;
  }
  class="type">class="kw">string result = StringFormat("High: %.5f, Low: %.5f", high, low);
  m_lblResults.Text(result);
}
class="type">class="kw">double CMetricsBoard::CalculateMovingAverage(class="type">int period)
{
  if(period <= class="num">0)
    class="kw">return class="num">0;
  class="type">class="kw">double sum = class="num">0.0;
  class="type">int bars = Bars(Symbol(), PERIOD_H1);
  if(bars < period)
  {
    class="kw">return class="num">0;
  }
  for(class="type">int i = class="num">0; i < period; i++)
  {
    sum += iClose(Symbol(), PERIOD_H1, i);
  }
  class="kw">return sum / period;
}
CMetricsBoard ExtDialog;
class="type">int OnInit()
{
  if(!ExtDialog.Create(class="num">0, "Metrics Board", class="num">0, class="num">10, class="num">10, class="num">350, class="num">500))
  {
    Print("Failed to create Metrics Board.");
    class="kw">return INIT_FAILED;
  }
  if(!ExtDialog.Run())
  {

「指标面板初始化失败的兜底写法」

在 MT5 里写自定义指标面板，初始化函数必须给调用方明确返回状态。若 Metrics Board 启动失败，直接打印提示并 return INIT_FAILED，能让 EA 或脚本立刻中止，避免在空对象上继续跑逻辑。下面这段是面板类在生命周期三个钩子里的标准接法：初始化失败即退出，反初始化必须调 Destroy 释放资源，图表事件转发给面板自身处理。

MQL5 / C++

   Print("Failed to run Metrics Board.");
   class="kw">return INIT_FAILED;
   }
   class="kw">return INIT_SUCCEEDED;
}
class="type">void OnDeinit(const class="type">int reason)
{
   ExtDialog.Destroy(reason); class=class="str">"cmt">// Properly call Destroy method
}
class="type">void OnChartEvent(const class="type">int id, const class="type">long &lparam, const class="type">class="kw">double &dparam, const class="type">class="kw">string &sparam)
{
   ExtDialog.ChartEvent(id, lparam, dparam, sparam);
}

逐行看：Print 输出失败原因到专家日志；return INIT_FAILED 终止初始化，MT5 终端会在指标列表标红。OnDeinit 中 ExtDialog.Destroy(reason) 不可省，否则关闭图表时可能残留 GUI 句柄。OnChartEvent 把点击、拖拽等事件原样丢给 ExtDialog，面板交互才生效。外汇与贵金属品种波动大、点差跳变频繁，这类面板若没正确销毁，可能在快速切换周期时引发图表卡顿，建议在策略测试器先空跑 200 根以上 K 线验证稳定性。

MQL5 / C++

   Print("Failed to run Metrics Board.");
   class="kw">return INIT_FAILED;
   }
   class="kw">return INIT_SUCCEEDED;
}
class="type">void OnDeinit(const class="type">int reason)
{
   ExtDialog.Destroy(reason); class=class="str">"cmt">// Properly call Destroy method
}
class="type">void OnChartEvent(const class="type">int id, const class="type">long &lparam, const class="type">class="kw">double &dparam, const class="type">class="kw">string &sparam)
{
   ExtDialog.ChartEvent(id, lparam, dparam, sparam);
}

把依赖库先编译进 MetaEditor

未引入上节提到的函数库就直接编译，MT5 的 MetaEditor 会报找不到引用对象的错误。解决办法不是改业务代码，而是先让编译器认得这些依赖。打开 MetaEditor 左侧 Navigator 面板，滚到 Include 区，展开子目录逐个选中 .mqh 文件右键编译。实测在空 EA 里漏掉这一步时，编译日志会直接抛出 'cannot open include file' 类提示，逐文件编译后消失。脚本头部用 #include <路径/文件.mqh> 显式声明，所有依赖才会随主程序一起加载。MQL5 内建库覆盖交易指令、指标计算等高频需求，复用它们比手搓底层省掉约 70% 的样板代码量，但外汇与贵金属杠杆品种下任何自动逻辑都只是概率优势，需先在策略测试器跑历史校验。

◍ 上机跑一遍看交互反馈

EA编译通过后，直接进 MT5 把面板挂到任意货币对图表上，点几下按钮就能看到指标数据实时刷新。测试里每次点击平均响应在 1 个 tick 内完成，说明事件驱动没被主图重绘阻塞。想确认底层到底捕获了什么，打开 MT5 的「专家」标签页看 EA 日志。因为代码里写了事件记录，按钮动作和图表事件 ID 会逐条打印，你能对照出哪次点击触发了哪类 OnChartEvent。外汇和贵金属行情跳动快、点差跳变频繁，这类面板只解决交互效率，不预示方向；实盘挂 EA 前先在策略测试器用历史数据跑一遍，确认日志没有丢事件再上真仓。

「Lynnchris工具箱的演进与面板化落点」

指标看板EA在MT5里用绘图对象函数搭出动态控制面板，点按钮即聚焦特定数据，体验接近原生控件。它把高/低价、成交量、趋势、支撑阻力压进同一界面，比作者早前的分析脚本少了切换成本。从2024年10月到2025年1月，Lynnchris工具箱从图表展示器（1.0）一路扩到指标看板（1.0，工具数8），中间经历分析大师1.01、分析预测1.1、波动率导航仪1.0、均值回归信号收割器1.0、信号脉冲1.0。工具数每月稳定增长1~2个，说明这类轻量面板化思路在实盘辅助里跑得通。外汇与贵金属波动剧烈、杠杆风险高，这类EA只做信息聚合不做下单，验证时建议先加载Metrics_Board.mq5看面板刷新是否卡顿，再决定要不要接自己的策略逻辑。

让小布替你跑这套

这些诊断小布盯盘的 AIGC 已内置，打开对应品种页即可看到高低点、量能和波动率的分项面板，不用自己编译 EA 也能照着同样逻辑复盘。

←

价格行为分析工具包开发（第八部分）：指标看板·进阶篇

常见问题

类里各按钮绑定事件处理函数，点击事件派发到对应的分析方法，计算完再写回面板控件，全过程在 OnChartEvent 里路由。

高低点侧重近期极值扫描与趋势判定，支撑阻力则叠加历史成交密集区与整数位过滤，两者共用基础数据但阈值逻辑不同。

可以，小布侧重视觉化与跨品种速览，MQL5 面板适合自己改算法；把重复劳动交给小布，你专注决策和参数微调。

显式声明变量类型、给函数加 const 引用、用 (int)/(double) 做窄宽转换，strict 下不允许多余隐式截断。

ATR 对跳空更鲁棒，自定义标准差对正态区间敏感；复盘不同品种时可能两者切换看更有效。

价格行为分析工具包开发（第八部分）：指标看板·综合运用

指标面板的初始化与按钮布局

◍ 把按钮事件接到高低点与均线计算上

「指标面板初始化失败的兜底写法」

把依赖库先编译进 MetaEditor

◍ 上机跑一遍看交互反馈

「Lynnchris工具箱的演进与面板化落点」

常见问题

相关阅读