mxcad_2d API 文档 / 2d / MxModifyColor

Class: MxModifyColor

2d.MxModifyColor

MxModifyColor 用于临时修改 CAD 对象的显示颜色。

Description

该类不会改变对象本身属性，而是通过临时显示方式批量修改对象颜色，适用于差异标注、审图预览、效果展示等场景。 它可以快速应用颜色变更并随后恢复原始显示状态。 使用方法总结：

1. 创建 MxModifyColor 实例；
2. 调用 Do(database, color) 执行颜色修改；
3. 需要恢复时调用 DoRestore()。

Example

// 临时修改所有对象的颜色为白色，再次调用恢复原始颜色。
import { MxCpp, McCmColor, ColorIndexType } from "mxcad";

  let modify: any;

  function Mx_Test_ModifyAllEntityColor() {
       if (modify) {
           modify.DoRestore();
           modify = undefined;
       }
       else {
           modify = new MxModifyColor();
           let color = new McCmColor();
           color.setColorIndex(ColorIndexType.kWhite);
           modify.Do(MxCpp.getCurrentDatabase(), color);
       }
  }

Table of contents

Constructors

• constructor

Methods

• Do
• DoRestore

Constructors

constructor

• new MxModifyColor()

Methods

Do

▸ Do(database, color): boolean

修改指定数据库中对象的显示颜色。

Parameters

Name	Type	Description
database	McDbDatabase	目标数据库。
color	McCmColor	目标颜色。

Returns

boolean

是否成功执行修改。

---

DoRestore

▸ DoRestore(): void

恢复之前被临时修改的对象颜色。

Returns

void