简介：面向钢结构详图设计与TEKLA二次开发初学者的一套图纸入门源代码，围绕模型图纸列表载入、图纸选择、图纸打开及图纸数值提取等基础环节，展示如何借助TEKLA API与C#把重复操作转为可复用的自动化流程。压缩包共20个文件，约74KB，以cs源代码为主，配有resx资源、sln解决方案、csproj项目文件以及config、settings等配置项，构成可直接在Visual Studio中查阅的入门工程，便于对照理解界面窗体、事件处理与数据读取的组织方式。已有793人学习，适合作为熟悉TEKLA对象模型、补齐WinForms交互与API调用思路的练习素材，也能为后续定制图纸管理和数据提取工具提供参考。

1. 先弄明白：TEKLA二次开发到底在开发什么

TEKLA二次开发这个词，新手十有八九会把它和「学 Tekla 建模」搞混。建模是你握着鼠标，一根梁一根柱地摆；二次开发是写段程序，让软件替你去摆、去改、去出图。这次看的资源，主题是图纸入门，附带了能直接跑起来的源代码——图纸就是 Tekla 出零件图、构件图那套功能，源代码是别人写好、你能打开看懂再改成自己用的示例程序。

最容易卡住新手的不是技术，是心理：一看「开发」「源代码」就以为得先把算法啃完。入门阶段用到的编程，其实大多是「找到对象、改个属性、保存」这种朴素动作。这份资源要解决的，就是把「鼠标点一百遍」换成「代码跑一遍」。适合每天重复出图的人、想给团队做小工具的人，以及完全没写过代码但愿意花几个晚上试试的人。

2. 为什么值得学：把重复画图的时间省回来

2.1 图纸岗的重复劳动，到底重复在哪

把一张构件图从模型状态变成能发出去的成品，中间的动作拆开看是这样的：选图纸类型和属性、调视图比例、挪视图位置、补标注、改标题栏、核对尺寸链、导 PDF。单看每一步都不难，难在次数——一张图要点几十下鼠标，一套项目几十上百张图，加起来就是好几天。

更麻烦的是「改一次」。截面换了、构件编号变了、轴线调了，模型一改，图纸要么重新出、要么手工调回来，前面那些点击全部作废。这种活儿不烧脑，但极其消耗耐心，时间长了人会变得很机械。

二次开发的切入点恰恰在这里：凡是规则固定、每次做法都一样的动作，就适合写成代码。你不必一上来就想着「做个大系统」，先盯着一天里重复次数最多的那一个动作，把它自动化，收益就已经很实在了。

判断一件事值不值得写代码，我一般看两个条件：第一，这件事下次还会做，而且不止一次；第二，这件事的规则能用一句话说清楚，比如「所有构件图的标题栏第二行改成项目名」。两个条件都满足，写代码就是赚的；只要有一个不满足，比如就这一次、或者规则每次都不一样，手点反而更快。

2.2 会写几行代码的详图员，和只会点鼠标的详图员差在哪

先说清楚，这不是抢饭碗。写代码的人依然要懂图纸规范、懂出图习惯，因为代码里那些规则是你定的，软件不会替你判断「这张图该不该剖」。区别在于产能的上限：只会点鼠标的人，产能受限于手速和耐心；会用代码的人，产能受限于「你想清楚了没有」。

具体能做的事，入门阶段就能摸到的有这么几类：

• 批量改标题栏，比如项目名、图号前缀、日期，一次改完整个模型的图纸。
• 批量调视图比例和位置，让一批构件图的排版统一。
• 出图前自动检查，比如某个视图里有没有漏掉的零件标注。
• 按命名规则自动出图，构件编号一到手就生成对应图纸。
• 批量导出 PDF 或 DWG，省掉一张张点导出的时间。

这些事情的代码内核都不复杂，无非是「循环 + 判断 + 改属性」。真正需要经验的地方在于：你得先手工把这件事做对一遍，才知道代码该按什么顺序做。跳过手工这一步直接写代码，八成写出来的东西不符合出图规范。

反过来说，也要认清一件事：不是所有活儿都适合自动化。一次性任务、规则天天变的任务、需要大量人工判断美不美观的任务，写代码的投入产出比很低。入门阶段最常见的翻车，就是花两个星期写了个工具，结果那个流程下个月就不用了。血泪经验就一句话：先做最枯燥、最重复、规则最死的那一个。

