TEKLA二次开发案例自学手册.doc

文档介绍：该【TEKLA二次开发案例自学手册 】是由【雨林书屋】上传分享，文档一共【12】页，该文档可以免费在线阅读，需要了解更多关于【TEKLA二次开发案例自学手册 】的内容，可以使用淘豆网的站内搜索功能，选择自己适合的文档，以下文字是截取该文章内的部分文字，如需要获得完整电子版，请下载此文档到您的设备，方便您编辑和打印。TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
1/12
TEKLA二次开发事例自学手册
这类资料面向开发人员,他们在TeklaOpenAPI方面的经验极少。这包含
拥有必定量指导的练****但是没有太多自动学****和比较新奇的东西。
1TeklaStructures的TeklaOpenAPI的自学资料
练****的目的和构造
这类自学资料包含练****以帮助您学****和实践TeklaOpenAPI的基本看法。
想要覆盖开发人员可能面对的问题都是不行能的,所以特意介绍了一些典型的例
子。熟****API后,您可以为其余状况开发自己的应用程序。
这个练****分为几个较小的练****一个创办小建筑物的应用程序,而后从那处
生成图纸。练****包含一些建模和图纸的练****还包含对话框的使用。
在每次练****中,您将在TeklaStructures中看到最后结果的图像,您也可以获取示例代码。下一个练****开始时可以使用相同的示例代码。假如你自己的代码太不一样样以致于没法轻松地连续练****你可以使用示例代码库。参照手册
在开始练****以前,激烈建议您阅读OpenAPI的参照手册。参照手册包含在OpenAPI启动包中。
参照手册是使用API成立新软件时特别难得的资源。关于如何使用不一样的对
象和方法有很多很好的例子。这些练****中应使用参照手册。
以下章节包含自学API的练****在第章中,有关如何在MicrosoftVisualStudio2010中设置新项目以及如何使用API的练****建模和对话练****在第2章介绍,绘图练****在第3章中介绍。
在VisualStudio中创办一个新项目
您将学****在项目中使用API所需要做的工作。
前提:当您要测试您的应用程序时,您需要运转TeklaStructures并打开
模型,最好是空模型。
。
第一步是启动MicrosoftVisualStudio2010并从文件菜单创办一个新项
目(新建->项目)。
填写屏幕截图所示的详细信息,而后按OK创办一个空的Windows应用程序。
增加对API程序集的引用。
创办项目后,您需要增加对TeklaOpenAPI程序集的引用,如和。增加这些引用将使您可以使用这些程序集中包含的对象。
要增加引用,您可以右键单击解决方案资源管理器中的引用,而后从弹出菜单中选择增加引用,也可以从项目菜单中选择增加引用。
单击增加引用菜单中的阅读,以找到和文件。您将在TeklaStructures
安装文件夹文件夹中找到这些文件。找到它们以后,请选择它
们并选择打开,而后在增加引用对话框中按确立。
在练****中,您将需要这些参照:
(从找到)
假如要为TeklaStructures中创办一个插件,那么您需要增加。
接来下您可以在项目中使用API的类和方法。
将指令增加到API程序集的命名空间。
查察的代码(右键单击表单并选择查察代码),并将指令行增加到代码的开
头:
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
2/12
TEKLA二次开发事例自学手册
usingusingTSG3D=

此刻您可以使用

API

开始开发应用程序了。
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
2建模API的练****br/>以下是建模练****的主题:
(第章)在VisualStudio中创办一个新的项目
(第章)创办垫脚
(第章)在底座上增加列
(第章)将钢筋增加到垫脚上
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
(第章)使用目录UI控件
(第章)增加模板表单
创办垫脚
您将学****如何经过API在TeklaStructures中创办基本对象。
这个练****结果应该是这样的:
前提
您需要运转TeklaStructures并打开一个空模型。使用此模型,以便网格间距与示例中使用的相同:
(\TeklaOpenAPIStartUpPackage_v190\SelfLearningExercises\)
请记住阅读该页面上的提示。从第章阅读并学****关于在MicrosoftVisual
Studio中创办新项目。
创办创办垫脚的应用程序
在应用程序表单中增加一个按钮“创办垫脚”,并将脚注创办点击事件。在网格线A,E,1和6上的每个网格交点上创办垫脚。所以,总合创办18个垫脚。提示:
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
5/12
TEKLA二次开发事例自学手册
可以使用梁类创办垫脚。
您应该创办一个方法,依据给出的坐标地址创办一个垫脚。
而后,您可以使用for循环创办垫脚的地址。
创办Model实例后,经过调用()来检查连接能否有效。
那么可以使用API。
帮助:
请参阅参照手册中的最少以下主题:
Beamclass梁类

