C#二次开发AutoCAD布局

### C# AutoCAD 二次开发中的布局操作

在C#中进行AutoCAD的二次开发涉及到多个方面，其中布局管理是一个重要部分。通过使用Autodesk.AutoCAD.DatabaseServices命名空间下的Layout类可以实现对布局的操作。

#### 获取当前文档的所有布局名称
为了获取所有可用的布局名称列表，可以通过遍历数据库中的布局集合来完成：

using Autodesk.AutoCAD.ApplicationServices;
using Autodesk.AutoCAD.DatabaseServices;

public static List<string> GetAllLayoutNames()
{
    Document doc = Application.DocumentManager.MdiActiveDocument;
    Database db = doc.Database;
    
    var layoutNames = new List<string>();
    
    using (Transaction tr = db.TransactionManager.StartTransaction())
    {
        LayoutManager lm = LayoutManager.Current;
        
        foreach (string name in lm.GetLayoutList())
        {
            layoutNames.Add(name);
        }
        
        tr.Commit();
    }

    return layoutNames;
}

此方法返回一个字符串类型的列表，包含了项目中存在的每一个布局的名字[^1]。

#### 创建新布局并设置视口
创建一个新的布局通常意味着要定义其尺寸以及添加至少一个视口(Viewport)，以便能够显示模型空间的内容:

public void CreateNewLayout(string newName, double width, double height)
{
    Document doc = Application.DocumentManager.MdiActiveDocument;
    Database db = doc.Database;
    
    using (Transaction tr = db.TransactionManager.StartTransaction())
    {
        BlockTableRecord btr = (BlockTableRecord)tr.GetObject(SymbolUtilityServices.GetBlockModelSpaceId(db), OpenMode.ForWrite);

        ObjectIdCollection vports = new ObjectIdCollection();

        Viewport vp = new Viewport();
        vp.SetDatabaseDefaults();
        vp.CenterPoint = new Point3d(width / 2, height / 2, 0);
        vp.Width = width;
        vp.Height = height;
        vp.ViewCenter = new Point2d(width / 2, height / 2);
        vp.ViewHeight = Math.Max(width, height); // 设置合适的视角高度
        
        btr.AppendEntity(vp);
        tr.AddNewlyCreatedDBObject(vp, true);
        vports.Add(vp.Id);

        LayoutManager lm = LayoutManager.Current;
        lm.CreateLayout(newName).SetCurrent(); // 新建布局并设为当前活动布局
        Layout lyt = lm.GetLayout(newName);
        lyt.TabOrder = lm.GetLastTabOrder() + 1; // 将新建布局标签放置到最后位置
        lyt.PlotSettings.ReplaceWith(btr.ObjectId, false); // 关联到模型空间绘图配置文件
        lyt.Viewports.RemoveAll(); // 清除默认视窗
        lyt.Viewports.Load(vports.ToArray()); // 加载自定义视窗数组
        
        tr.Commit();
    }
}

这段代码展示了如何在一个指定大小的新布局上建立单一全屏视口的过程。

#### 切换当前布局
有时可能需要程序化地改变用户的焦点所在的工作区（即切换不同的图纸页）。这同样可以通过调用`LayoutManager`的相关成员轻松达成：

public bool SwitchToLayoutByName(string targetLayoutName)
{
    try
    {
        Document doc = Application.DocumentManager.MdiActiveDocument;
        Database db = doc.Database;
        
        using (Transaction tr = db.TransactionManager.StartTransaction())
        {
            LayoutManager lm = LayoutManager.Current;
            
            if (!lm.LayoutExists(targetLayoutName))
                throw new Exception($"The specified layout '{targetLayoutName}' does not exist.");

            lm.SetCurrentLayout(targetLayoutName);
            tr.Commit();
        }

        return true;
    }
    catch (Exception ex)
    {
        System.Diagnostics.Debug.WriteLine(ex.Message);
        return false;
    }
}

上述函数尝试将应用程序内的激活窗口更改为由参数指明的目标布局名所代表的那个页面；如果失败，则会打印错误信息给调试器输出窗口。