DgnElementSetTool 使用文档

本文主要总结 DgnElementSetTool 的触发逻辑,同时介绍其中的参数设置。

简介

DgnElementSetTool 主要用于实现对元素的修改

基本的工具操作是从激活的围栅、选择集或用户选择来填充 ElementAgenda。 然后调用 OnElementModify 来处理。

继承关系

image-20220522105109562

基本概念

什么是 ElementAgenda?

ElementAgenda 是 Microstation 从元素源(包含激活的围栅、选择集或用户选择)创建的一个引用集合。

加载和资源释放

本类中重新实现了 OnReinitialize,它将 Tool 的状态重置为初始状态,这样就可以不用重新启动一个新的 Tool。

它在 OnModifyComplete 中被调用。

动态显示

除了 DgnPrimitiveTool 提供的动态显示事件回调外,本类还额外提供了其它函数进行控制。

名称 作用 类型
WantDynamics 当 ElementAgenda 有值后,判断是否启用动态显示 事件回调

重绘接口实现

重绘接口主要负责元素的重绘显示逻辑,在开发中一般不需要修改,此处不作详细研究。

名称 作用 类型
OnRedrawInit 重绘初始化:访问元素之前调用,用来设置哪些 Elements 可以被绘制 事件回调
OnRedrawOperation 可以修改每个元素的显示 事件回调
OnResymbolize 工具可以重写元素显示的符号 事件回调
OnRedrawComplete 在重绘结束,访问元素之前调用 事件回调