AvalonDock：如何通过ILayoutUpdateStrategy实现文档并排添加？

嘿，我之前也踩过这个坑！你遇到的应用挂起问题，大概率是因为在布局更新流程里直接修改结构时触发了无限递归的布局事件——毕竟修改布局会再次触发UpdateLayout，循环往复就卡死了。咱们换个思路来实现“新文档自动并排”的需求：

别在UpdateLayout里折腾布局结构，改用BeforeInsert方法来处理——这个方法是在默认插入逻辑执行前被调用的，能完美避开递归触发的问题。

下面是一个完整的ILayoutUpdateStrategy实现，专门处理新文档横向并排的需求：

public class SideBySideLayoutStrategy : ILayoutUpdateStrategy
{
    public bool BeforeInsert(LayoutRoot layout, LayoutContainer container, LayoutElement element)
    {
        // 只处理LayoutDocument类型的元素插入
        if (element is not LayoutDocument newDoc) return false;

        // 找到布局的主容器（通常是LayoutPanel）
        var mainPanel = layout.Descendents().OfType<LayoutPanel>().FirstOrDefault();
        if (mainPanel == null) return false;

        // 检查是否已有存在的文档Pane
        var existingPane = mainPanel.Children.OfType<LayoutDocumentPane>().FirstOrDefault();
        if (existingPane == null)
        {
            // 没有现有Pane，直接创建新Pane添加
            var newPane = new LayoutDocumentPane();
            newPane.Children.Add(newDoc);
            mainPanel.Children.Add(newPane);
            return true; // 标记为已处理，跳过默认插入逻辑
        }

        // 已有Pane，创建横向并排的PaneGroup
        var newPane = new LayoutDocumentPane();
        newPane.Children.Add(newDoc);

        var paneGroup = new LayoutDocumentPaneGroup
        {
            Orientation = Orientation.Horizontal, // 设置横向并排
            Children = { existingPane, newPane }
        };

        // 用Group替换原来的单个Pane
        var paneIndex = mainPanel.Children.IndexOf(existingPane);
        mainPanel.Children.Remove(existingPane);
        mainPanel.Children.Insert(paneIndex, paneGroup);

        return true; // 标记为已处理
    }

    public void AfterInsert(LayoutRoot layout, LayoutContainer container, LayoutElement element)
    {
        // 这里不需要额外操作
    }

    public void UpdateLayout(LayoutRoot layout)
    {
        // 绝对不要在这里修改布局结构！否则很容易触发无限递归
    }
}

1. 为什么用BeforeInsert：这个方法是在默认插入逻辑之前执行的，我们在这里完全接管新文档的插入流程，就不会触发默认的“把文档塞进第一个Pane”的逻辑，也避免了后续的布局更新递归。
2. 替换而非嵌套：先移除现有Pane，再插入新的Group，确保布局结构的修改是一次性完成的，不会触发多次布局更新事件。
3. 扩展支持多文档：如果要支持第三个、第四个文档并排，可以在代码里判断当前容器是否已经是LayoutDocumentPaneGroup，如果是直接往Group里加新Pane就行，不用每次都新建Group。

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