出品丨电气CAD吧 https://www.cad-bbs.cn/eplanapi-14/

要说这好记性,真是不如烂笔头,时间一长,不常用的知识,很容易就忘掉了,所以打算抽时间把一些API方面的知识做个总结,既能帮助自己,也能让刚入门的小伙伴少走些弯路。
以往章节查看方法是将网址结尾数字依次修改:
https://www.cad-bbs.cn/eplanapi-1/
以上三节中我们分享了有关部件创建和管理相关的API ,本节将主要归纳翻译项目数据的一些常用命令。
类:public class Translate

继承:Eplan.EplApi.HEServices.Translate

一. Translate API帮助

Translate Class (eplan.help)

二. 常用公共方法:

1. 增加语言到项目中

bool AddProjectLanguage( Project oProjectstring strLanguage )

增加语言到当前项目中,对应的功能如下图所示,需要注意的是,方法中第2个参数必须是下拉框中的语种字符串,如果是多个语种的话,可以以分号分隔来拼接字符串。

2. 更改已翻译的文本

public void Correct( 
   Project oProject,
   bool bConvertAlreadyTranslatedTexts
)

更改已翻译的文本对应选项中-项目-翻译-常规中的设置(见下图),如果有效时,将会在执行翻译时,重新对已翻译过的文本进行翻译。

3. 导出数据库文本

publicbool ExportDatabaseTexts( 
   string strFilename,
   string strConverter //格式转换器
)

在翻译数据库里,导出项目所包含的所有语言文本到指定文件。需要注意第2个参数格式转换器,为空时将是默认XML格式转换器。所包含的所有转换器字符串为:

  • XML格式

XTrLanguageDbXmlConverterImpl

  • .tf_或TXT格式(EPLAN 5可支持)改后缀为csv便可EXCEL打开,但不支持中文

XTrLanguageDbXml2E21UnicodeTabConverter

  • TXT格式

XTrLanguageDbXml2TabConverterImpl

EPLAN中对应的操作如下图:

4. 导出缺失的词条列表

public void ExportMissingTranslation( 
   string strFilename,
   string strConverter,//转换器
   StringCollection listLanguages,//语种集合
   string strProjectName
)

导出项目中指定语种的缺失词条,转换器同上3,EPLAN中对应的操作如下:

5. 导入数据文本的方法

public bool ImportDatabaseTexts( 
   string strFilename,//文件地址
   string strConverter,//格式转换器
   string strReferenceLanguage //用分号分隔的语言代码列表。
)

转换器同上3,第3个参数为:用分号分隔的语言代码列表。(例如:en_US;de_DE)EPLAN中对应的操作如下:

6. 导入项目文本到数据库

public bool ImportProjectTexts( 
   Project pProject,
   StringCollection listLanguages,
   bool bOverwrite
)

将文本从项目导入进数据库的方法,EPLAN中对应的操作如下:

7. 删除项目语言

public bool RemoveProjectLanguage( 
   Project pProject,
   string strLanguage
)

将从项目中删除指定的语言,EPLAN中对应的操作如下:

8. 设置显示语言

public bool SetDisplayedLanguages( 
   Project pProject,
   string strLanguage
)

设备项目中显示的语言,strLanguage可是分号分隔的多个语种,EPLAN中对应的操作如下:

9. 翻译对象

执行翻译命令,可翻译的对象有:

//翻译可存储对象类数组
public bool TranslateObjects(
   StorableObject[] storableObjects
)

//翻译页
public void TranslatePage( 
   string strProjectName,
   string strPage
)

//翻译项目
public void TranslateProject( 
   string strProjectName
)

//翻译文本
public MultiLangString TranslateText( 
  string strText,
   Project oProject
)

设备项目中显示的语言,strLanguage可是分号分隔的多个语种,EPLAN中对应的操作如下:

以上便是有关翻译操作相关常用到的API命令,本节就介绍到这里,电气CAD吧可向终身会员提供技术咨询服务,有哪里不懂的用户可以随联系我们!下节见。

发表评论

登录... 后才能评论

评论(2)