假如返回

true

,
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
说明:
关于代码应该做的简要说明:
1.
创办一个新的Model对象,该对象表示您在TeklaStructures
中打开的
TeklaStructures模型。
2.
检查您能否打开了可以连接的TeklaStructures
模型。
创办一种基于两个输入地址的创办并插入一个垫脚的方法。垫脚应该设置以手下性:
Name="FOOTING"
"1500*1500"
"K30-2"Class="8"StartPoint
EndPoint(changeZcoordinatemmlowerthaninstartpoint)
==请注意,这些值可能需要当地化,需要在环境中找到配置文件和
资料。
创办两个for循环以遍历地址的X和Y方向,并使用步骤3中提到的方法创办垫脚。
CommitChanges()保证在TeklaStructures中更新已完成的全部改正,
并相应更新模型视图。假如未调用此命令,则一定在TeklaStructures中手动
刷新视图以查察改正。
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
7/12
TEKLA二次开发事例自学手册
完成以后,您需要做的就是保证您已经打开了

TeklaStructures

模型,并
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
选择“从

VisualStudio

中的”调试“菜单开始运转您的项目。

您此刻将出现
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
带有“创办垫脚”按钮的窗体,并按压它将垫脚搁置在模型的网格交织点。
此练****的示例解决方案可以从“练****练****文件夹下的OpenAPI启动包中
找到。
(自学****练****br/>TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
在垫脚的顶部创办柱,并将柱连接到垫脚
您将学****如何创办与模型的连接。
结果应该是这样的:
前提
您需要运转TeklaStructures并打开一个空模型。你还需要第一个练****中的代码;你可以从下边的链接中获取它。
前一次练****的示例解决方案
帮助:
请参阅参照手册中的最少以下主题:
Beamclass梁类
Connectionclass连接类
在每个垫脚的顶部创办柱,并将其与加固的底板连接(1014)
更正上一个练****以便增加两种方法,一种用于在衬垫底座上增加柱,另一
种用于在垫脚和柱之间增增加固的底板(1014)。您需要返回插入的垫脚和列,
而后将它们供应给创办这些连接的方法(您也可以为代码使用其余架构)。
说明:
创办一个在垫脚上创办柱(Beam类)的方法。
使用连接类,加固底板(1014)将柱连接到垫脚上;使用柱作为主要部分。对柱使用这些值(记住要定位所需的值)
Name="Column";
"HEA400";
"S235JR";
Class="2";
;
==使用此属性用于加固的底板以实现锚杆:
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
11/12
TEKLA二次开发事例自学手册
SetAttribute("cut",1)
LoadAttributesFromFile("standard")
UpVector=newVector(0,0,1000)
关于“剪切”属性的说明。它是TeklaStructures中的一个选项菜单,它
。
另请注意,因为历史原由,选项菜单返回的值为:
第一个值(平时为0)表示内部空值
第二个值(平时为1)表示值0
第三个值(平时为2)表示值1。
这就是为何你需要将该属性设置为1,。
本练****的示例解决方案可以从练****2-2中的OpenAPI启动包中找到。
创办钢筋底座的钢筋
您将学****如何从模型中选择对象,而后使用列举器循环遍历这些对象。
结果应该是这样的:
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
前提:
您需要运转TeklaStructures并打开模型,最好是空模型。
您还需要练****的源代码。
前一次练****的示例解决方案
(自学****练****br/>帮助:
请参阅参照手册中的最少以下主题:

列)
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
ReinforcementandRebarGroupclasses
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
PolygonandPointclasses

多边形和点类
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
说明:
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
为每个垫脚成立钢筋。在对话框中创办一个字段以供用户给出基准的大
小。
在对话框中增加一个新按钮,使用以下方法创办钢筋。
从模型中选择全部对象到列举器(ModelObjectEnumerator)。
经过列举器循环。
假如物体是垫脚,则使用垫脚的StartPoint作为地址来创办钢筋组。
从对话框获取基础的大小。
在基础四周创办圆形钢筋。
使用这些值(记住要定位所需的值):
多边形,使用垫脚的角点作为多边形点,记住给出起点也是最后一点(见第
6点)。StartPoint和EndPoint,使用垫脚地址和高度。
Class=3
Name="FootingRebar"
Father,usepadfooting.
Grade="A500HW"
Size="12"
SpacingType=SPACING_TYPE_TARGET_SPACE
ExcludeType=EXCLUDE_TYPE_BOTH
StartNumber=0
Prefix="Group"
FromPlaneOffset=40
此练****的示例解决方案见OpenAPI启动包中的练****br/>TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
17/12
TEKLA二次开发事例自学手册
使用目录UI控件
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
API包含用于配置文件目录,钢筋目录和网格目录的窗体对话框,以帮助具
有窗体而且需要在UI中供应示例配置文件选择的应用程序(和插件)的开发人
员。此刻,您将学****如何使用现成的自定义用户界面控件从TeklaStructures中的目录中选择配置文件和网格。
您还将学****如何经过目录列举并自定义对话框中显示的项目列表。
此练****后,您的应用程序可能看起来像这样:
前提
您需要运转TeklaStructures并打开模型,最好是空模型。
您还需要练****的源代码。
将用户界面控件增加到VisualStudio的工具箱中:
有两种方法可以将控件增加到VisualStudio的工具箱中:
右键单击工具箱,而后选择“选择项目”。而后点击阅读按钮打开。控件将
被增加到列表中。您可以选择一个控件或全部要增加到工具箱的控件。
使用Windows资源管理器导航到\ProgramFiles\TeklaStructures\
[version]\nt\bin\dialogs\,打开Designer并将dll拖放到工具
箱的“老例”选项卡中。全部的控件将被增加到工具箱。请参阅下边的快照。
帮助:
请参阅参照手册中的最少以下主题:
FormBaseclass
ProfileCatalogclass
ReinforcementCatalogClass
SaveLoadClass
说明:
为了使用户界面控件工作,您的Form一定继承自ApplicationFormBase。
其余在Form的构造函数中一定调用
( );
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
19/12
TEKLA二次开发事例自学手册
让用户选择柱的配置文件。为此,您可以使用名为“ProfileCatalog”的用户界面控件。将此控件增加到窗体。您可以将控件拖放到“窗体”对话框中。
用户从对话框中选择的项目将被储存到SelectedProfile属性中。增加一个文本框以显示所选配置文件。
当用户将配置文件键入文本框并单击“选择”按钮时,应从配置文件目录对话框中自动选择键入的配置文件。将属性SelectedProfile设置为某个值将在对话框打开时从对话框中选择该值(假如该值包含在目录中)。
增加“ReinforcementCatalog”用户界面控件,选择垫脚的钢筋。
增加三个文本框以显示所选钢筋的尺寸,坡度和曲折半径。使用这些文本框
的值也可以在对话框打开时选择增强辑录对话框中的值。
在代码中替代配置文件和钢筋的硬编码值。
钢筋曲折半径可以在目录中拥有几个值,比方。“2040”,所以这些值需要
由应用程序办理。所以,我们不像以前那样在代码中定义半径值
我们可以咨询用户的值:
char[]Separator={''};
string[]Radiuses=
IteminRadiuses)
将“SaveLoad”控件增加到窗体。
只有绑定到某些属性的控件的值将被保存,这意味着它们拥有“AttributeName”和“AttributeTypeName”。要设置它们,打开VisualStudio
设计视图,而后转到“属性”选项卡。AttributeName和AttributeTypeName位
于标题TeklaStructures下:
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
20/12
TEKLA二次开发事例自学手册
AttributeName

