简介面向Tekla二次开发入门者的C#源码示例包聚焦图纸管理环节。内容围绕载入模型图纸列表、选择模型图纸、打开模型图纸、取图纸数值四个典型功能展示如何通过Tekla API读取图纸信息、绑定界面并提取几何与属性数据适合具备基础编程知识、希望实现钢结构详图自动化定制的工程师。包内共20个文件以6个C#源文件为主搭配解决方案与项目文件、界面资源、应用配置及VS辅助文件整体仅74KB轻量便于快速查阅。其中窗体相关源码完整呈现了用户交互逻辑方便对照学习。已有781人学习下载对于缺少官方示例的Tekla二次开发领域这套可直接运行的源码提供了直观的入门路径。通过研读代码可以了解API调用方式、界面事件处理及数据查询思路并在此基础上扩展出符合自身工作流的图纸管理工具。 干过钢结构详图深化的人都有这种体验模型建得再快图纸出来的那天才是噩梦的开始。几百张图纸要一张张打开、改标记、调尺寸、校核编号TEKLA 自带的批量操作就那么几个很多重复劳动还是得靠手动。更抓狂的是你在模型里写脚本改杆件属性很顺手一碰到图纸模块就感觉走进了另一个世界——对象模型完全不一样能找到的资料也少得可怜。这篇文章就把 TEKLA 二次开发里的图纸模块从头讲清楚从环境配置、对象模型到可以直接改来用的源代码让有 C# 基础、正在被出图流程折磨的工程师少走两个月弯路。1. 图纸二次开发到底解决什么问题从手动出图到批量出图的拐点1.1 深化设计真正的痛点在改图钢结构详图深化的工作流里模型建完只是前奏图纸才是最终交付物。一个中等规模的厂房项目构件图加布置图轻轻松松几百张到了高层钢结构上千张也不奇怪。模型一旦发生设计变更所有受影响的图纸都得重新走一遍检查流程。这个时候你会发现真正耗时间的不是画图而是改图——把旧标记里的内容换掉、把丢失的尺寸补上、把视图比例统一、把零件编号重新校核。这些动作高度重复、规则明确但又不够标准TEKLA 原生的批处理覆盖不住。以最常见的统一加前缀为例业主要求某一批构件标记统一加上PF-原生功能里你只能一张图一张图打开在标记属性里手工改。图纸数量一多人就会疲劳一疲劳就会漏改。这类需求就是二次开发最典型的切入点逻辑简单、重复量大、出错代价高。1.2 宏录制为什么帮不上忙见过不少工程师学 TEKLA 二次开发的第一反应是录宏我也试过。模型模块里录制一些操作确实能生成可用的脚本片段但图纸模块经常不是这么回事。你对图纸里的标记做修改宏录制器要么什么都没录下来要么只录下一个打开图纸激活视图这类界面动作。原因不复杂图纸对象的修改大量依赖视图上下文和选择集鼠标点选的对象不一定能映射成稳定的对象引用录制器拿不到可靠的句柄自然生成不了可执行代码。所以图纸自动化只能直接面向 API 写不要寄希望于录完后改改就能用。1.3 图纸自动化的三个工作层次按侵入程度我把图纸二次开发分成三个层次。第一层是不动图形界面的批处理程序直接连上图纸数据库遍历所有图纸统计数量、名称、类型或者导出图纸清单。很多项目周报里的图纸统计就是这么做出来的。第二层是进入视图改内容打开图纸、遍历视图里的标记和尺寸、修改后保存。这篇文章的核心示例就停在这一层。第三层是嵌入出图流程监听模型变更自动判断哪些图纸需要重建或更新甚至可以自动出图。第三层需要把模型事件和图纸事件串起来工程复杂度高适合做成产品级工具不建议作为入门第一站。再多说一句成本账。很多团队在要不要投入二次开发之间反复摇摆担心开发两天不如手动半天。这个账要分项目算一次性项目手动确实划算但如果是长期维护的图纸模板或者项目周期里变更频繁一次开发长期复用收益非常明显。我的判断标准很简单同一类手动操作预计要重复超过 20 次就值得写成一次代码。2. 环境搭建与第一个工程版本、SDK 和调试链路2.1 没有单独的 SDK程序集就在安装目录里Tekla Structures 的 SDK 不像其他软件那样单独发布安装包装好 Tekla 之后开发所需的 dll 就在安装目录里这也是很多人没意识到原来这个也能开发的原因。默认路径类似C:\Program Files\Tekla Structures\版本号\nt\bin\图纸开发最核心的引用有三个Tekla.Structures.dll基础类型和连接入口Tekla.Structures.Drawing.dll图纸对象模型Tekla.Structures.Model.dll模型对象模型某些场景需要从这里反查零件信息如果只做图纸模块处理可以不引用 Model.dll 和 Catalogs.dll。少引用一个程序集版本兼容麻烦就少一分。2.2 开发语言和入口方式开发语言上不要犹豫直接选 C# 和 .NET Framework。Tekla API 这块基于 .NET Framework 4.6.x 开发虽然也能在更新版本的运行时里跑但图纸相关功能在非 Framework 环境下踩坑概率高。版本上建议用 Visual Studio 2019/2022 .NET Framework 4.6.2。程序入口有三种方式一宏目录中的 .cs 宏。把写好的 C# 源码文件放到宏目录Tekla 启动时自动编译在宏对话框运行。最适合写一次性批处理工具。方式二编译为 dll 的插件/组件。放到应用程序和组件目录通过 Tekla 的应用和组件面板加载带界面、带属性适合产品化。方式三外部 exe。项目编译成控制台程序在 Tekla 已经运行的前提下连接图纸库。适合团队内部的命令行工具和定时任务但要处理好进程连接细节。对入门来说我建议先用方式一起步不用处理繁琐的插件注册改代码也方便。2.3 创建最小可运行工程具体步骤Visual Studio 新建类库.NET Framework项目目标框架 4.6.2。添加引用路径指向上面提到的三个 dll。写一个类核心代码如下。using System; using Tekla.Structures.Drawing; public class DrawingDemo { public void Run() { DrawingHandler handler new DrawingHandler(); if (!handler.GetConnectionStatus()) { Console.WriteLine(未连接到Tekla进程); return; } DrawingEnumerator drawings handler.GetDrawings(); while (drawings.MoveNext()) { Drawing drawing drawings.Current as Drawing; if (drawing null) continue; Console.WriteLine(发现图纸 drawing.Name); } } }编译生成 DrawingDemo.dll。如果想以宏方式运行直接把 .cs 源码保存到宏目录在 Tekla 的工具-宏里运行比如%LOCALAPPDATA%\Tekla Structures\版本\UserApplication\Macros。我实际实践下来源码宏的维护比编译 dll 省心特别适合早期验证阶段。2.4 调试这个工程最省事的方法调试最省事的方式是在代码里加一行System.Diagnostics.Debugger.Break();运行宏或插件时系统会弹出选择调试器窗口选到已经打开项目的 Visual Studio 实例附加到 tekla.exe 进程然后就能单步看变量。也可以用 VS 的调试-附加到进程手工附加。很多新手在这里卡住以为是代码没生效其实只是没附加到正确的进程或者没在运行宏之前附加导致错过断点。另一个常见问题首次引用 dll 时把路径里的版本号写错编译时提示找不到命名空间先去确认自己的 Tekla 版本对应 bin 目录里确实存在Tekla.Structures.Drawing.dll。如果用到某些 32 位兼容库记得把编译平台改成 x64新版 Tekla 基本都是 64 位进程。3. 图纸对象模型拆解Drawing、View 和 Mark 的层级关系3.1 从 Drawing 到 DrawingView 的整条链路图纸模块的对象关系我习惯用一句话概括一张图纸对应一个 Sheet一个 Sheet 下有多个 DrawingView每个 DrawingView 里挂着一堆 DrawingObject。具体到代码里入口是DrawingHandler它拿到的是Drawing集合Drawing里有GetSheet()Sheet里有GetViews()DrawingView里有GetAllObjects()。这条链路和模型对象是高度对称的模型入口是Model模型里有各种零件图纸入口是DrawingHandler图纸里有视图、标记、尺寸。你把两条链路对照着学很快就能建立整个 TEKLA 二次开发的坐标系。3.2 图纸对象与模型对象是两套体系这是图纸二次开发最核心的一个认知。很多人一上来就在图纸代码里调用模型接口想通过Model.SelectModelObject()拿一个 Part改零件属性后让图纸跟着变——这基本行不通。图纸视图里的零件并不是模型 Part 类的引用它是图纸数据库中独立的一份对象保存了生成快照时的几何和属性。你要改图纸上的零件标记文字正确路径是在图纸上下文里找到对应的PartMark对象修改它的MarkContent模型侧只负责驱动重新生成不会反过来监听你对图纸标记的修改。同理模型里改了几何图纸不会立刻变必须更新视图或重新创建标记。这个快照特性决定了批量修改时一定要基于图纸对象的当前状态做判断不要只依赖模型属性。3.3 关键类速查类职责入门优先级DrawingHandler图纸数据库连接入口获取/打开/保存图纸必须Drawing图纸对象含 Name、Title、GetSheet必须Sheet图签管理视图集合必须DrawingView视图包含图纸对象必须DrawingObjectEnumerator遍历视图内对象的迭代器必须Mark / PartMark / BoltMark各类标记重点MarkContent标记内容容器保存了 Text/Symbol 片段重点Text / Symbol标记中的文本和符号片段重点3.4 为什么说图纸对象是投影快照图纸里的对象是模型在出图时刻的投影。模型改了连接节点图纸上的焊缝标记不会自己更新模型改了截面视图里的零件轮廓也不会自己变。开发时必须把图纸对象当作独立数据看修改哪张图就处理哪张图不要试图只在模型侧改参数然后祈祷图纸自动跟上。理解了这一点下面这段源代码就好懂了。4. 图纸遍历与标注批改可直接上手的源代码详解4.1 遍历所有图纸并按类型筛选图纸对象模型中GetDrawings()返回的集合包含全部图纸类型。想只要构件图用类型过滤比拿字符串判断名称稳定得多。using System; using System.Collections.Generic; using Tekla.Structures.Drawing; public class DrawingWalker { public Liststring ListAssemblyDrawingNames() { Liststring names new Liststring(); DrawingHandler handler new DrawingHandler(); if (!handler.GetConnectionStatus()) return names; DrawingEnumerator drawings handler.GetDrawings(); while (drawings.MoveNext()) { AssemblyDrawing drawing drawings.Current as AssemblyDrawing; if (drawing null) continue; names.Add(drawing.Name | drawing.Title); } return names; } }AssemblyDrawing是构件图SinglePartDrawing是零件图CastUnitDrawing是浇筑件图。GetDrawings()返回的枚举器只能向前遍历不能回退用MoveNext()循环最稳妥。4.2 打开图纸、枚举视图内对象拿到图纸对象还不代表能看到视图里的东西必须用OpenDrawing把它真正打开到图纸上下文里然后才能遍历 Sheet 和 DrawingView。public void TraverseObjectsInDrawing(Drawing drawing) { DrawingHandler handler new DrawingHandler(); if (!handler.OpenDrawing(drawing)) return; try { Sheet sheet drawing.GetSheet(); if (sheet null) return; DrawingViewEnumerator views sheet.GetViews(); while (views.MoveNext()) { DrawingView view views.Current as DrawingView; if (view null) continue; DrawingObjectEnumerator objs view.GetAllObjects(); while (objs.MoveNext()) { DrawingObject obj objs.Current; Console.WriteLine(obj.GetType().Name); } } } finally { drawing.Close(); } }这条代码是认识图纸对象模型最快的办法。打开一张实际图纸跑一遍把每个对象的类型名打印出来比翻半天英文文档强得多。我每次接触新版本 TEKLA都会先用类似代码确认对象类型有没有变化。4.3 修改标记文字的正确姿势标记内容在 Tekla 里不是普通字符串。Mark.Content返回的是MarkContent它内部是一个集合包含Text、Symbol、Element等片段。想改标记里的文字必须遍历 Content 找到Text片段再修改。public void ReplaceTextInMark(Mark mark, string oldText, string newText) { MarkContent content mark.Content; foreach (MarkContentPart part in content) { if (part is Text textPart textPart.Content oldText) { textPart.Content newText; mark.Modify(); } } }为什么不能直接mark.Content xxx类型对不上编译都不一定过。即便你能构造一个 MarkContent 塞进去也会丢掉标记里原有的动态属性片段。标记里的零件编号、构件编号这些动态字段本质是特殊片段你用普通文本覆盖就等于把它写死了以后模型变更它也不会自动更新。修改前最好确定哪些片段是纯文本、哪些是动态属性能不动就不动。4.4 保存、关闭与异常隔离改完标记后保存动作是handler.SaveDrawing(drawing)。如果只是读图纸做练习不保存直接 Close 就行。实践里我遇到最多的问题是循环处理几百张图纸中途某一张异常导致后面全断。正确姿势是每张图纸单独 try-catch记录失败的图纸名称循环不中断。while (drawings.MoveNext()) { Drawing drawing drawings.Current as Drawing; if (drawing null) continue; try { ProcessOneDrawing(handler, drawing); } catch (Exception ex) { Console.WriteLine(处理失败 drawing.Name | ex.Message); } }任何图纸批处理工具第一步就该把异常隔离做好。不然线上跑一次全流程崩溃你连哪张图出了问题都要猜半天。这已经是图纸二次开发的基本职业素养。5. 避坑清单与工程化习惯版本兼容、句柄失效和 UI 线程的边界5.1 版本兼容陷阱Tekla 的年度版本迭代很快API 命名空间大体稳定但内部方法经常被标记为 Obsolete甚至直接删除。用 2024 版编译的 dll放到早期版本里十有八九起不来缺的是运行库版本。多版本并存的团队最常用的做法是维护一个最低支持版本作为编译环境代码里避免使用新版本专有 API。产品级工具则要做条件编译或者干脆按版本出多个安装包。对个人脚本来说不用太纠结认准自己项目里那个版本就好但心里要清楚换了大版本一定要重新编译并回归测试不要以为 dll 通用。5.2 对象句柄的生命周期从枚举器里拿到的DrawingObject不是数据库里的永久句柄更像一次查询快照。你持有它去做修改时如果期间 Tekla 内部刷新过视图、或者打开了别的图纸这个对象可能已经失效。最稳妥的做法是打开图纸后立刻在 try 块里完成查对象-改对象-保存一气呵成不要持有很多对象的引用再去做别的事。这一点和模型二次开发类似但图纸场景更敏感因为图纸对象活在图形上下文里受界面状态影响很大。5.3 UI 线程和后台批处理的边界图纸相关 API 基本要求在主线程跑。很多工程师习惯把批处理丢进Task.Run里防止界面卡死结果发现枚举报错、打开图纸失败、对象状态不对。Tekla 的图形引擎和文档管理在底层绑定了线程模型不是你想提就可以随便提的。如果担心界面卡顿正确做法是拆小批次处理 20 张保存一次给界面留出刷新时间或者做一个进度条让用户等。不要硬上多线程收益低坑倒是不少。5.4 打开图纸冲突与内存增长另一类高频问题是图纸占用冲突。用户正开着 AW-101 这张图你的批处理脚本也想去 OpenDrawingTekla 要么拒绝要么直接把界面里的图踢掉。对工具来说这是不可接受的。我习惯在批处理开始前弹一个提示要求用户关闭所有已打开的图纸并提供跳过当前正在打开的图纸选项。另外循环里要及时 Close否则内存持续增长。图纸对象持有的是进程内文档对象积攒多了后段明显卡顿几百张图纸一起跑的时候尤其明显。5.5 工程化习惯最后分享几条我自己的工程化习惯。第一日志一定写记录工具版本、开始时间、图纸总数每张图纸记录成功/失败原因。第二先做 5 张试跑跑通再全量。第三不要直接覆盖源图纸批量修改前先另存副本或者用模型备份做回滚。第四代码按连接-遍历-处理-保存四层拆分以后换项目改起来快。第五把图纸编号、模型名、类型组合成核心日志字段排错效率高很多。我早些年吃过亏第一次跑线上批处理时没写日志半夜出问题第二天对着几十张被改乱的图纸一头雾水。现在无论多小的脚本日志和试跑都省不了。图纸二次开发的门槛其实不高但对流程的敬畏心一定要有。本文还有配套的精品资源点击获取