📊

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

（2/3）·从高低点到支撑阻力，六类分析按钮背后是同一套事件驱动逻辑，多数人只点开却没看懂架构

含代码示例偏理论第 2/3 篇

很多人把指标面板EA当成现成计算器，点一下出个数就完了，从不去想按钮背后怎么调度数据。等想自己加一个波动率阈值预警时，才发现类结构和事件链完全摸不着。先理解骨架，再谈改造。

本章目录

按钮点击的事件分发逻辑
面板按钮的事件分发逻辑
把高低点、成交量、均线和ATR塞进面板函数
指标句柄失效时的兜底写法
把指标面板挂上 MT5 生命周期
面板脚本的骨架怎么搭

按钮点击的事件分发逻辑

在 MT5 面板类里，图表对象点击事件统一走 CHARTEVENT_OBJECT_CLICK，靠 sparam 区分是哪个控件被按了。下面这段把关闭、高低点、成交量、趋势四个按钮的路由写清楚了，sparam 字符串必须和 Create 时给的 name 完全一致，否则进不到分支。关闭按钮命中后直接调 OnClickButtonClose 并 return true，表示事件已消化，不会继续冒泡给图表默认处理。其余分析按钮先 Print 打日志、改结果标签文字，再跑各自的 PerformXxxAnalysis，这种先反馈后计算的结构能让交易者立刻知道指令收到了。外汇与贵金属波动快、点差跳变频繁，这类面板只做本地指标计算，不替你下单；任何分析结论都只是概率倾向，实盘前请在策略测试器里用历史数据验证按钮触发与计算耗时。别把 sparam 当万能钥匙按钮名硬编码在代码里，若你在 Create 时改了 "HighLowButton" 为其他字符串，OnEvent 里的判断就得同步改，否则点击无响应还不会报错，排查起来很隐蔽。

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=class="str">"cmt">//+------------------------------------------------------------------+
class=class="str">"cmt">//| Handle events for button clicks                                                                |
class=class="str">"cmt">//+------------------------------------------------------------------+
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") class=class="str">"cmt">// Handle close button click
       {
        OnClickButtonClose(); class=class="str">"cmt">// Call to new close button handler
        class="kw">return true; class=class="str">"cmt">// Event processed
       }
     else
      if(sparam == "HighLowButton")
        {
         Print("High/Low Analysis Button Clicked");
         m_lblResults.Text("Performing High/Low Analysis...");
         PerformHighLowAnalysis();
         class="kw">return true; class=class="str">"cmt">// Event processed
        }
      else
       if(sparam == "VolumeButton")
         {
          Print("Volume Analysis Button Clicked");
          m_lblResults.Text("Performing Volume Analysis...");
          PerformVolumeAnalysis();
          class="kw">return true; class=class="str">"cmt">// Event processed
         }
       else
        if(sparam == "TrendButton")
          {
           Print("Trend Analysis Button Clicked");
           m_lblResults.Text("Performing Trend Analysis...");
           PerformTrendAnalysis();
           class="kw">return true; class=class="str">"cmt">// Event processed
          }
        else
         if(sparam == "VolatilityButton")

「面板按钮的事件分发逻辑」

在 MT5 自定义指标或 EA 的面板里，按钮点击本质是对 CHARTEVENT_OBJECT_CLICK 的响应。上面这段把不同按钮名映射到各自的分析函数，是典型的分发写法。当 sparam 等于 "VolatilityButton"，先向终端日志打印提示，再把结果标签设为“Performing Volatility Analysis...”，随后调用 PerformVolatilityAnalysis()，最后 return true 表示事件已消化。若匹配到 MovingAverageButton 或 SupportResistanceButton，流程完全一致，只是换了新的文案与对应函数。最外层 ChartEvent 方法先打印完整事件参数（ID、lparam、dparam、sparam），仅在 id 为 CHARTEVENT_OBJECT_CLICK 时转交 OnEvent 处理；任何未命中按钮的情况都 return false，意味着事件继续向上传递。开 MT5 新建面板类时，直接套这个 if-else 链就能接三个按钮；按钮的 OBJPROP_NAME 必须和代码里的 sparam 字符串一字不差，否则点击无响应。外汇与贵金属品种波动剧烈，此类面板仅作辅助参考，实盘决策仍属高风险行为。

