什么是OnDockChanged事件处理程序？如何实现按钮自适应父容器尺寸？

1. OnDockChanged事件处理程序定义 #

DockChanged是.NET UI框架（WinForms/WPF通用）中针对容器控件的标准事件，会在控件的Dock停靠属性发生变更时触发。其事件处理程序的标准签名规则如下：

• 返回值为void
• 第一个参数为object类型，代表触发事件的控件实例，你场景中就是绑定事件的InnerPanel对象
• 第二个参数为EventArgs类型，存储事件相关数据，DockChanged事件无额外自定义数据，直接使用基础EventArgs类即可

2. 现有实现优化 #

你当前的事件绑定代码InnerPanel.DockChanged += HandleDockChanged;是符合规范的，原有处理逻辑可以做以下调整，更贴合需求：

• 移除高度判断逻辑，仅通过父容器宽度判断显示状态，和需求对齐
• 替换魔法数字为常量，方便后续统一维护
• 增加父容器空引用判断，避免运行时空指针异常
• 修复else分支高度赋值笔误（原逻辑误用ButtonWidth计算高度）
• 文本隐藏时增加Visible属性控制，避免禁用状态的文本仍占用布局空间
  优化后的代码如下：

// 提前定义常量，消除魔法数字
private const int IconOnlyWidth = 40; // 仅显示图标时的按钮宽度
private const int WithTextWidth = 80; // 显示文本+图标时的按钮宽度
private const int ButtonHeight = 36; // 按钮统一高度
private const int SwitchThresholdWidth = 80; // 触发显示状态切换的面板宽度阈值

private void HandleDockChanged(EventArgs args)
{
    // 规避父容器为空的异常场景
    if (Parent == null) return;

    if (Parent.Width < SwitchThresholdWidth)
    {
        // 面板宽度不足，仅显示图标
        TextLabel.Enabled = false;
        TextLabel.Visible = false;
        InnerPanel.Width = IconOnlyWidth;
        InnerPanel.Height = ButtonHeight;
        Padding = new Padding(1);
    }
    else
    {
        // 面板宽度充足，显示文本+图标
        TextLabel.Enabled = true;
        TextLabel.Visible = true;
        InnerPanel.Width = WithTextWidth;
        InnerPanel.Height = ButtonHeight;
    }
}

3. 补充注意点 #

如果需要父容器大小变动时也自动触发适配，建议同时将HandleDockChanged方法绑定到父容器的SizeChanged事件，避免仅停靠属性变更时才触发逻辑导致的适配不及时。

内容的提问来源于stack exchange，提问作者Sylas Coker