简介面向TEKLA二次开发入门者的C#源代码工程聚焦钢结构详图设计中图纸管理的常见痛点完整演示了载入模型图纸列表、选择图纸、打开模型图纸以及取图纸数值四个核心环节的实现思路帮助开发者快速建立从API调用到界面交互的完整认知尤其适合有编程基础、希望定制Tekla工作流的深化设计工程师和二次开发人员。压缩包共20个文件cs源码承担主要业务逻辑resx文件保存窗体界面资源配置sln与csproj负责工程构建整体仅74KB结构紧凑便于按模块阅读和移植复用。已有784人学习工程内可直接打开解决方案运行调试各环节代码划分清楚易于跟踪程序执行流程。代码示例中包含了从窗体加载、按钮响应到API查询与视图控制的完整逻辑读者可仿照这些模板快速搭建自己的工具。通过学习这份代码能够实际理解Tekla API在图纸目录读取、视图打开和尺寸数据提取上的调用方式同时掌握WinForms界面与模型数据绑定的常用写法为后续开发自动化出图、批量提取零件属性等工具打下扎实基础。1. TEKLA二次开发图纸方向就该从源代码里学TEKLA二次开发里图纸Drawing模块是最容易让人迷路的一块。模型对象遍历随便写写就能跑一进图纸这边连“当前正在编辑哪张图”都要靠 DrawingHandler 来定位刚上手就晕。这份图纸入门的源代码是一份可直接编译的 C# 工程把图纸遍历、视图层级、标记与尺寸修改这几个最常用的段落封装成了可复用类。适合已经会模型二次开发、但第一次碰 Tekla 图纸 API 的工程师也适合被出图阶段批量改图框、改标注、导清单逼疯的深化设计人员。它能解决的是出图环节最机械的活而且代码结构简单改改命名空间就能跑。2. 图纸对象模型从 Drawing、View 到 Mark 的层级与选型理由Tekla Structures 的模型 API 和图纸 API 是两套独立体系。模型侧用Tekla.Structures.Model操作零件、构件、焊缝图纸侧用Tekla.Structures.Drawings操作图纸、视图、标记、尺寸。两套体系通过Drawing.GetModelObject()互相咬合但对象生命周期、修改方式、提交时机完全不同。入门阶段最该建立的认知就是图纸对象绝不能按模型对象那套“拿对象-改属性-提交”的习惯来写否则后面每一步都在踩坑。2.1 图纸入口DrawingHandler 与 Drawing图纸侧唯一的全局入口是DrawingHandler。这个类挂在 Tekla Structures 进程内通过它拿当前激活图纸、遍历整个图纸集、访问打印和导出功能。它的地位相当于模型侧的Model几乎所有图纸操作都要先从它开始。using Tekla.Structures.Drawings; using Tekla.Structures.Model; Model model new Model(); if (!model.GetConnectionStatus()) { Console.WriteLine(未连接到 Tekla Structures); return; } DrawingHandler drawingHandler new DrawingHandler(); if (!drawingHandler.GetConnectionStatus()) { Console.WriteLine(获取 DrawingHandler 连接失败); return; } Drawing currentDrawing drawingHandler.GetDrawing(); if (currentDrawing null) { Console.WriteLine(当前没有打开的图纸); return; } Console.WriteLine($当前图纸: {currentDrawing.Name}类型: {currentDrawing.DrawingType});GetDrawing()返回的是当前在 Tekla 界面里激活的图纸对象对应你在图纸册里点开的那张图。GetConnectionStatus()必须检查它判断外部程序是否真的挂到了 Tekla 进程上。很多人第一次跑通模型代码结果在图纸这边什么都不返回十有八九是漏了 drawingHandler 这一层连接检查。currentDrawing.DrawingType会返回图纸类型枚举不同枚举对应不同的图纸用途后续处理逻辑差异很大。图纸类型枚举实际用途GetModelObject() 常见返回GADrawing布置图 / 总图任意模型对象WDDrawing构件图Assembly 构件对象WSDrawing零件图Part 零件对象CUDrawing浇筑体图CastUnit 浇筑体对象2.2 视图层级为什么先学会遍历 View 再碰标记图纸对象本身不直接挂标记和尺寸。一张图纸内部按视图拆分主视图、剖面图、详图各自拥有独立的坐标系、比例尺、可见对象集合。想改某一根零件的标注先要定位到它在哪个视图里想批量改字体也得先遍历视图再取标记。这个层级关系是图纸开发最核心的框架理解了它后面所有功能都是在这个骨架上填肉。ViewEnumerator views currentDrawing.GetViews(); while (views.MoveNext()) { View view views.Current; if (view null) continue; Console.WriteLine($视图: {view.Name}); Console.WriteLine($比例: {view.Scale}); Console.WriteLine($类型: {view.ViewType}); }GetViews()返回当前图纸内所有视图的枚举器包括主视图、剖面、详图。View.Scale是视图出图比例View.ViewType区分视图类型。这里有个常见误区新手容易直接去Drawing对象上找标记集合但 Tekla 的设计里标记挂在视图的对象集合中。绕开视图直接操作图纸对象大概率什么都拿不到。我一般会在源码包里放一个ViewTraverser类专门封装视图遍历逻辑所有标记和尺寸处理都从它开始。2.3 源码包里的类划分从哪读起这份入门源码包不是一堆零散脚本而是按功能切好的几个类。拿到手先不要急着编译把类结构和调用关系看一遍比直接跑起来更重要。类名职责对应章节DrawingHelperDrawingHandler 连接、图纸集遍历3.2ViewTraverser视图遍历、视图类型过滤2.2MarkProcessor标记对象遍历与属性修改4.1DimensionHelper尺寸读取与位置修正4.2DrawingAudit图纸信息导出与完整性校核6阅读顺序我建议按DrawingHelper → ViewTraverser → MarkProcessor → DimensionHelper走。前两个类解决“能不能拿到对象”的问题后两个解决“拿到之后怎么改”的问题。DrawingHelper和ViewTraverser是所有功能的地基这两个类里如果出现对象引用失效或者遍历漏项后面的标记处理和尺寸修正全都会跟着错。3. 第一个能跑的工程图纸遍历与属性批量修改图纸方向入门的第一个小目标不是写出复杂功能而是让外部程序连上 Tekla把图纸集完整遍历一遍并能修改一张激活图纸的常规属性。这段流程跑通了你才真正摸到图纸 API 的操作手感。3.1 搭建工程与程序集引用工程用 Visual Studio 创建目标框架选 .NET Framework 4.8 或 4.7.2具体取决于本机 Tekla 版本。程序集引用是这里最大的坑Tekla 的 API 程序集版本必须和运行的 Tekla 版本一致引用错了轻则编译不过重则运行时崩。我机器上现在是 Tekla Structures 2024 SP7下面的 HintPath 以你自己的实际安装路径为准。Reference IncludeTekla.Structures.dll HintPathC:\Program Files\Tekla Structures\2024\nt\bin\Tekla.Structures.dll/HintPath PrivateFalse/Private /Reference Reference IncludeTekla.Structures.Drawings.dll HintPathC:\Program Files\Tekla Structures\2024\nt\bin\Tekla.Structures.Drawings.dll/HintPath PrivateFalse/Private /Reference Reference IncludeTekla.Structures.Model.dll HintPathC:\Program Files\Tekla Structures\2024\nt\bin\Tekla.Structures.Model.dll/HintPath PrivateFalse/Private /Reference三个程序集缺一不可。Tekla.Structures.dll是基础类型和连接管理Model.dll提供模型对象访问Drawings.dll提供图纸对象访问。Private设为False表示不复制到输出目录运行时直接从 Tekla 安装目录加载避免本地拷了一份旧版 DLL 造成版本冲突。这里的HintPath要按你实际的安装根目录调整用 2023 就用 2023 的路径用 2024 就用 2024 的路径绝不能混。3.2 遍历当前模型下的所有图纸连接建立之后第一件事就是把图纸集完整扫一遍。这个动作能同时验证连接状态、图纸权限、对象枚举器用法三个基础能力。源码包里DrawingHelper的核心逻辑如下。using Tekla.Structures.Drawings; public class DrawingHelper { public static void ListAllDrawings() { DrawingHandler drawingHandler new DrawingHandler(); if (!drawingHandler.GetConnectionStatus()) { Console.WriteLine(DrawingHandler 连接失败); return; } DrawingEnumerator drawings drawingHandler.GetDrawings(); while (drawings.MoveNext()) { Drawing drawing drawings.Current; if (drawing null) continue; string drawingName drawing.Name; DrawingTypes.DrawingType drawingType drawing.DrawingType; Console.WriteLine($图纸: {drawingName}类型: {drawingType}); } } }GetDrawings()返回的是当前模型所有图纸的枚举器图纸册里有多少张这里就能遍历出多少张。MoveNext()每调用一次Current就指向下一张图纸。这里有个细节遍历过程中如果用户正在 Tekla 界面里编辑某张图这张图的某些属性可能处于锁定状态遍历只读属性没问题但不要在遍历过程中直接修改图纸对象。DrawingTypes.DrawingType是枚举类型可以直接打印或者用来判断图纸类别作为后续分支处理的依据。3.3 批量修改图纸属性图框、图纸尺寸与比例遍历只是热身实际工作中最常用的是批量修改图纸属性。比如一套模型出了两百张构件图深化阶段要统一加图框、调图纸尺寸这时手工一张张改不现实用代码一次跑完才是正确姿势。这里有一个关键 API 行为图纸属性修改必须走“读取属性对象 → 修改属性字段 → 应用回图纸”三步直接拿drawing对象点属性赋值是无效的。Drawing drawing drawingHandler.GetDrawing(); if (drawing null) { Console.WriteLine(当前没有激活的图纸); return; } DrawingAttributes drawingAttributes drawing.GetAttributes(); // 属性名在不同 Tekla 版本中略有差异 // 以 2024 SP7 为例图纸尺寸用 XSize / YSize单位毫米 drawingAttributes.XSize 420; drawingAttributes.YSize 297; drawingAttributes.FrameType 2; // 图框类型示例具体枚举值以版本为准 drawing.ApplyAttributes(drawingAttributes);GetAttributes()返回一个独立的属性对象修改这个对象不会直接作用到图纸上必须最后调用ApplyAttributes()将属性推回图纸。这个机制的好处是支持批量操作前先构造好一组属性统一应用坏处是新手经常漏掉最后一步改完一看图纸没变化以为代码出了问题。XSize和YSize控制图纸尺寸单位是毫米420×297 就是 A3 横向。FrameType是图框类型不同版本枚举值含义不同强烈建议先在一张测试图纸上跑一遍确认枚举值含义后再批量执行。4. 图纸自动化落地标记、尺寸与几何位置处理图纸属性只是外皮真正让图纸有内容的是视图里的标记和尺寸。标记包括零件标记、焊缝标记、表面处理标记尺寸包括线性尺寸、半径尺寸、角度尺寸。这一章解决的问题是把视图里的文字和标注变成可遍历、可修改、可重新定位的对象这也是图纸自动化的核心价值所在。4.1 在视图中遍历标记对象并修改字体标记对象在 Tekla 图纸 API 里统一挂在视图的ViewObjects集合下通过MarkBase基类暴露。实际项目中MarkBase的子类很多零件标记、螺栓标记、焊缝标记都继承自它。处理标记的第一步是遍历视图对象集合用类型判断筛出标记再按标记子类分别处理。View.ViewObjectsEnumerator viewObjects view.ViewObjects.GetViewObjects(); while (viewObjects.MoveNext()) { DrawingObject drawingObject viewObjects.Current; if (drawingObject null) continue; if (drawingObject is MarkBase mark) { MarkAttributes markAttributes mark.GetAttributes(); // 字体索引和文字高度按实际版本调整 markAttributes.Font 0; markAttributes.TextHeight 2.5; mark.ApplyAttributes(markAttributes); } }GetViewObjects()把视图里的所有图纸对象全部拉出来包括标记、尺寸、符号、隐藏线。用is MarkBase做类型判断过滤掉其他对象只处理标记。GetAttributes()和ApplyAttributes()的套路与图纸属性一致先读后改再应用。Font是字体索引TextHeight是文字高度这两个属性的具体取值范围依赖 Tekla 当前使用的字体表建议先用少量图纸测试不要一上来全模型跑。焊缝合并在WeldMark类型下处理逻辑相同但属性字段名称略有区别。4.2 尺寸对象的读取与位置修正尺寸对象是图纸自动化里比较折腾的一块。Tekla 的尺寸体系里Dimensioning是尺寸标注的容器一个视图中可能有多组尺寸线每组尺寸线包含若干尺寸点。读尺寸值容易改尺寸位置比较麻烦因为 API 没有提供通用的“移动尺寸线”方法很多位移操作要做成“读取数值 → 删除原尺寸 → 在新位置重建尺寸线”。if (drawingObject is Dimensioning dimensioning) { DimensioningAttributes dimAttributes dimensioning.GetAttributes(); // 示例读取小数位数设置属性名按版本微调 int decimalMark dimAttributes.DecimalMark; Console.WriteLine($尺寸组小数位: {decimalMark}); }读取尺寸组属性只是第一步真正高频的需求是自动调整尺寸线位置。常见做法是记录尺寸线的起点终点坐标在模型中算出目标位置然后重建尺寸线。这里我一般会分两种情况处理只改样式和数值的用ApplyAttributes()要改几何位置的直接走“删除重建”路线。重建尺寸线的风险在于可能丢尺寸点关联做之前一定要备份原尺寸组的所有关联对象 ID。这块是图纸自动化里最容易翻车的地方放进自动化流程前一定要加充分的日志输出。4.3 把遍历逻辑抽象成通用方法图纸功能的代码写多了以后你会发现大部分逻辑都是在做同一件事遍历视图、遍历图纸对象、按类型过滤、执行操作。把这套流程抽象成通用方法能省掉大量重复代码。源码包里建议保留这样一个工具方法所有标记和尺寸处理都基于它实现。public static void ForEachView(Drawing drawing, ActionView action) { if (drawing null || action null) return; ViewEnumerator views drawing.GetViews(); while (views.MoveNext()) { View view views.Current; if (view null) continue; action(view); } }这个方法接收一个ActionView委托调用方只需要写清楚“拿到每个视图后要干什么”遍历过程全部由工具方法负责。配合 C# 的 Lambda 表达式可以非常简洁地组合出复杂操作。ForEachView(currentDrawing, view { View.ViewObjectsEnumerator objects view.ViewObjects.GetViewObjects(); while (objects.MoveNext()) { if (objects.Current is WeldMark weldMark) { // 批量处理焊缝标记 } } });这种抽象方式最大的好处是让代码的意图变得很清楚遍历是基础设施业务逻辑单独写。不同项目的图纸需求千差万别有的要改零件标记有的要处理焊缝标记有的要清理冗余尺寸但遍历骨架永远不会变。把骨架稳定下来后续所有业务功能都是往里填内容。5. 排查与避坑TEKLA 图纸二次开发高频问题记录图纸二次开发不像模型 API 那样资料多很多问题都是靠血泪经验试出来的。这一章把我实际踩过的坑和团队里别人踩过的坑整理成问题记录每条按现象、原因、解决三步写覆盖属性修改、对象遍历、数据缓存、版本兼容四个维度。5.1 改了属性图纸没变化属性对象应用时机现象用GetAttributes()拿到属性对象修改了TextHeight或FrameType调用ApplyAttributes()后图纸没有任何变化控制台也没有报错。原因多数情况下是漏掉了属性应用环节。Tekla 图纸 API 中属性对象是独立的修改它不会实时同步到图形对象。还有一部分情况是改错了对象级别比如要改视图属性却拿的是图纸属性要改标记却只改了视图属性。解决先确认操作级别图纸属性用Drawing.GetAttributes()视图属性用View.GetAttributes()标记属性用Mark.GetAttributes()。改完以后必须调用对应的ApplyAttributes()。建议每次批量修改前先用单张图纸跑通流程再扩大到全部图纸。5.2 遍历漏掉视图剖面图和详图没被处理现象遍历视图得到的主视图数量正确但剖面图、详图数量明显少于图纸册中的显示数量导致部分标记和尺寸没有被处理。原因GetViews()返回的是所有视图但部分视图类型在遍历过程中被过滤掉或隐藏了。另一种常见原因是在遍历前对视图做了类型过滤只保留了MainView漏掉了SectionView和DetailView。解决遍历时先不过滤任何视图类型把所有视图打印出来确认数量再决定是否按类型处理。如果只想处理特定类型的视图用view.ViewType做判断但不要跳过未知类型。图纸册中的视图数量可能包含嵌套视图排查时把视图树完整打出来。5.3 二次运行对象引用失效缓存了 Drawing 对象现象第一次运行自动化脚本成功第二次运行时同样的代码在GetAttributes()处抛空引用异常或者拿到的对象状态不正确。原因Tekla 图纸对象不是持久句柄。每次外部程序重新连接 Tekla之前的对象引用就会失效。尤其写宏或插件时缓存了Drawing、View对象Tekla 重新打开模型后就找不到了。解决不要跨会话缓存图纸对象。每次运行重新走一遍DrawingHandler.GetDrawings()和GetViews()。如果必须缓存状态就缓存图纸名、零件编号、ID 这些稳定的标识下次运行时重新获取对象再恢复上下文。我一般会在源码包里做一个重试机制对象获取不到时自动重新连接并重新查找。5.4 打开图纸就崩程序集版本与 Tekla 版本不一致现象插件编译通过一打开图纸界面就闪退或者DrawingHandler.GetConnectionStatus()返回False日志里能查到类型加载异常。原因编译时引用的 Tekla API 程序集版本与运行环境不一致。Tekla 每年版本的 API 会有调整用 2023 编译的程序集跑在 2024 SP7 上局部可能能用但图纸模块往往直接崩。解决编译机器和运行机器的 Tekla 版本保持一致程序集引用路径统一指向 Tekla 安装目录。避免在输出目录复制 DLL不要使用Copy Local True。如果多环境共存用配置文件记录 Tekla 安装路径运行时动态加载程序集。关于版本兼容Tekla 官方策略是向后兼容有限自己接手的插件务必先确认原始编译版本。6. 进阶技巧把图纸集导成校核清单用 CSV 快速验证完整性做图纸自动化多了以后你会发现最花时间的不是写功能代码而是验证执行结果。两百张图纸跑完处理脚本怎么快速知道哪些图纸被正确处理了、哪些零件缺了标记、哪些视图数量异常我的做法是写一个独立的预检脚本把图纸集的元数据导成 CSV再做对比检查。这个脚本我一直保留在源码包里每次跑完自动化处理都会执行一遍。using System.IO; using Tekla.Structures.Drawings; using Tekla.Structures.Model; DrawingHandler drawingHandler new DrawingHandler(); if (!drawingHandler.GetConnectionStatus()) return; string outputPath D:\drawing_audit.csv; using (StreamWriter writer new StreamWriter(outputPath, false, System.Text.Encoding.UTF8)) { writer.WriteLine(图纸名,图纸类型,视图数量,主零件编号); DrawingEnumerator drawings drawingHandler.GetDrawings(); while (drawings.MoveNext()) { Drawing drawing drawings.Current; if (drawing null) continue; int viewCount 0; ViewEnumerator views drawing.GetViews(); while (views.MoveNext()) { if (views.Current ! null) viewCount; } string partMark N/A; ModelObject modelObject drawing.GetModelObject(); if (modelObject is Part part) { partMark part.GetPartMark(); } writer.WriteLine(${drawing.Name},{drawing.DrawingType},{viewCount},{partMark}); } }这个 CSV 就是一张图纸健康检查表。图纸名和图纸类型能看出有没有重复出图视图数量和正常图纸差太多说明图纸内容可能丢失主零件编号是 N/A 的图大概率是空图或异常图。我通常会把上一次导出的 CSV 和本次导出的做 diff任何图纸被删除或新增都能立刻发现。这个预检脚本的思路来自一次大教训有一次我批量调整两百多张图纸的标记字体跑完以为全部成功结果抽查发现其中十几张构件图的零件标记被覆盖成了默认字体。从那以后我每次做图纸自动化都会强制先跑一遍 CSV 预检处理完再导一份 CSV 做对比确认视图数量和零件编号没有异常才收工。这套双检流程帮我省下来的返工时间远比写脚本花掉的时间多得多。希望帮到你。本文还有配套的精品资源点击获取