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

文档介绍：该【TEKLA二次开发案例自学手册 】是由【花开花落】上传分享，文档一共【12】页，该文档可以免费在线阅读，需要了解更多关于【TEKLA二次开发案例自学手册 】的内容，可以使用淘豆网的站内搜索功能，选择自己适合的文档，以下文字是截取该文章内的部分文字，如需要获得完整电子版，请下载此文档到您的设备，方便您编辑和打印。这种材料面向开发人员,他们在TeklaOpenAPI方面的经验很少。这包括
具有一定量指导的练****但是没有太多自动学****和比较新颖的东西。
1TeklaStructures的TeklaOpenAPI的自学材料
练****的目的和结构
这种自学材料包含练****以帮助您学****和实践TeklaOpenAPI的基本概念。
想要覆盖开发人员可能面临的问题都是不可能的,因此特地介绍了一些典型的例
子。熟悉API后,您可以为其他情况开发自己的应用程序。
这个练****分为几个较小的练****一个创建小建筑物的应用程序,然后从那里
生成图纸。练****包含一些建模和图纸的练****还包括对话框的使用。
在每次练****中,您将在TeklaStructures中看到最终结果的图像,您也可
以获取示例代码。下一个练****开始时可以使用相同的示例代码。如果你自己的代
码太不一样以至于无法轻松地继续练****你可以使用示例代码库。
参考手册
在开始练****之前,强烈建议您阅读OpenAPI的参考手册。参考手册包含在
OpenAPI启动包中。
参考手册是使用API构建新软件时非常宝贵的资源。关于如何使用不同的对
象和方法有很多很好的例子。这些练****中应使用参考手册。
以下章节包括自学API的练****在第章中,有关如何在MicrosoftVisual
Studio2010中设置新项目以及如何使用API的练****建模和对话练****在第2章
介绍,绘图练****在第3章中介绍。
在VisualStudio中创建一个新项目
您将学****在项目中使用API所需要做的工作。
前提:当您要测试您的应用程序时,您需要运行TeklaStructures并打开
模型,最好是空模型。
。
第一步是启动MicrosoftVisualStudio2010并从文件菜单创建一个新项
目(新建->项目)。
填写屏幕截图所示的详细信息,然后按OK创建一个空的Windows应用程序。
添加对API程序集的引用。
创建项目后,您需要添加对TeklaOpenAPI程序集的引用,如和。添加这
些引用将使您能够使用这些程序集中包含的对象。
要添加引用,您可以右键单击解决方案资源管理器中的引用,然后从弹出菜
单中选择添加引用,也可以从项目菜单中选择添加引用。
单击添加引用菜单中的浏览,以找到和文件。您将在TeklaStructures
安装文件夹\nt\bin\plugins\文件夹中找到这些文件。找到它们之后,请选择它
们并选择打开,然后在添加引用对话框中按确定。
在练****中,您将需要这些参考:
(从\nt\bin\dialogs\找到)
如果要为TeklaStructures中创建一个插件,那么您需要添加。
接来下您可以在项目中使用API的类和方法。
将指令添加到API程序集的命名空间。
查看的代码(右键单击表单并选择查看代码),并将指令行添加到代码的开
头:
usingusingTSG3D=现在您可以使用API开始开发应用程序了。
2建模API的练****br/>以下是建模练****的主题:
(第章)在VisualStudio中创建一个新的项目
(第章)创建垫脚
(第章)在底座上添加列
(第章)将钢筋添加到垫脚上
(第章)使用目录UI控件
(第章)添加模板表单
创建垫脚
您将学****如何通过API在TeklaStructures中创建基本对象。
这个练****结果应该是这样的:
前提
您需要运行TeklaStructures并打开一个空模型。使用此模型,以便网格
间距与示例中使用的相同:
(\TeklaOpenAPIStartUpPackage_v190\SelfLearningExercises\)
请记住阅读该页面上的提示。从第章阅读并学****关于在MicrosoftVisual
Studio中创建新项目。
创建创建垫脚的应用程序
在应用程序表单中添加一个按钮“创建垫脚”,并将脚注创建点击事件。在
网格线A,E,1和6上的每个网格交点上创建垫脚。因此,总共创建18个垫脚。
提示:
可以使用梁类创建垫脚。
您应该创建一个方法,根据给出的坐标位置创建一个垫脚。
然后,您可以使用for循环创建垫脚的位置。
创建Model实例后,通过调用()来检查连接是否有效。如果返回true,
那么可以使用API。
帮助:
请参阅参考手册中的至少以下主题:
Beamclass梁类
说明:
关于代码应该做的简要说明:
,该对象表示您在TeklaStructures中打开的
TeklaStructures模型。
。
。垫脚应该设置
以下属性:
Name="FOOTING"
="1500*1500"
="K30-2"
Class="8"
StartPoint
EndPoint(changeZcoordinatemmlowerthaninstartpoint)
===请注意,这些值可能需要本地化,需要在环境中找到配置文件和
材料。
,并使用步骤3中提到的方法
创建垫脚。
()确保在TeklaStructures中更新已完成的所有更改,
并相应更新模型视图。如果未调用此命令,则必须在TeklaStructures中手动
刷新视图以查看更改。
完成之后,您需要做的就是确保您已经打开了TeklaStructures模型,并
选择“从VisualStudio中的”调试“菜单开始运行您的项目。您现在将出现
带有“创建垫脚”按钮的窗体,并按压它将垫脚放置在模型的网格交叉点。
此练****的示例解决方案可以从“练****练****文件夹下的OpenAPI启动包中
找到。
(..\TeklaOpenAPIStartUpPackage_v190\自学****练****br/>在垫脚的顶部创建柱,并将柱连接到垫脚
您将学****如何创建与模型的连接。
结果应该是这样的:
前提
您需要运行TeklaStructures并打开一个空模型。你还需要第一个练****中
的代码;你可以从下面的链接中获得它。
上一次练****的示例解决方案
帮助:
请参阅参考手册中的至少以下主题:
Beamclass梁类
Connectionclass连接类
在每个垫脚的顶部创建柱,并将其与加固的底板连接(1014)
修改上一个练****以便添加两种方法,一种用于在衬垫底座上添加柱,另一
种用于在垫脚和柱之间添加加固的底板(1014)。您需要返回插入的垫脚和列,
然后将它们提供给创建这些连接的方法(您也可以为代码使用其他架构)。
说明:
(Beam类)的方法。
,加固底板(1014)将柱连接到垫脚上;使用柱作为主要部分。
对柱使用这些值(记住要定位所需的值)
Name="Column";
="HEA400";
="S235JR";
Class="2";
=;
===使用此属性用于加固的底板以实现锚杆:
SetAttribute("cut",1)
LoadAttributesFromFile("standard")
UpVector=newVector(0,0,1000)
关于“剪切”属性的注释。它是TeklaStructures中的一个选项菜单,它
。
另请注意,由于历史原因,选项菜单返回的值为:
第一个值(通常为0)表示内部空值
第二个值(通常为1)表示值0
第三个值(通常为2)表示值1。
这就是为什么你需要将该属性设置为1,。
本练****的示例解决方案可以从练****2-2中的OpenAPI启动包中找到。
创建钢筋底座的钢筋
您将学****如何从模型中选择对象,然后使用枚举器循环遍历这些对象。
结果应该是这样的:
前提:
您需要运行TeklaStructures并打开模型,最好是空模型。
您还需要练****的源代码。
上一次练****的示例解决方案
(..\TeklaOpenAPIStartUpPackage_v190\自学****练****列)
帮助:
请参阅参考手册中的至少以下主题:
ReinforcementandRebarGroupclasses
PolygonandPointclasses多边形和点类
说明:
。在对话框中创建一个字段以供用户给出基准的大
小。
,使用以下方法创建钢筋。
(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/>使用目录UI控件
API包含用于配置文件目录,钢筋目录和网格目录的窗体对话框,以帮助具
有窗体并且需要在UI中提供示例配置文件选择的应用程序(和插件)的开发人
员。现在,您将学****如何使用现成的自定义用户界面控件从TeklaStructures
中的目录中选择配置文件和网格。
您还将学****如何通过目录枚举并自定义对话框中显示的项目列表。
此练****后,您的应用程序可能看起来像这样:
前提
您需要运行TeklaStructures并打开模型,最好是空模型。
您还需要练****的源代码。
将用户界面控件添加到VisualStudio的工具箱中:
有两种方法可以将控件添加到VisualStudio的工具箱中:
右键单击工具箱,然后选择“选择项目”。然后点击浏览按钮打开。控件将
被添加到列表中。您可以选择一个控件或所有要添加到工具箱的控件。
使用Windows资源管理器导航到\ProgramFiles\TeklaStructures\
[version]\nt\bin\dialogs\,打开Designer并将dll拖放到工具
箱的“常规”选项卡中。所有的控件将被添加到工具箱。请参阅下面的快照。
帮助:
请参阅参考手册中的至少以下主题:
FormBaseclass
ProfileCatalogclass
ReinforcementCatalogClass
SaveLoadClass
说明:
,您的Form必须继承自ApplicationFormBase。
另外在Form的构造函数中必须调用
();
。为此,您可以使用名为“ProfileCatalog”的
用户界面控件。将此控件添加到窗体。您可以将控件拖放到“窗体”对话框中。
用户从对话框中选择的项目将被存储到SelectedProfile属性中。
添加一个文本框以显示所选配置文件。
当用户将配置文件键入文本框并单击“选择”按钮时,应从配置文件目录对
话框中自动选择键入的配置文件。将属性SelectedProfile设置为某个值将在对
话框打开时从对话框中选择该值(如果该值包含在目录中)。
“ReinforcementCatalog”用户界面控件,选择垫脚的钢筋。
添加三个文本框以显示所选钢筋的尺寸,坡度和弯曲半径。使用这些文本框
的值也可以在对话框打开时选择加强编录对话框中的值。
。
钢筋弯曲半径可以在目录中具有几个值,例如。“2040”,所以这些值需要
由应用程序处理。因此,我们不像以前那样在代码中定义半径值
我们可以询问用户的值:
char[]Separator={''};
string[]Radiuses=
IteminRadiuses)
“SaveLoad”控件添加到窗体。
只有绑定到某些属性的控件的值将被保存,这意味着它们具有
“AttributeName”和“AttributeTypeName”。要设置它们,打开VisualStudio
设计视图,然后转到“属性”选项卡。AttributeName和AttributeTypeName位
于标题TeklaStructures下:
AttributeName是您标识控件的名称。
AttributeTypeName是控件内容的的名称。可能的AttributeTypeNames是
Boolean,Distance,DistanceListString,Integer和Double。
提示:
当使用用户界面控件“ProfileCatalog”和“ReinforcementCatalog”时,
请记住为事件“SelectClicked”和“SelectionDone”创建回调。
修改两个对话框的SelectClicked回调。当用户单击您的窗体中的选择按钮
时,会引发SelectClicked事件。修改回调,以便根据Form中的值设置
SelectedProfile,SelectedRebarGrade,SelectedRebarSize和
SelectedBendingRadius的值,例如:
=;
当配置文件或钢筋选择对话框关闭时,会引发SelectionDone事件。要更新
表单中显示的文本,请使用SetAttributeValue()方法和SelectedProfile,
SelectedRebarGrade,SelectedRebarSize和SelectedBendingRadius属性中存
储的值。例如:
SetAttributeValue(ColumnsProfileTextBox,;
要替换硬编码值,您需要使用在文本框中定义的值。例如:
=;
此练****的示例解决方案可以从练****练****UIControls文件夹下的Open
API启动包中找到。
添加模板表单
您将学****如何使用命名空间中可用的一些继承的表单。这些继承的表单可以
用作一些最常见的TeklaStructures对话框的模板。
可用表单为:
CommitAction
CreateDialog
OrganizerDialog
PropertiesDialog
TreeViewDialog