2.3 零基础要付出的成本：三个真实门槛

说「零基础也能学」不是画饼，但也不能假装没门槛。老实讲，需要跨过去的有三道。

第一道是编程语言。Tekla Open API 是一套 .NET 接口，主流写法是 C#，所以要跟 Visual Studio 打交道。好消息是入门不需要学完一整本 C# 教材，掌握类、对象、方法、循环、if 判断、List 这几个概念，就够你跑通第一个例子了。LINQ、异步、委托、设计模式这些，等你真的遇到问题了再补完全来得及。

第二道是看懂 API 帮助文档。Tekla 安装时会附带一份开发帮助文档，里面按「命名空间 → 类 → 属性/方法」的层级组织。新手第一次打开会懵，因为目录树长得吓人。实际用法很朴素：你想改标题栏，就在文档里搜 Title；你想拿图纸列表，就搜 DrawingHandler。带着具体问题去搜，比从头读到尾效率高十倍。

第三道是理解 Tekla 自己的对象模型，这一道最容易被低估。模型侧有零件、构件、梁、柱这些概念，图纸侧有图纸、视图、图纸对象这些概念，两边是两套东西。代码里如果搞混了「模型里的零件」和「图纸里的零件」，结果就是一片 null 和类型转换异常。第 4 章会专门把这三层结构拆开讲。

至于数学，入门阶段真不用太担心。几何计算 API 基本帮你做完了，你需要提供的是坐标点、方向向量这种直白的东西，很少需要自己推公式。真正卡人的往往不是数学，而是「不知道这个方法叫什么名字」。

3. 动手前的准备：环境、语言和第一段能跑的代码

3.1 装什么：一份能跑起来的最小环境清单

先把环境凑齐，别急着写逻辑。新手最常见的开局失败不是代码错，而是环境没对，报一堆找不到程序集的错误，人直接劝退。

需要准备的东西如下：

引用 DLL 这一步是重点。在 Visual Studio 里新建一个「类库（.NET Framework）」或「控制台应用」项目，然后右键引用 → 添加引用 → 浏览，到你本机 Tekla 安装目录下，找以 Tekla.Structures 开头的几个 DLL，通常至少要引入这几个：

• Tekla.Structures.dll，基础类型和通用工具
• Tekla.Structures.Model.dll，模型侧的一切
• Tekla.Structures.Drawing.dll，图纸侧的一切
• Tekla.Structures.Geometry3d.dll，点、向量、坐标系
• Tekla.Structures.Plugins.dll，如果要做成 Tekla 里的按钮

提示：加完引用后，把这几个 DLL 的「复制到本地」属性设为 False。它们应该由 Tekla 自己提供，跟着你的程序复制一份出去，版本一乱就会在客户机器上报错。

还有一个特别容易忽略的点：你引用的 DLL 版本必须和本机安装的 Tekla 版本一致。两台电脑装的软件版本不同，同一份代码在一台机器上跑得好好的，换台机器就抛异常，这类问题排查起来非常费劲，属于典型的「玄学故障」。团队协作的话，开工前先把版本统一，能省掉后面无数扯皮。

3.2 第一段代码：连上模型，把图纸名字打出来

第一个例子别追求有用，追求「能跑通」。这里选的目标是：连上当前打开的模型，把它里面所有图纸的名字打印出来。代码很短，但它把开发里最核心的三件事串起来了——连上软件、拿到对象集合、遍历。

新建一个控制台项目，把下面这段贴进去：

using System; using TSD = Tekla.Structures.Drawing; // 图纸相关，起别名避免和模型侧重名 using TSM = Tekla.Structures.Model; // 模型相关 namespace DrawingDemo { class Program { static void Main(string[] args) { // 第一步：确认 Tekla 已经打开并且加载了模型 TSM.Model model = new TSM.Model(); if (!model.GetConnectionStatus()) { Console.WriteLine("没连上模型，先把 Tekla 打开并加载一个模型"); return; } // 第二步：拿到图纸处理器，它是操作图纸的总入口 TSD.DrawingHandler handler = new TSD.DrawingHandler(); // 第三步：取出当前模型里的所有图纸，得到一个枚举器 TSD.DrawingEnumerator drawings = handler.GetDrawings(); int count = 0; while (drawings.MoveNext()) { TSD.Drawing drawing = drawings.Current; count++; // Name 是图纸名，Title1/Title2/Title3 是标题栏里的三行标题 Console.WriteLine($"{count}. {drawing.Name} | {drawing.Title1} | {drawing.Title2}"); } Console.WriteLine($"一共 {count} 张图纸"); } } }

