在 GUI 控件中使用布局和容器: CBox 类（基础篇）
用 CBox 给 MT5 控件做布局容器
在 MT5 的 GUI 编程里，裸写坐标摆放按钮、标签很容易乱，尤其窗口尺寸一变就错位。CBox 类提供了一套容器思路：把控件塞进盒子，由盒子统一管理相对位置和边距，而不是每个控件都手写绝对坐标。 官方示例最早发布于 2015-11-13，截至统计时点页面浏览量约 3340、评论 17 条，说明这套老接口在自定义面板里仍有实用参考价值。 实际开 MT5 接一套自定义面板时，先继承或实例化 CBox，再把 CButton、CLabel 这类控件 Add 进去，调一下内边距参数就能看到布局自适应效果。外汇与贵金属图表上挂这类面板属于高风险环境下的辅助工具，布局逻辑错乱只会影响操作效率，不会直接触发交易。
◍ 组件化界面的章节脉络
这篇系列文章把 MT5 自定义控件拆成了可复用的类结构，先交代背景与目标，再下沉到布局与渲染的实现细节。 从原文的目录看，技术落点集中在第 3 节 CBox 类：间距计算、对齐规则、递归渲染这三项决定了控件能否在对话框里自适应排布。 后续第 5 节给了两个可直接跑的例程——简单点值计算和控件重构，读者开 MT5 建个空 EA 把例程贴进去就能验证布局逻辑是否生效。 外汇与贵金属图表上的自定义面板属于高风险环境下的辅助工具，逻辑错误不会直接导致爆仓，但可能误导下单参考。
「用布局容器替代 MT5 控件绝对定位」
在 MT5 里写 EA 或指标面板时，很多人习惯在对话框里给每个按钮、标签写死坐标做绝对定位。控件一多，拖一个就要改一片，遇到分辨率切换或 DPI 缩放，界面直接错位。 本文走另一条路：用布局管理器接管控件的排布逻辑。核心是一个叫 CBox 的类，把它当容器，子控件按水平或垂直方向自动流式排布，不用手算 x/y。 这套思路不是凭空来的。Java 的 BoxLayout、Python Tkinter 的几何管理器包都是同构方案，CBox 在 MQL5 里大致对等它们，只是作用在 MT5 的 GUI 对象上。 想验证可行性，开 MT5 新建一个空 EA，把 CBox 头文件挂上，往里塞两个按钮看是否自动横排——比手写坐标快得多，且贵金属/外汇策略面板改起来风险更低，不会因为界面崩了误触下单。
为什么像素硬定位迟早反噬
在 MT5 自带的 SimplePanel 与控件例程里，所有控件都按像素绝对定位：每个控件在客户区占一个固定坐标，且依赖前一个控件加偏移量来摆位。这种方式直观，但在实盘面板越做越复杂时，弊端会直接暴露。 有经验的 GUI 程序员都清楚像素硬定位的坑：改一个部件的尺寸或坐标，相邻控件大概率被挤歪；界面上挪动一个按钮，常常要回溯改一大段创建代码，基本不可复用；复杂面板手调坐标极其耗时，一个 12 控件面板可能耗掉数小时对齐。 所以我们转向布局系统，目标很具体：代码能跨面板复用；改局部界面尽量不波及其它部件；控件位置由系统自动推算而非手填像素。本文用 CBox 容器类给出一套实现路径，你开 MT5 新建空 EA 把容器接进去就能对比两种写法的维护成本。
◍ 用 CBox 搭可自动排布的控件容器
CBox 本质是个容器类，把按钮、标签等控件丢进去后，它能按分配空间自动算坐标，不用你手写每个控件的 x/y。典型用法里，外层盒子是容器总尺寸，虚线框是衬垫（padding）边界，蓝色区域是衬垫占用，剩下白区才是控件可落位空间。 构建时推荐从 CWndClient 扩展（不带滚动条），这样白赚背景和边框功能；若直接从 CWndContainer 继承会丢这些，而从 CWndObj 硬写又得自己挂 CArrayObj 存子对象并重写增删逻辑，性价比低。 布局只分两种：水平（默认）和垂直，居中时控件间距均匀铺满。伪代码推导的间隔公式依赖「控件总数」作除数，无边界居中时用 (总数-1) 作除数。对齐除了居中，水平还支持靠左/靠右/无边居中，垂直支持靠顶/靠底/无边居中，CBox 会按枚举设置反算 x、y 间隔。 创建控件不必再填 x2/y2 算宽高，交给 CBox 后调用 Pack() 即可重定位，它内部再调 Render() 做真实绘制。Render() 先算可用空间存进 m_total_x / m_total_y，再排间隔，最后搬控件。 控件尺寸超了容器可用空间（宽或高大于容器减去双层衬垫）会被自动压缩到最大可用值；但若所有控件尺寸总和超了，容器不会自扩，得手工改 CDialog 或单控件。嵌套容器时，Pack() 要递归跑，靠重写 CObject::Type() 返回自定义宏值来识别布局类实例，再对子容器连锁渲染。 CBox 用 m_min_size（CSize）记容器内控件统一叠放基准，名字反直觉——实际存的是最大控件尺寸，因为类会假定这是下限来倒推空间。Shift() 走绝对定位思路，但坐标引用由渲染方法托管，开发者只需设好每个控件实际大小。
class="macro">#include <Controls\WndClient.mqh> class=class="str">"cmt">//+------------------------------------------------------------------+ class=class="str">"cmt">//| | class=class="str">"cmt">//+------------------------------------------------------------------+ class CBox : class="kw">public CWndClient { class="kw">public: CBox(); ~CBox(); class="kw">virtual class="type">bool Create(class="kw">const class="type">long chart,class="kw">const class="type">class="kw">string name,class="kw">const class="type">int subwin, class="kw">const class="type">int x1,class="kw">const class="type">int y1,class="kw">const class="type">int x2,class="kw">const class="type">int y2); }; class=class="str">"cmt">//+------------------------------------------------------------------+ class=class="str">"cmt">//| | class=class="str">"cmt">//+------------------------------------------------------------------+ CBox::CBox() { } class=class="str">"cmt">//+------------------------------------------------------------------+ class=class="str">"cmt">//| | class=class="str">"cmt">//+------------------------------------------------------------------+ CBox::~CBox() { } class=class="str">"cmt">//+------------------------------------------------------------------+