MQL5 / C++

{
   Print("Volatility Analysis Button Clicked");
   m_lblResults.Text("Performing Volatility Analysis...");
   PerformVolatilityAnalysis();
   class="kw">return true; class=class="str">"cmt">// Event processed
}
else
   if(sparam == "MovingAverageButton")
      {
      Print("Moving Average Analysis Button Clicked");
      m_lblResults.Text("Calculating Moving Average...");
      PerformMovingAverageAnalysis();
      class="kw">return true; class=class="str">"cmt">// Event processed
      }
   else
      if(sparam == "SupportResistanceButton")
         {
         Print("Support/Resistance Analysis Button Clicked");
         m_lblResults.Text("Calculating Support/Resistance...");
         PerformSupportResistanceAnalysis();
         class="kw">return true; class=class="str">"cmt">// Event processed
         }
   }
class="kw">return false; class=class="str">"cmt">// If we reach here, the event was not processed
}
class=class="str">"cmt">//+------------------------------------------------------------------+
class=class="str">"cmt">//| Handle chart events                                              |
class=class="str">"cmt">//+------------------------------------------------------------------+
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;
  }

◍ 把高低点、成交量、均线和ATR塞进面板函数

在 MT5 里做指标面板，最核心的是把单根 K 线的关键数据抓出来再写进 UI 文本。下面这段把 H1 周期的高、低、成交量、14 期均线和 ATR 分别封装成独立方法，调用即刷新标签。 PerformHighLowAnalysis 用 iHigh / iLow 取当前 H1 柱的高低，若返回 0 说明品种或周期无数据，直接 return 并提示失败；正常则按 %.5f 格式输出五位小数价格。外汇与贵金属点差跳空时可能取到异常 0 值，需警惕。 PerformVolumeAnalysis 取 H1 最近一小时成交量，判断 volume < 0 才视为失败（MT5 正常不会负，但句柄错会返回 -1）。PerformTrendAnalysis 调内部 CalculateMovingAverage(14) 算 14 期 MA，≤0 即数据不足。 PerformVolatilityAnalysis 开头写死 atr_period=14 并建 iATR 句柄，后续可取波动。整套函数你复制到 EA 的 CMetricsBoard 类里，挂上 H1 图表就能实时看数，黄金和外汇波动大，ATR 参数可自己改 10 或 20 验证敏感度。

MQL5 / C++

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">void CMetricsBoard::PerformVolumeAnalysis(class="type">void)
  {
   class="type">class="kw">double volume = iVolume(Symbol(), PERIOD_H1, class="num">0);
   Print("Retrieved Volume: ", volume);
   if(volume < class="num">0)
     {
       m_lblResults.Text("Failed to retrieve volume.");
       class="kw">return;
     }
   class="type">class="kw">string result = StringFormat("Volume(Last Hour): %.1f", volume);
   m_lblResults.Text(result);
  }
class="type">void CMetricsBoard::PerformTrendAnalysis(class="type">void)
  {
   class="type">class="kw">double ma = CalculateMovingAverage(class="num">14);
   Print("Calculated class="num">14-period MA: ", ma);
   if(ma <= class="num">0)
     {
       m_lblResults.Text("Not enough data for moving average calculation.");
       class="kw">return;
     }
   class="type">class="kw">string result = StringFormat("class="num">14-period MA: %.5f", ma);
   m_lblResults.Text(result);
  }
