要说这好记性,真是不如烂笔头,时间一长,不常用的知识,很容易就忘掉了,所以打算抽时间把一些API方面的知识做个总结,既能帮助自己,也能让刚入门的小伙伴少走些弯路。
以往章节传送门:
 
本节主要总结EPLAN中有关设置的类。分如下章节:
  1. 设置的类别
  2. 各类别设置所对应的类
  3. 示例1:读取用户设置项
  4. 示例2:读取项目设置项
  5. 示例3:设置项目配置项
  6. 示例4:新建用户设置项
一、设置的类别
“设置”是用于在程序运行时保存变量的值,并在下次程序运行时再次可用(类似于 Windows 注册表),EPLAN 中创建了一个设置数据库来存储这些设置,例如使用的字体、颜色等等,每一个设置项在系统中都具有唯一的设置路径。
设置共分为4个类别,如下图黄色标记。
  • 项目设置:这些设置独立于用户或工作站,它们存储在一个项目中。
  • 用户设置:例如工具栏和对话框的尺寸和位置。这些设置通常也保存在中央服务器上,以使用户能够在另一个工作站上使用他自己的设置。
  • 工作站设置:这些设置适用于一台计算机,保存在本地硬盘上。
  • 公司设置:常位于服务器上,并且对于整个公司应该是相同的。
二、各类别设置所对应的类
针对以上4个类别,有如下几种类来进行操作:
  • Settings – 用于读取、写入和创建用户、公司或工作站设置的功能。
    • https://www.eplan.help/en-US/infoportal/content/api/2.9/Eplan.EplApi.Baseu~Eplan.EplApi.Base.Settings.html
  • ProjectSettings – 用于读取、写入和创建项目相关设置的函数。
    • https://www.eplan.help/en-US/infoportal/content/api/2.9/Eplan.EplApi.DataModelu~Eplan.EplApi.DataModel.ProjectSettings.html
  • SettingNode – 用于管理设置层次结构的功能(仅限用户、公司或工作站)
    • https://www.eplan.help/en-US/infoportal/content/api/2.9/Eplan.EplApi.Baseu~Eplan.EplApi.Base.SettingNode.html
  • SchemeSetting – 用于管理设置组(配置方案)的功能。仅适用于用户、公司或工作站设置。
    • https://www.eplan.help/en-US/infoportal/content/api/2.9/Eplan.EplApi.Baseu~Eplan.EplApi.Base.SchemeSetting.html
  • ProjectSchemeSetting – 与 SchemeSetting 相同,但用于项目设置。
    • https://www.eplan.help/en-US/infoportal/content/api/2.9/Eplan.EplApi.DataModelu~Eplan.EplApi.DataModel.ProjectSchemeSetting.html
  • ProjectSettingNode – 与 SettingNode 相同,但用于项目设置。
    • https://www.eplan.help/en-US/infoportal/content/api/2.9/Eplan.EplApi.DataModelu~Eplan.EplApi.DataModel.ProjectSettingNode.html
以上各类实现了读取或修改某个设置项的方法,例如读取字符串类型的项时是用GetStringSetting(),设置字符串类型的项时是用SetStringSetting(),同理还有各种不同类型的设置方法如:SetBoolSetting()、GetNumbericSetting()等等。
三、示例1:读取用户设置项
读取当前对话框语言:设置-用户-显示-语言。

string strGuiLanguage = new Settings().GetStringSetting("USER.SYSTEM.GUI.LANGUAGE", 0);
new Decider().Decide(EnumDecisionType.eOkDecision, "当前的对话框语言: " + strGuiLanguage, "", EnumDecisionReturn.eOK, EnumDecisionReturn.eOK);
分别对上述两个方法做介绍:
GetStringSetting(string strSettingPathint nIdx)
读取设置的值,如果读取的设置没有此索引的值,则返回默认值,索引从 0 开始。
strSettingPath:设置的路径
nId:索引
本节开头处我们讲过,每一个设置项都有一个唯一的设置路径,那如何读取对应项的路径呢?有两个办法:
此处内容需要权限查看

您还没有获得查看权限包年VIP终身VIP可免费查看

升级VIP免费查看
好了,有关设置的的API总结就先到这里,电气CAD吧可向终身会员用户提供技术咨询服务,有哪里不懂的用户可以随联系我们!下节见。

发表评论

登录... 后才能评论