是您表记控件的名称。
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
AttributeTypeName

是控件内容的的名称。可能的

AttributeTypeNames

是
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
Boolean,Distance

,DistanceListString

,Integer

和Double。
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
提示:
当使用用户界面控件“ProfileCatalog”和“ReinforcementCatalog”时,
请记住为事件“SelectClicked”和“SelectionDone”创办回调。
更正两个对话框的SelectClicked回调。当用户单击您的窗体中的选择按钮
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
24/12
TEKLA二次开发事例自学手册
时,会引起

SelectClicked

事件。更正回调,以便依据

Form

中的值设置
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
SelectedProfile

,

SelectedRebarGrade

,

SelectedRebarSize

和
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
SelectedBendingRadius

的值,比方:
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
=;
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册
当配置文件或钢筋选择对话框关闭时,会引起SelectionDone事件。要更新表单中显示的文本,请使用SetAttributeValue()方法和SelectedProfile,SelectedRebarGrade,SelectedRebarSize和SelectedBendingRadius属性中存
储的值。比方:
SetAttributeValue(ColumnsProfileTextBox,;
要替代硬编码值,您需要使用在文本框中定义的值。比方:
=;
此练****的示例解决方案可以从练****练****UIControls文件夹下的Open
API启动包中找到。
增加模板表单
您将学****如何使用命名空间中可用的一些继承的表单。这些继承的表单可以
用作一些最常有的TeklaStructures对话框的模板。
可用表单为:
CommitAction
CreateDialog
OrganizerDialog
PropertiesDialog
TreeViewDialog
TEKLA二次开发事例自学手册
TEKLA二次开发事例自学手册
12/12
TEKLA二次开发事例自学手册