WinForm不可见SplitContainer显示时布局重排问题解决方案

问题描述 #

• 还原包含SplitContainer控件的Windows窗体已保存布局时，需要同步还原SplitterDistance属性值
• 窗体可见状态下直接执行布局还原操作，会出现明显的布局跳动，视觉效果差
• 尝试先将splitContainer1.Visible设为false，完成所有布局配置后再恢复控件可见性，会触发新问题：隐藏状态下的SplitContainer不会执行尺寸计算逻辑，控件变为可见状态时会自动将SplitterDistance调整为非预期值
• 设置SplitterDistance前修改控件尺寸后，无论对父窗体还是SplitContainer本身调用PerformAutoScale()、PerformLayout()方法，都无法解决该问题

原有问题代码 #

splitContainer1.Visible = false;
FormSetMode(xxx); // 设置窗体布局
splitContainer1.ParentForm.PerformAutoScale();
splitContainer1.ParentForm.PerformLayout();
splitContainer1.SplitterDistance = SplitterPosition;
SetSplitter(fHorizontalDesigner);  // 设置拆分器方向，方向变更时自动适配SplitterDistance
splitContainer1.Visible = true;

问题根因 #

SplitContainer控件的SplitterDistance属性内部自带边界校验逻辑，该逻辑只有在控件处于可见状态、且完成自身实际尺寸计算时才会触发。当控件被设置为Visible = false时，不会参与布局管线的尺寸计算，此时给SplitterDistance赋值不会触发校验，等控件恢复可见时会重新根据当前尺寸、面板最小尺寸、拆分器宽度等参数自动修正SplitterDistance到合法范围，就会出现赋值不生效的问题。
而直接在可见状态下逐行执行布局修改，每一步修改都会触发控件重绘，就会出现明显的界面跳动。

最优解决方式 #

不需要通过隐藏控件的方式规避重绘，直接使用WinForm内置的布局暂停/恢复逻辑即可，实现步骤如下：

• 布局调整前，同时调用窗体和SplitContainer的SuspendLayout()方法，暂停所有子控件的逐次重绘逻辑，所有布局计算会在内存中完成
• 调整布局属性时注意顺序：先设置窗体布局、设置SplitContainer的Orientation方向属性，待控件尺寸完成适配后，再给SplitterDistance赋值
• 赋值SplitterDistance前手动做边界校验，确保值落在合法区间内，避免控件自动修正值：
  • 垂直拆分（左右布局）时，合法最小值为SplitterWidth + Panel1MinSize，合法最大值为SplitContainer.Width - SplitterWidth - Panel2MinSize
  • 水平拆分（上下布局）时，合法最小值为SplitterWidth + Panel1MinSize，合法最大值为SplitContainer.Height - SplitterWidth - Panel2MinSize
• 所有属性设置完成后，调用ResumeLayout()方法一次性完成所有布局渲染，不会出现中间过程的重绘跳动

修正后实现代码 #

// 暂停布局，禁止中间过程重绘
splitContainer1.ParentForm.SuspendLayout();
splitContainer1.SuspendLayout();

try
{
    FormSetMode(xxx); // 设置窗体整体布局
    SetSplitter(fHorizontalDesigner); // 先设置拆分器方向，等待尺寸适配
    
    // 手动校验SplitterDistance合法范围，避免被控件自动重置
    int targetDistance = SplitterPosition;
    if (splitContainer1.Orientation == Orientation.Vertical)
    {
        int minAllowed = splitContainer1.SplitterWidth + splitContainer1.Panel1MinSize;
        int maxAllowed = splitContainer1.Width - splitContainer1.SplitterWidth - splitContainer1.Panel2MinSize;
        targetDistance = Math.Max(minAllowed, Math.Min(targetDistance, maxAllowed));
    }
    else
    {
        int minAllowed = splitContainer1.SplitterWidth + splitContainer1.Panel1MinSize;
        int maxAllowed = splitContainer1.Height - splitContainer1.SplitterWidth - splitContainer1.Panel2MinSize;
        targetDistance = Math.Max(minAllowed, Math.Min(targetDistance, maxAllowed));
    }
    splitContainer1.SplitterDistance = targetDistance;
}
finally
{
    // 恢复布局，一次性完成所有渲染
    splitContainer1.ResumeLayout(false);
    splitContainer1.ParentForm.ResumeLayout(true);
}

该方案全程不需要修改控件的Visible属性，控件始终参与布局计算，不会出现SplitterDistance被自动重置的问题；同时所有调整完成后才会一次性渲染到界面，完全消除布局跳动。如果是高DPI场景，只需要在调用SuspendLayout前确认窗体的AutoScale参数和当前系统DPI匹配即可，不需要额外调用PerformAutoScale方法。

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