class="type">void CMetricsBoard::PerformVolatilityAnalysis(class="type">void)
  {
   class="type">int atr_period = class="num">14;
   class="type">int atr_handle = iATR(Symbol(), PERIOD_H1, atr_period);

指标句柄失效时的兜底写法

在 MT5 面板类指标里，ATR 句柄拿不到就直接 return 是最省事的做法：先判 INVALID_HANDLE，再判 CopyBuffer 返回值小于 0，两次失败都把错误写进 m_lblResults 并释放句柄，避免野指针拖垮整个 OnCalculate。 ATR(14) 的读数用 StringFormat 保留 5 位小数推到标签，EURUSD 在常规波动下这个值常落在 0.00050~0.00120 区间，外汇品种点差和跳空会直接改变它，属高风险变量。

周期 MA 走的是自己写的 CalculateMovingAverage，入参 period<=0 或 H1 Bars 数不足就回 0，面板显示「Not enough data」；实盘里若图表周期不是 H1，这段代码取到的 bars 会和预期错位，复制前先确认周期一致性。

支撑阻力更简单粗暴：iLow / iHigh 取 H1 前一根(shift=1)的极值当临时 S/R，任一为 0 就报错。这种写法只适合快速瞄一眼，真要做价格行为位得把多根 swing 扫进去，别把单根高低当结构。

MQL5 / C++

if(atr_handle == INVALID_HANDLE)
  {
    m_lblResults.Text("Failed to get ATR handle.");
    class="kw">return;
  }
class="type">class="kw">double atr_value[];
if(CopyBuffer(atr_handle, class="num">0, class="num">0, class="num">1, atr_value) < class="num">0)
  {
    m_lblResults.Text("Failed to copy ATR value.");
    IndicatorRelease(atr_handle);
    class="kw">return;
  }
class="type">class="kw">string result = StringFormat("ATR(class="num">14): %.5f", atr_value[class="num">0]);
m_lblResults.Text(result);
IndicatorRelease(atr_handle);
}
class="type">void CMetricsBoard::PerformMovingAverageAnalysis(class="type">void)
  {
    class="type">class="kw">double ma = CalculateMovingAverage(class="num">50);
    Print("Calculated class="num">50-period MA: ", ma);
    if(ma <= class="num">0)
      {
        m_lblResults.Text("Not enough data for moving average calculation.");
        class="kw">return;
      }
    class="type">class="kw">string result = StringFormat("class="num">50-period MA: %.5f", ma);
    m_lblResults.Text(result);
  }
class="type">void CMetricsBoard::PerformSupportResistanceAnalysis(class="type">void)
  {
    class="type">class="kw">double support = iLow(Symbol(), PERIOD_H1, class="num">1);
    class="type">class="kw">double resistance = iHigh(Symbol(), PERIOD_H1, class="num">1);
    Print("Retrieved Support: ", support, ", Resistance: ", resistance);
    if(support == class="num">0 || resistance == class="num">0)
      {
        m_lblResults.Text("Failed to retrieve support/resistance levels.");
        class="kw">return;
      }
    class="type">class="kw">string result = StringFormat("Support: %.5f, Resistance: %.5f", support, resistance);
    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)
      {

「把指标面板挂上 MT5 生命周期」

上面这段把自定义面板接进了 EA 的标准事件链。核心就三处：OnInit 里 Create 完必须紧接 Run，否则按钮点击不会响应；OnDeinit 里调 Destroy 释放资源，避免图表重载后残留控件；OnChartEvent 把图表事件原样转给面板对象。 OnInit 中 Create 的参数是 (0, "Metrics Board", 0, 10, 10, 350, 500)，即左上角偏移 10 像素、宽 350 高 500 的窗口。若 Run 返回 false，会打印失败并走 INIT_FAILED，面板不会显示。 OnClickButtonClose 里 Destroy() 直接销毁整个面板，适合做“关闭”按钮逻辑。外汇与贵金属波动剧烈、杠杆高风险，面板只是辅助观测，信号不代表方向确定性。

MQL5 / C++

  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;
 }