这段代码的逻辑是一条直线。Model代表模型这一侧，GetConnectionStatus()返回一个布尔值，告诉你当前有没有连上正在运行的 Tekla 进程，这一步必须放在最前面，因为后面所有操作都依赖它。DrawingHandler是图纸侧的总入口，你可以把它理解成图纸模块的管理员，取图纸、存图纸、切换当前图纸都通过它。GetDrawings()返回的是一个DrawingEnumerator，这东西不能像数组那样用下标取，只能反复调用MoveNext()往后走一格，Current就是当前那张图纸。

参数上唯一需要留意的是Title1、Title2这类属性，它们对应图纸标题栏里从上往下的几行文字，具体哪一行显示在图纸的哪个位置，取决于你用的图纸模板。第一次跑的时候，如果发现某张图纸的标题是空的，不用怀疑代码，多半是那张图本身就没填。

跑通之后建议做个小改动练手：把输出改成只打印图纸名以某个前缀开头的那些。别小看这个改动，它让你第一次体会到「过滤」这件事怎么写，而过滤在真实工具里用得极多。

3.3 从控制台到按钮：把代码变成 Tekla 里的一个命令

控制台程序能跑通逻辑，但对同事不友好——总不能让人家先装个 Visual Studio。真正好用的形态是把它做成 Tekla 里的一个按钮，点一下就执行。

Tekla 的插件有一套固定骨架：继承PluginBase，加上两个特性标注，然后实现Run方法。最小可运行的结构大概是这样：

