【AutoCad 2025】【C#】零基础教程（三）——获取选中的 Entity 插件 =》初识 Entity 派生类-开发者社区

文章目录

相关教程
- C#
- Python
相关文献
前言
✅ 示例：获取当前选择集（Selection Set）
🔍 关键点说明
🎯 进阶：添加选择过滤器（只选圆或线）
Entity 派生类

作者：小猪快跑

基础数学&计算数学，从事优化领域8年+，主要研究方向：MIP求解器、整数规划、随机规划、智能优化算法

笔者也是从零开始学习并使用 c# & Python 二次开发 AutoCad 2025。本系列教程会从最基础的项目构建开始，到最终完成复杂插件开发。

如有错误，欢迎指正。如有更好的算法，也欢迎交流！！！——@小猪快跑

前言

在 AutoCAD 的 .NET API（适用于AutoCAD 2025 + .NET 8或传统 .NET Framework）中，获取用户当前在图形窗口中选择的对象，是一个在编写插件中非常实用的一个操作，通常通过Editor类的GetSelection()方法实现。

下面是一个完整、可运行的 C# 示例，展示如何：

提示用户选择对象
获取选中的实体（Entity）
遍历并输出每个对象的类型或句柄

✅ 示例：获取当前选择集（Selection Set）

usingAutodesk.AutoCAD.ApplicationServices;usingAutodesk.AutoCAD.DatabaseServices;usingAutodesk.AutoCAD.EditorInput;usingAutodesk.AutoCAD.Runtime;usingAutodesk.AutoCAD.Geometry;[assembly:CommandClass(typeof(MyAutoCADPlugin.SelectionDemo))]namespaceMyAutoCADPlugin{publicclassSelectionDemo{[CommandMethod("GETSEL")]publicvoidGetSelectedObjects(){// 获取当前文档和编辑器Documentdoc=Application.DocumentManager.MdiActiveDocument;Databasedb=doc.Database;Editored=doc.Editor;// 提示用户选择对象PromptSelectionOptionsopts=newPromptSelectionOptions();opts.MessageForAdding="\n请选择要处理的对象: ";opts.AllowDuplicates=false;PromptSelectionResultres=ed.GetSelection(opts);// 检查用户是否选择了对象if(res.Status!=PromptStatus.OK){ed.WriteMessage("\n未选择任何对象。");return;}SelectionSetss=res.Value;ed.WriteMessage($"\n共选择了{ss.Count}个对象。");// 在事务中打开对象以读取数据（推荐方式）using(Transactiontr=db.TransactionManager.StartTransaction()){foreach(ObjectIdidinss.GetObjectIds()){// 以只读方式打开实体Entityent=tr.GetObject(id,OpenMode.ForRead)asEntity;if(ent!=null){// 输出对象类型和句柄ed.WriteMessage($"\n类型:{ent.GetType().Name}, 句柄:{id.Handle}");// 示例：如果是圆，输出圆心if(entisCirclecircle){ed.WriteMessage($" | 圆心: ({circle.Center.X:F2},{circle.Center.Y:F2})");}}}tr.Commit();// 虽然只读，但良好习惯}}}}

🔍 关键点说明

功能	说明
`Editor.GetSelection()`	弹出选择提示，返回`PromptSelectionResult`
`PromptSelectionOptions`	可定制选择行为（如过滤、窗口选择、消息等）
`SelectionSet.GetObjectIds()`	获取所有被选中对象的`ObjectId`数组
`Transaction`	必须使用事务来安全地访问数据库对象（即使只读）
`OpenMode.ForRead`	以只读方式打开，避免锁定或修改

🎯 进阶：添加选择过滤器（只选圆或线）

// 仅选择 Line 和 CircleTypedValue[]filterList={newTypedValue((int)DxfCode.Start,"LINE"),newTypedValue((int)DxfCode.Start,"CIRCLE")};SelectionFilterfilter=newSelectionFilter(filterList);PromptSelectionResultres=ed.GetSelection(opts,filter);

⚠️ 注意：DXF 组码"LINE"对应Line实体，"CIRCLE"对应Circle。

Entity 派生类

AutoCAD 中的Entity类作为所有图形对象的基础类，有许多直接或间接派生自它的子类。以下是一些常见的Entity派生类，以表格形式展示：

Entity 派生类	描述
Arc	表示圆弧图形对象
Circle	表示圆形图形对象
DBText	表示单行文本
MText	表示多行文本
Ellipse	表示椭圆图形对象
Hatch	表示填充图案（阴影线或渐变色）
Image	表示插入到图纸中的图像
Leader	表示指引线
Line	表示直线图形对象
Polyline	表示多段线图形对象
LWPolyline	表示轻量级多段线，与Polyline类似但更高效
Point	表示点对象
PolygonMesh	表示多边形网格
PolyFaceMesh	表示多面体网格
Region	表示二维区域对象
Solid	表示实体填充图形对象
Spline	表示样条曲线
Underlay	表示底图（如DWF、DGN或PDF格式的底图）
Wipeout	表示擦除对象，用于遮挡其他图形对象
BlockReference	表示块引用，用于重复使用一组对象
AttributeDefinition	表示属性定义，通常与块关联
Attribute	表示块属性的实际值