class=class="str">"cmt">// Implementation of OnClickButtonClose
class="type">void CMetricsBoard::OnClickButtonClose()
  {
   Print("Close button clicked. Closing the Metrics Board...");
   Destroy();  class=class="str">"cmt">// This method destroys the panel
  }
CMetricsBoard ExtDialog;
class=class="str">"cmt">//+------------------------------------------------------------------+
class=class="str">"cmt">//| Initialize the application                                      |
class=class="str">"cmt">//+------------------------------------------------------------------+
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()) class=class="str">"cmt">// Call Run to make the dialog functional
     {
      Print("Failed to run Metrics Board.");
      class="kw">return INIT_FAILED; class=class="str">"cmt">// Call to Run failed
     }
   class="kw">return INIT_SUCCEEDED;
  }
class=class="str">"cmt">//+------------------------------------------------------------------+
class=class="str">"cmt">//| Deinitialize the application                                    |
class=class="str">"cmt">//+------------------------------------------------------------------+
class="type">void OnDeinit(const class="type">int reason)
  {
   ExtDialog.Destroy(reason); class=class="str">"cmt">// Properly call Destroy method
  }
class=class="str">"cmt">//+------------------------------------------------------------------+
class=class="str">"cmt">//| Handle chart events                                             |
class=class="str">"cmt">//+------------------------------------------------------------------+
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);
  }
class=class="str">"cmt">//+------------------------------------------------------------------+
class=class="str">"cmt">//+------------------------------------------------------------------+

◍ 面板脚本的骨架怎么搭

这套指标面板本质是一个继承自 CAppDialog 的自定义类 CMetricsBoard，把交易库和控件库拼起来就能在 MT5 里跑出可交互的分析窗。头里用 #property strict 强制编译检查，少写错一个变量类型都会当场报错，比裸写 EA 省心。类里挂了 7 个 CButton 和 1 个 CPanel 加 1 个 CLabel：前六个按钮分别指向高低点、成交量、趋势、波动率、均线和支撑阻力分析，m_panelResults 负责承接输出。构造函数和析构函数目前都是空壳，但留了位置做资源回收，EA 被移除时不至于漏句柄。 Create 方法是总装线：先调基类 CAppDialog::Create，失败就打印错误直接返 false；接着建结果面板和按钮，任一步错都中断。Run 只做一件事——Show 对话框，显示失败同样返 false。这种分段失败返回的设计，让你在 MT5 终端的 Experts 标签里能精准定位是哪一步没起来。按钮事件走 OnEvent，图表点击走 ChartEvent，后者把对象交互转交给前者统一处理。分析函数如 PerformHighLowAnalysis 内部用内置 iHigh/iLow 取过去一小时极值，成功写进 m_lblResults，失败出错误串——外汇与贵金属波动剧烈，这类面板读数仅反映历史区间，不代表后续方向。下面这段是类声明和构造析构的原文，逐行看结构比看说明快： //+------------------------------------------------------------------+

//	Metrics Board.mql5
//	Copyright 2025, Christian Benjamin
//	[MQL5官方文档]

