在Bentley产品开发赋能计划中,我们隆重介绍了MicroStation API案例集开源项目,在这个项目中我们为大家提供了一种全新的问题解决方式。针对MicroStation SDK中的案例内容散乱不够体系化,在MicroStationAPI案例集我们提供了:
- 使用树状图体现MicroStation API类之间的继承关系
- 对类中的方法,属性进行归类,对其功能与参数进行说明
- 可预览指定方法或类中提供的案例代码
- 可直接运行案例代码查看效果
- 可一键复制代码至剪贴板
- 可快速搜索目标方法,获得对应的代码示例
那么我们该如何使用这个“辅助神器”呢?
首先,我们要有一个Gitee账号,将整个项目克隆导本地,然后解压缩。
解压缩后,先用管理员权限打开VS,然后再打开并编译本项目,编译结果会直接存到MS目录下的mdl文件夹。直接打开sln文件,会提示编译错误,如下图所示:
编译完成后,打开Micro Station,加载编译dll文件。在key in中键入命令“project microstationapiexample run”,即可运行MS API C#中文接口案例集,如下图所示:
MS API C#中文接口案例集界面主要分为3部分,最左侧是接口树结构和继承关系,中间是方法的功能说明和参数解释,最右侧则是该方法的代码示例和详细的中文注释。
中间不仅有下拉框支持选择MS不同部分的接口,还可以使用关键字搜索快速定位到目标类。
下部的复制代码按钮支持快速复制右侧代码区域中的代码到自己的工程中。
执行代码可以在当前文件中执行右侧区域的代码示例,即时查看代码效果。中部的方法功能说明和参数解释,以及右侧代码区域的详细中文注释最大程度的帮助我们理解接口使用方法。