TEKLA 二次开发 案例 自学手册

T E K L A二次开发案例

自学手册

work Information Technology Company.2020YEAR

这种材料面向开发人员，他们在Tekla Open API方面的经验很少。这包括具有一定量指导的练习，但是没有太多自动学习和比较新颖的东西。

1 Tekla Structures的Tekla Open API的自学材料

练习的目的和结构

这种自学材料包含练习，以帮助您学习和实践Tekla Open API的基本概念。想要覆盖开发人员可能面临的问题都是不可能的，因此特地介绍了一些典型的例子。熟悉API后，您可以为其他情况开发自己的应用程序。

这个练习分为几个较小的练习，一个创建小建筑物的应用程序，然后从那里生成图纸。练习包含一些建模和图纸的练习。还包括对话框的使用。

在每次练习中，您将在Tekla Structures中看到最终结果的图像，您也可以获取示例代码。下一个练习开始时可以使用相同的示例代码。如果你自己的代码太不一样以至于无法轻松地继续练习，你可以使用示例代码库。

参考手册

在开始练习之前，强烈建议您阅读Open API的参考手册。参考手册TeklaOpenAPI_Reference.chm包含在Open API启动包中。

参考手册是使用API构建新软件时非常宝贵的资源。关于如何使用不同的对象和方法有很多很好的例子。这些练习中应使用参考手册。

以下章节包括自学API的练习。在第1.1章中，有关如何在Microsoft Visual Studio 2010中设置新项目以及如何使用API的练习。建模和对话练习在第2章介绍，绘图练习在第3章中介绍。

1.1在Visual Studio中创建一个新项目

您将学习在项目中使用API所需要做的工作。

前提：当您要测试您的应用程序时，您需要运行Tekla Structures并打开模型，最好是空模型。

1.1.1创建一个新的.NET应用程序项目。

第一步是启动Microsoft Visual Studio 2010并从文件菜单创建一个新项目（新建->项目）。

填写屏幕截图所示的详细信息，然后按OK创建一个空的Windows应用程序。

1.1.2添加对API程序集的引用。

创建项目后，您需要添加对Tekla Open API程序集的引用，如

Tekla.Structures.Model.dll和Tekla.Structures.dll。添加这些引用将使您能够使用这些程序集中包含的对象。

要添加引用，您可以右键单击解决方案资源管理器中的引用，然后从弹出菜单中选择添加引用，也可以从项目菜单中选择添加引用。

单击添加引用菜单中的浏览，以找到Tekla.Structures.Model.dll和

Tekla.Structures.dll文件。您将在Tekla Structures安装文件夹\nt\bin\plugins\文件夹中找到这些文件。找到它们之后，请选择它们并选择打开，然后在添加引用对话框中按确定。

在练习中，您将需要这些参考：

●Tekla.Structures.dll

●Tekla.Structures.Model.dll

●Tekla.Structures.Drawing.dll

●Tekla.Structures.Dialog.dll（从\ nt \ bin \ dialogs \找到）

●Tekla.Structures.Catalogs.dll

如果要为Tekla Structures中创建一个插件，那么您需要添加

Tekla.Structures.Plugin.dll。

接来下您可以在项目中使用API的类和方法。

1.1.3将指令添加到API程序集的命名空间。

查看Form1.cs的代码（右键单击表单并选择查看代码），并将指令行添加到代码的开头：

using Tekla.Structures.Model;

using TSG3D = Tekla.Structures.Geometry3d;

现在您可以使用API开始开发应用程序了。

2建模API的练习

以下是建模练习的主题：

（第1.1章）在Visual Studio中创建一个新的项目

（第2.1章）创建垫脚

（第2.2章）在底座上添加列

（第2.3章）将钢筋添加到垫脚上

（第2.4章）使用目录UI控件

（第2.5章）添加模板表单

2.1 创建垫脚

您将学习如何通过API在Tekla Structures中创建基本对象。

这个练习结果应该是这样的：

前提

您需要运行Tekla Structures并打开一个空模型。使用此模型，以便网格间距与示例中使用的相同：

Exercise-model.zip

（\ TeklaOpenAPIStartUpPackage_v190\ SelfLearningExercises\ Exercise-model.zip）

请记住阅读该页面上的提示。从第1.1章阅读并学习关于在Microsoft Visual Studio中创建新项目。

创建创建垫脚的应用程序

在应用程序表单中添加一个按钮“创建垫脚”，并将脚注创建点击事件。在网格线A，E，1和6上的每个网格交点上创建垫脚。因此，总共创建18个垫脚。

提示：

●可以使用梁类创建垫脚。

●您应该创建一个方法，根据给出的坐标位置创建一个垫脚。

●然后，您可以使用for循环创建垫脚的位置。

创建Model实例后，通过调用Model.GetConnectionStatus（）来检查连接是否有效。如果返回true，那么可以使用API。

帮助：

请参阅参考手册中的至少以下主题：

●Beam class梁类

说明：

关于代码应该做的简要说明：

1.创建一个新的Model对象，该对象表示您在Tekla Structures中打开的Tekla Structures模型。

2.检查您是否打开了可以连接的Tekla Structures模型。

3.创建一种基于两个输入位置的创建并插入一个垫脚的方法。垫脚应该设置以下属性：

Name = "FOOTING"

Profile.ProfileString = "1500*1500"

Material.MaterialString = "K30-2"

Class = "8"

StartPoint

EndPoint (change Z coordinate 500.0 mm lower than in startpoint)

Position.Rotation = Position.RotationEnum.FRONT

Position.Plane = Position.PlaneEnum.MIDDLE

Position.Depth = Position.DepthEnum.MIDDLE

请注意，这些值可能需要本地化，需要在环境中找到配置文件和材料。

4.创建两个for循环以遍历位置的X和Y方向，并使用步骤3中提到的方法创建垫脚。