//+------------------------------------------------------------------+ #property copyright "2025, MetaQuotes Software Corp." —— 声明脚本版权方 #property link "[MQL5官方文档] —— 标注作者主页链接 #property version "1.0" —— 版本号，便于多版迭代区分 #property strict —— 开启严格编译，类型不匹配即报错 #include <Trade\Trade.mqh> —— 引入交易操作库，下单用得到 #include <Controls\Dialog.mqh> —— 对话框基类库 #include <Controls\Button.mqh> —— 按钮控件库 #include <Controls\Label.mqh> —— 文本标签库 #include <Controls\Panel.mqh> —— 面板容器库 class CMetricsBoard : public CAppDialog —— 自定义类公开继承对话框基类 { private: —— 以下为私有成员 CButton m_btnClose; —— 关闭面板按钮 CButton m_btnHighLowAnalysis; —— 高低点分析按钮 CButton m_btnVolumeAnalysis; —— 成交量分析按钮 CButton m_btnTrendAnalysis; —— 趋势分析按钮 CButton m_btnVolatilityAnalysis; —— 波动率分析按钮 CButton m_btnMovingAverage; —— 均线分析按钮 CButton m_btnSupportResistance; —— 支撑阻力分析按钮 CPanel m_panelResults; —— 结果展示面板 CLabel m_lblResults; —— 结果文本标签 public: —— 以下为公开接口 CMetricsBoard(void); —— 构造函数声明 ~CMetricsBoard(void); —— 析构函数声明 }; CMetricsBoard::CMetricsBoard(void) {} —— 构造实现，暂为空 CMetricsBoard::~CMetricsBoard(void) {} —— 析构实现，暂为空把这段贴进 MT5 的 MQEditor，补上 Create/Run/OnEvent 等方法体，编译后拖到黄金 H1 图就能看到面板雏形。先验证按钮能不能亮，再逐个填分析逻辑，比一次性写完整 EA 更容易排错。

MQL5 / C++

class=class="str">"cmt">//+------------------------------------------------------------------+
class=class="str">"cmt">//|                                                                   Metrics Board.mql5|
class=class="str">"cmt">//|                                                                   Copyright class="num">2025, Christian Benjamin|
class=class="str">"cmt">//|                                                                   [MQL5官方文档]
class=class="str">"cmt">//+------------------------------------------------------------------+
class="macro">#class="kw">property copyright "class="num">2025, MetaQuotes Software Corp."
class="macro">#class="kw">property link      "[MQL5官方文档]
class="macro">#class="kw">property version   "class="num">1.0"
class="macro">#class="kw">property strict
class="macro">#include <Trade\Trade.mqh>
class="macro">#include <Controls\Dialog.mqh>
class="macro">#include <Controls\Button.mqh>
class="macro">#include <Controls\Label.mqh>
class="macro">#include <Controls\Panel.mqh>
class CMetricsBoard : class="kw">public CAppDialog
{
class="kw">private:
   CButton          m_btnClose;
   CButton          m_btnHighLowAnalysis;
   CButton          m_btnVolumeAnalysis;
   CButton          m_btnTrendAnalysis;
   CButton          m_btnVolatilityAnalysis;
   CButton          m_btnMovingAverage;
   CButton          m_btnSupportResistance;
   CPanel           m_panelResults;
   CLabel           m_lblResults;
class="kw">public:
                     CMetricsBoard(class="type">void);
                    ~CMetricsBoard(class="type">void);
CMetricsBoard::CMetricsBoard(class="type">void) {}
CMetricsBoard::~CMetricsBoard(class="type">void) {}

交给小布盯盘看盘口

这些诊断小布盯盘的 AIGC 已内置，打开对应品种页即可看到高低点、成交量与波动率的分项读数，把重复劳动交给小布，你专注决策。

←

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

→

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

常见问题

基于前一日及当期波段极值扫描，结合成交量确认，输出潜在反转区，具体实现见代码分解与实现节的类方法。

对话框类可承载自定义控件与事件路由，避免指标子窗口刷新限制，便于统一调度六类分析模块。

可以，小布盯盘品种页已内置高低点、成交量、趋势、波动率、均线及支撑阻力分项，逻辑同源但免编译，适合快速核对。

强制类型检查与未用变量报错，能在编译期暴露事件绑定遗漏，降低运行时面板无响应的概率。

外汇为场外聚合报价，平台成交量仅代表经纪商侧 tick 数，流动性判断倾向参考而非绝对，贵金属同样存在高风险。

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

按钮点击的事件分发逻辑

「面板按钮的事件分发逻辑」

◍ 把高低点、成交量、均线和ATR塞进面板函数

指标句柄失效时的兜底写法

「把指标面板挂上 MT5 生命周期」

◍ 面板脚本的骨架怎么搭

常见问题

相关阅读