针对 EPLAN 平台的产品提供统一、性能优良的编程接口(API, Application Programming Interface,应用程序接口)。通过此扩展(EPLAN API)可与 EPLAN 或其它合作伙伴合作开发为您量身定制的解决方案。有关 EPLAN API 和 EADN 的更多信息,请参阅 EPLAN 网页中的"解决方案 > Integration > EPLAN Application Developer Network"栏目。下面一节将向您介绍在 EPLAN API 中的不同更新。为了可以通过新版本的 EPLAN API 开发自己的应用该程序,需要具备 Microsoft 的 .NET Framework 4.7.2。
说明:
-
"EPLAN API Extension" 在我们的 EPLAN Application Developer Network (EADN) 中可作为开发包购买,也可以针对各种程序作为可选的付费获得许可。
- 我们建议每位 API 用户,及早通过新版本的 EPLAN API 汇编和测试自己的应用程序。如果仍在应用程序中使用过时的方法,汇编时会为此显示一条相应的程序编译器警告。
在导入 DXF 文件时自动缩放
借助 EPLAN API,现在也可以在导入时自动缩放 文件。为此,对于 DXFPage 方法可使用新 DrawingLimits。
安装点的新方案
在 Mate 类别中,可使用代表特定的两种新类别 GridMate 和 LineMate。
读取电缆每根芯线的源和目标
借助新方法 GetSourcesAndTargets(在 Cable 类别中),可以为确定有关的源和目标的信息。
替换项目中的文本
通过新方法 Replace(属于 Search 类别),现在可以将一个的字词替换为其它字词。
插入 3D 窗口宏的新方法
在 Insert3D 类别中,现在可使用 WindowMacro 方法的一个新变量。由此可以将基准点到另一个的特定安装点。
确定特定类型的所有对象
已为 DMObjectsFinder 类别扩展了新方法 GetAll。借此可确定特定的所有对象。
用于在部件管理中创建用户自定义的属性的新类别
借助新类别 MDUserDefinedPropertyDefinition,可以为管理的。就此另请参阅"用户自定义的属性的扩展"章节。
"ExportNCData"操作的其它格式
对于通过 ExportNCData 导出 NC 数据,现在还可以使用"铜件 NC"、"铜件 DXF"和"铜件折弯"。
以当前的界面语言读取对象名称
使用新方法 GetTypeName,可以用当前的界面语言读取对象类型的。
生成母线的新方法
在 BusBar 类别中,存在有 Create 方法的新重载,可以通过简单的方式。
用于在部件管理中读取数据库版本的新属性
若要在部件管理中读取数据库版本,可以在 MDPartsDatabase 类别中使用新的 Version 属性。
用于读取标识字母的新属性
若要读取标识字母,可以在 FunctionDefinitionLibrary 类别中使用新的 IdentifierSets 属性。借此可以读取标识符集的名称。
此外,在 FunctionDefinition 类别中还存在新的 Identifiers 属性,通过该属性可以确定所有标识字母(适用于所有可用标准)。
查找和替换层的新方法
在 EPLAN 平台中,现在可以查找所使用的用户自定义的并将其替换(参见"层管理插件"章节)。为此,在 GraphicalLayerTable 类别中现在提供有用于使用层管理的新方法。
注册/注销插件的新操作
若要注册/注销插件,可使用 XSettingsRegisterAction 和 XSettingsUnregisterAction 这两个新操作。
确定安装点的新方法
在 SelectionSet 类别中,现在可通过新方法 Mates 确定当前在 3D 图形或中选择的安装点。
通过"projectmanagement"操作读取目录
projectmanagement
操作已进行了扩展。通过新参数值 /TYPE:LOADDIRECTORY 以及参数 /PROJECTSDIRECTORY 和 /SCANSUBDIRECTORIES,现在可以从项目管理中通过的命令行调用或通过 EPLAN API 执行读取目录。
在带有操作的脚本中访问 "ActionCallingContext"
如果在脚本中借助特性 [DeclareAction] 提供自己的操作,则现在也可以将整个 ActionCallingContext 用作处理方法的参数。
确定 3D 部件放置的所有角点的坐标
在 Placement3D 类别中,现在存在新的 Corners 属性。借助此属性,可以确定 3D 的所有角点的绝对坐标和相对坐标。
将宏边框创建为折线
借助 EPLAN API,现在也可以将创建为。通过属性 LogicalAreaSegments(MacroBox 等级中)完成折线的定义。
在预规划导航器中修改结构段的位置
通过 EPLAN API,现在可以在预规划导航器的树结构中修改(节点)的位置。为此,在 PrePlanningService 类别中存在新的方法 MoveUp 和 MoveDown。
预定义文件选择对话框的文件名
在 FileSelectDecisionContext 类别中,现在可以借助新属性 DefaultFilename 预定义文件选择对话框的文件名。
在布局空间中更新部件放置
若要借助 EPLAN API 在布局空间中更新部件,在 Placement3DService 类别中现在存在新方法 UpdatePartPlacement。
已为 "ConnectionPointPosition" 类别补充了其它属性
已为 ConnectionPointPosition 类别补充了下列属性:
-
SocketSize
-
MinTighteningTorque
-
MaxTighteningTorque
-
StrippingLength
扩展操作 "XPamsDeviceSelectionAction"
XPamsDeviceSelectionAction
操作已进行了扩展。如果没有为参数 /PROJECTNAME 作任何说明,则现在使用所选的项目。在此更改范围内,还调整了参数 /Mode。
- 使用值 selectDevice 为现有对象选择一个新。现在,此时将删除包括数据在内的所有设备数据,并根据设备选择重新进行分配。
- 值 updateDevice 仅更新现有对象部件的设备数据。此时保留部件编号和部件参考数据。该功能对应于导航器中新的更新设备数据弹出菜单项。
在宏导航器中确定当前选择
现在,可以通过 EPLAN API 在导航器中确定当前选择。借助方法 Selection(SelectionSet 类别中),可以确定代表所选宏的 MacroEntry 类型对象。
校正不必翻译的文本的新方法
在 Translate 类别中,现在可使用新方法 Correct,借助该方法可以从属性中移除不必翻译的文本的翻译。在用户界面的设置:范围对话框中,这对应于校正按钮(菜单选项 > 设置 > 项目 > "项目名称" > 翻译 > 范围)。
在层管理中确定当前选择
借助新的 Layers 属性(SelectionSet 类别中),现在可以确定在新的可固定对话框层管理中当前所选的层。
导出地址空间分配
通过新方法 ExportAddressOverview(PlcService 类别中),现在可以导出 CPU 的。在用户界面的地址 / 分配列表对话框中,这对应于 [附加] 按钮下方的导出地址空间分配菜单项(菜单路径项目数据 > PLC > 地址 / 分配列表)。
带 3D 部件放置的结构段的快捷方式
在预规划导航器中,现在也可以将结构段与 3D 部件放置相链接。在 EPLAN API 中,这是通过 PlanningSegment 属性(Function3D 类别中)起作用的。