using System.Collections.Generic; using Tekla.Structures.Plugins; using TSD = Tekla.Structures.Drawing; namespace DrawingDemo { // 第一个特性决定这个插件叫什么名字，会显示在 Tekla 的插件列表里 [Plugin("图纸小助手")] // 第二个特性指向参数输入界面的定义，没有界面时按项目模板给个占位值 [PluginUserInterface("DrawingDemo.UserInterface")] public class DrawingCountPlugin : PluginBase { // Tekla 会通过这个构造函数把参数传进来，无参场景下可以留空 public DrawingCountPlugin(string data) { } // Run 就是点按钮之后真正执行的入口 public override bool Run(List<InputDefinition> parameterList) { TSD.DrawingHandler handler = new TSD.DrawingHandler(); TSD.DrawingEnumerator drawings = handler.GetDrawings(); int count = 0; while (drawings.MoveNext()) { count++; } // 用消息框把结果告诉用户，比控制台友好 System.Windows.Forms.MessageBox.Show($"当前模型共有 {count} 张图纸"); return true; } } }

[Plugin]里的字符串就是按钮在软件里显示的名字，改成中文完全没问题。Run的返回值是布尔值，返回 true 表示执行成功，Tekla 会照常结束这次调用；返回 false 通常意味着中途出了状况。parameterList是用户在界面上填的参数，这个例子里没有界面，所以用不到它。

代码写完之后要编译成 DLL，然后把 DLL 放到当前模型目录下的 plugin 文件夹里，回到 Tekla 里刷新一下「应用程序和组件」列表，按钮就出现了。

注意：插件 DLL 是跟着模型目录走的，不是跟着软件安装目录走。换个模型就找不到按钮，这不是 bug，把 DLL 复制到新模型的 plugin 目录即可。

这一步做完，你就拥有了一个「能点」的东西。别急着往里面塞复杂逻辑，先确认这个按钮能在同事的机器上也点出来——环境问题在这一步暴露，比在代码写到两千行的时候暴露要好得多。

4. 图纸入门：从模型里的一张零件图开始

4.1 先理清图纸的三层结构：图纸、视图、对象

图纸这块最容易把人绕晕，因为「图纸」这个词在日常里既指那张纸，也指纸上的内容。在 API 里它是有严格层级的，用 Excel 打比方最直观：一个工作簿里有很多工作表，工作表里有很多单元格。对应过来就是图纸、视图、图纸对象。

第一层是图纸本身，也就是Drawing。它管的是整张图的属性：图纸名、标题栏文字、纸张大小、出图比例这种全局设置。你平时在 Tekla 里点「图纸属性」看到的那个对话框，大部分内容对应这一层。

第二层是视图，也就是View。一张图纸上可以有好几个视图，比如一个构件图里同时有立面、剖面、节点大样。视图管的是「从哪里看、看多大、摆在纸上哪个位置」，比例和坐标系的设置主要在这一层。

第三层是图纸对象，也就是DrawingObject的各种子类。视图里画的每一样东西都在这一层：零件轮廓、螺栓、尺寸标注、零件标记、文字、线条、矩形框。你在图纸上框选能选中的东西，基本都是这一层的对象。

三层的关系理清了，代码该往哪一层下手就清楚了。改标题栏找第一层，调比例找第二层，改标注文字找第三层。新手最常见的错误是拿第三层的对象去调第二层的属性，编译器不会拦你，运行时给你一个空引用，然后你盯着代码发呆。

顺便把两边的概念对应关系列一下，这个表建议存下来：

模型侧和图纸侧是两套独立的命名空间，这也是为什么代码开头要用别名把Tekla.Structures.Model和Tekla.Structures.Drawing分开。两边的类名有重叠，不区分的话编译器直接报歧义。

4.2 造出第一张零件图：从选中零件到落盘

第二个例子做点更有成就感的事：在模型里选中一个零件，给它生成一张零件图。流程是先在模型侧找到对象，再在图纸侧创建对应的图纸对象，最后提交给 Tekla 去生成。

using System; using TSD = Tekla.Structures.Drawing; using TSM = Tekla.Structures.Model; namespace DrawingDemo { class CreateDrawing { public static void Run() { // 1. 从模型里拿用户当前选中的对象 TSM.ModelObjectSelector selector = new TSM.ModelObjectSelector(); TSM.ModelObjectEnumerator selected = selector.GetSelectedObjects(); if (!selected.MoveNext()) { Console.WriteLine("先在模型里选中一个零件，再运行本程序"); return; } // 2. 转成零件类型。选中的可能是构件，也可能是别的，必须判断 TSM.Part part = selected.Current as TSM.Part; if (part == null) { Console.WriteLine("选中的不是零件，请重新选择"); return; } // 3. 用零件的 Identifier 构造一张零件图 TSD.SinglePartDrawing newDrawing = new TSD.SinglePartDrawing(part.Identifier); // 4. 填标题栏文字，这几行会直接显示在图纸上 newDrawing.Name = "自动生成示例"; newDrawing.Title1 = "某模拟项目"; newDrawing.Title2 = part.Name; // 5. 交给 Tekla 真正生成 TSD.DrawingHandler handler = new TSD.DrawingHandler(); bool ok = handler.CreateDrawings(new TSD.Drawing[] { newDrawing }); Console.WriteLine(ok ? "图纸生成成功" : "图纸生成失败，检查图纸属性文件是否存在"); } } }

第一段里ModelObjectSelector的作用是读取用户在软件界面上的选择，GetSelectedObjects()返回的同样是枚举器，MoveNext()加Current是老朋友了。这段代码其实隐含了一个很实用的设计思路：让用户在界面上选中目标，代码只负责处理，比在代码里写死一堆查询条件灵活得多。

第二段的as转换是新手必须养成的习惯。用户选中的东西理论上可能是任何模型对象，直接强转一旦类型不对就抛异常，用as加空判断，出错时能优雅退出并给出提示，这是「能用」和「好用」的分水岭。

第三段的Identifier是 Tekla 给每个模型对象分配的唯一编号，相当于身份证号。创建图纸时传这个编号，而不是传对象本身，是因为图纸侧和模型侧是两套系统，它们之间靠编号对话。

第四段设置Name和Title1、Title2的时候要注意，这些字符串会原样出现在图纸上，长度受模板限制，太长会被截断或者压到别的东西上，实际用的时候建议先手工量一下能放多少字。

第五段的CreateDrawings返回布尔值，成功与否一定要判断并且打印出来。这里失败最常见的原因是图纸属性文件不存在——Tekla 出一张图需要一套属性配置，比如用哪套图纸尺寸、哪套布局，代码里没指定就会去用默认的，默认的找不到就失败。稳妥的做法是先在软件里手工给这个零件出一次同样的图，确认能出，再跑代码。

提示：不同版本里CreateDrawings的参数形式和图纸类的构造函数可能略有差异，以本机安装的 API 帮助文档为准。遇到签名对不上，别硬猜，直接翻文档。

4.3 改一张已有图纸：批量改文本和标题栏

比起新建图纸，日常更常见的是改已有图纸。这段代码演示两件事：遍历当前打开图纸里的所有对象，把类型是文字的挑出来，统一改字体和字号。

using System; using TSD = Tekla.Structures.Drawing; namespace DrawingDemo { class BatchText { public static void Run() { TSD.DrawingHandler handler = new TSD.DrawingHandler(); // 取当前打开的那张图纸 TSD.Drawing current = handler.GetActiveDrawing(); if (current == null) { Console.WriteLine("先打开一张图纸再运行"); return; } // 拿到图纸里的所有对象 TSD.DrawingObjectEnumerator objects = current.GetObjects(); int changed = 0; while (objects.MoveNext()) { // 只处理文字对象，其他类型直接跳过 TSD.Text text = objects.Current as TSD.Text; if (text == null) continue; // 属性是值类型，改之前先取出来，改完再塞回去 TSD.Text.TextAttributes attrs = text.Attributes; attrs.Font = new TSD.Font("Arial", 3.5); // 字体名 + 字高（毫米） text.Attributes = attrs; // 关键一步：告诉 Tekla 这个对象被改过了 text.Modify(); changed++; } // 提交更改，让界面刷新 current.CommitChanges(); Console.WriteLine($"共修改 {changed} 个文字对象"); } } }

GetActiveDrawing()拿的是用户此刻正在看的那张图纸，返回 null 说明当前没有图纸处于打开状态，这个判断必须有，否则后面直接空引用。

GetObjects()返回图纸上的所有对象，注意它拿的是整张图纸的对象，包括各个视图里的，不是只拿某一个视图的。如果只想处理某个视图，就需要先遍历Sheet再遍历View，层次感更强，代码也更长，入门阶段先用整图遍历把逻辑跑通。

中间那段Attributes的取值—修改—回填是 Tekla API 的通用套路，很多属性都长这样。它不是对象引用，而是一个结构体，你直接写text.Attributes.Font = ...编译器会报错，必须先取出来改，再整体塞回去。这个坑几乎每个新手都会踩一次。

Modify()这一行极其重要，但最容易被忘。它相当于告诉 Tekla「这个对象我改完了，你更新一下」，漏掉它，代码不报错，图纸也没变化，你会怀疑人生。改完一批之后调CommitChanges()，让界面统一刷新，避免一个个对象各自刷屏。

最后提醒一句，这个例子会改掉图纸上所有文字对象，包括你不想动的那些。真实使用前一定在测试模型上跑，或者先加个条件过滤，比如只改图层名等于某个值的文字。

5. 新手避坑：图纸二次开发最容易翻车的五个地方

5.1 图纸操作里的三个高频坑

第一个坑：代码跑完没报错，图纸一点变化都没有。

现象是把程序从头跑到尾，控制台输出了「修改成功」，回到 Tekla 一看，图纸原封不动。原因是改完对象属性之后漏掉了Modify()，或者批量改完漏掉了CommitChanges()。Tekla 内部有一层缓存，你不明确告诉它「这个对象脏了，需要更新」，它就认为什么都没发生。解决办法很朴素：每改一个对象就调一次Modify()，一批改完再调一次图纸级别的CommitChanges()，两个都别省。

第二个坑：创建图纸一直返回 false。

现象是CreateDrawings返回 false，或者程序抛异常说找不到属性。原因通常是图纸属性文件缺失或者名字对不上——代码里指定了某套图纸属性，但这台机器上根本没有这套配置，或者名字拼错了一个字母。解决办法是先手工出一次同样的图，确认软件本身能出，再回头看代码里指定的属性名；另外要确认这个零件已经编号，没编号的零件出图会失败。

第三个坑：改完图纸，关掉重开又变回原样。

现象是改完当场看着是对的，关闭图纸再打开，改动全没了。原因是你只改了内存里的对象，没把图纸存盘。解决办法是在改完之后显式保存当前图纸，用图纸对象自带的保存方法，或者用DrawingHandler的保存当前图纸方法。养成习惯：凡是改了图纸，代码结尾一定要有一步保存，别指望软件替你记着。

第四个坑：改着改着突然抛空引用，但昨天还好好的。

现象是同一段代码，在 A 模型上跑得好好的，换到 B 模型就在某一行崩了。原因多半是数据本身的差异，比如某张图纸上没有文字对象，遍历时某个转换返回了 null，你没判断就直接用了。解决办法是所有as转换后面都跟一个空判断，continue掉不匹配的对象；这也是为什么前面的例子里每一处转换都写了if (xxx == null)。

5.2 环境和调试里的两个坑

第五个坑：本机跑得通，同事电脑一打开就报找不到程序集。

现象是程序在你自己机器上丝滑运行，复制到同事电脑上，双击就弹异常，提示找不到某个 Tekla.Structures 开头的 DLL，或者提示版本不匹配。原因是两台机器的 Tekla 版本不同，引用的 DLL 版本号对不上，.NET 的强名称绑定直接拒绝加载。解决办法是把团队的软件版本统一；如果实在统一不了，就按目标机器上的 DLL 重新编译一份，别指望一份 DLL 通吃。这也是为什么前面强调「复制到本地」要设成 False——让程序用目标机器自己的那份。

第六个坑：调试时断点根本进不去。

现象是按 F5 启动调试，程序一闪而过，断点显示一个空心圈，提示没有加载符号。原因是你在调试一个类库项目，它本身不能独立运行，得由 Tekla 这个宿主进程来加载。解决办法是把项目的调试设置改成启动外部程序，指向 Tekla 的可执行文件，或者干脆用「附加到进程」的方式，先打开 Tekla，再从 Visual Studio 附加到它的进程上。第一次配这个会花点时间，配好之后调试体验会顺畅很多。

注意：调试图纸相关代码时，尽量在测试模型上折腾。图纸一旦被脚本改坏，恢复起来比模型麻烦，很多时候只能重新出图。

这六个坑没有一个是「原理深奥」型的，全是「不知道有这么回事」型的。新手阶段摔的跟头，九成都在这个范围里。把这些记住，能省掉大量原地打转的时间。

6. 下一步学什么：从会跑例子到能写自己的图纸工具

跑通前面几个例子之后，很多人会进入一个尴尬期：例子看懂了，但自己想做的功能不知道从哪下手。这个阶段最有效的做法不是继续看教程，而是按一条具体的路径往上爬。

我建议的顺序是这样的：

第一步的关键是学会「加条件」。任何批量操作，第一版都应该写成「只处理我指定的那一个」，确认无误后再放开范围。第二步要补的知识是图纸的层级遍历，从图纸到视图再到对象，这条路走通了，你就能做「只改某个视图里的标注」这类精细活。第三步是个分水岭，一旦你的工具能读外部数据，它就从「玩具」变成「能对接实际流程的东西」了，通常读的是表格文件，把构件编号和图纸名的对应关系放进去。第四步偏工程化，界面做得好不好直接影响别人愿不愿意用。第五步最不显眼但最重要，没有日志的工具，出了问题只能靠猜。

学习资源上，最该花时间的是本机安装的那份 API 帮助文档，其次是软件自带或项目里现成的示例代码。看示例代码有个技巧：不要从头读到尾，先找到「跟你目标最像」的那一段，把它跑起来，再一点点删掉你不需要的部分，看删到哪里会崩——这个过程比读十遍文档都管用。

从那以后我每次写完一段改图纸的代码，都强制自己在测试模型上从头跑一遍再放到正式项目里，哪怕只改了一行。图纸这种东西，改坏了不像模型那样能一眼看出来，等发现的时候往往已经发出去好几版了。希望帮到你。

本文还有配套的精品资源，点击获取