前言
之前聊了 MxCAD 的内置命令和圆弧、多段线的绘制，图有了，接下来就是怎么选中它们。对象选择其实就两件事：一是光标底下到底是哪个对象，二是怎么把一批对象挑出来统一处理。
在 MxCAD 里，选择分两条路走：一条靠 UI 交互，点选、框选、累加都行；另一条纯代码驱动，比如全选、按 ID 或句柄直接找、按特征筛选。不管走哪条路，都能挂上同一套筛选条件，把范围锁定在特定类型或图层上。
一、两个基础概念
1.1、McObjectId：选择结果与实体之间的中间层
无论用哪种方式选择对象，最终拿到的都是一个 McObjectId（对象 ID）。它本身不携带实体的几何数据，只描述"这是数据库里的哪一个对象"。要真正操作实体，需要通过 getMcDbEntity() 从 ID 取出实体实例：
import {
MxCADUiPrEntity } from "mxcad";
const getEnt = new MxCADUiPrEntity();
getEnt.setMessage("请选择目标对象");
const entId = await getEnt.go();
if (!entId || !entId.id) return;
const ent = entId.getMcDbEntity();
if (ent) console.log("对象类型：", ent.objectName);
McObjectId 还提供了几个常用判断方法：
entId.isValid(); // ID 是否有效
entId.isNull(); // ID 是否为空
entId.isKindOf("McDbLine"); // 指向的对象是否为直线
entId.isErase(); // 指向的对象是否已被删除
后续所有选择方式，都可以理解为"得到一个或一组 McObjectId"，再通过 getMcDbEntity() 拿到实体做下一步操作。
1.2、 MxCADResbuf：筛选条件
MxCADResbuf 用来描述"哪些对象有资格被选中"。它可以挂载实体类型、图层、颜色、块名等条件，同时适用于有 UI 交互的选择和没有 UI 交互的选择。
import {
MxCADResbuf } from "mxcad";
const filter = new MxCADResbuf();
filter.AddMcDbEntityTypes("LINE,CIRCLE"); // 只允许选直线和圆
后文每种选择方式都会用到这个筛选条件，这里先建立概念，具体用法在第五节展开。
二、有 UI 交互的选择
有 UI 交互的选择都需要用户参与（或给定坐标），返回一个选择集或对象 ID，并且可以挂 MxCADResbuf 过滤。
2.1、点选
2.1.1 交互式点选：MxCADUiPrEntity
MxCADUiPrEntity 用于让用户在图纸上点选一个对象，返回对应的 McObjectId，适合"选中某个对象后继续操作"的场景，如编辑、附加属性、读取属性等。
import {
MxCADUiPrEntity } from "mxcad";
const getEnt = new MxCADUiPrEntity();
getEnt.setMessage("请选择目标对象");
const entId = await getEnt.go();
if (!entId || !entId.id) return;
const ent = entId.getMcDbEntity();
if (ent) console.log("当前对象类型：", ent.objectName);
点选结束后，还可以拿到"点在哪里选的"这个坐标，以及区分用户是选中了对象、按了回车还是输入了关键字：
const pickPt = getEnt.pickPoint(); // 拾取时的图纸坐标
const status = getEnt.getStatus(); // 操作状态
if (getEnt.isKeyWordPicked("P")) {
// 用户输入了关键字 P（如"上一个对象"）
}
2.1.2 坐标点选：pointSelect
如果坐标已经确定，不需要用户交互，可以直接用坐标在该处点选对象：
import {
MxCADSelectionSet, MxCADResbuf } from "mxcad";
const ss = new MxCADSelectionSet();
const filter = new MxCADResbuf();
filter.AddMcDbEntityTypes("TEXT,MTEXT"); // 只挑文字对象
const index = ss.pointSelect(point.x, point.y, filter);
const ent = ss.item(index).getMcDbEntity();
pointSelect 的第三个参数是筛选条件，第四个参数是拾取容差。
如果不走选择集，MxCADUtility.findEntAtPoint() 可以直接在某点取到命中的实体，返回一个 McObjectId，适合"点选即识别"的场景：
import {
MxCADUtility, MxCADResbuf, DxfCode } from "mxcad";
// 在 (x, y, z) 处查找命中的对象，-1 表示用默认拾取范围
const objId = MxCADUtility.findEntAtPoint(x, y, z, -1, null);
if (objId.isValid()) {
const ent = objId.getMcDbEntity();
console.log("命中对象：", ent?.objectName);
}
// 也可以带筛选条件，只命中直线
const filter = new MxCADResbuf([DxfCode.kEntityType, "LINE"]);
const lineId = MxCADUtility.findEntAtPoint(x, y, z, -1, filter);
2. 2 、框选
2.2.1 交互式框选：userSelect
userSelect 让用户在图纸上拉框选择，最接近桌面 CAD 中直接框选的操作：
import {
MxCADSelectionSet, MxCADResbuf } from "mxcad";
const ss = new MxCADSelectionSet();
const filter = new MxCADResbuf();
filter.AddMcDbEntityTypes("INSERT"); // 只选块参照
if (await ss.userSelect("选择要刷的目标块:", filter)) {
const ids = ss.getIds(); // 拿到全部选中的对象 ID
}
userSelect 返回一个布尔值，表示用户是否确认了选择：true 表示选中并确认，false 表示用户取消（按 Esc）或直接回车退出。
const confirmed = await ss.userSelect("选择要刷的目标块:", filter);
if (confirmed) {
// 用户确认选择：处理 ss 中已选中的对象
} else {
// 用户取消或退出
}
如果需要更细地区分结束原因，可以参考 MxCADSelectionSetStatus 枚举：kSelected（构造成功）、kNone（直接回车）、kCanceled（按 Esc 取消）、kRejected（无效关键字）、kKeyword（输入了关键字）。
框选完成后，可以调用getSelectPoint() 取回框选的两个对角点 {pt1, pt2}，也可以调用getSelectPoints() 取回整条选择框的点阵。
const {
pt1, pt2} = ss.getSelectPoint();
const points = ss.getSelectPoints();
2.2.2 程序化交叉窗选：crossingSelect
如果两个对角点已经确定，可以用 crossingSelect 直接完成框选，不需要用户交互：
ss.crossingSelect(x1, y1, x2, y2, filter);
交叉窗选对应 AutoCAD 中的"交叉 C"：框内对象和跨越框边界的对象都会被选中。这与"窗选 W"（只选完全在框内的对象）不同。
2.2.3 栅栏选：fenceSelect
栅栏选对应 AutoCAD 的 F：用户画一条折线栅栏，选中所有被栅栏穿过的对象：
if (await ss.fenceSelect("选择栅栏要穿过的对象:", filter)) {
console.log("栅栏选中：", ss.count());
}
2.3、累加选择
MxCADSelectionSet 默认 isWhileSelect = true，即循环选择：用户可以多次点选或框选，每次选择都累加进同一个选择集，直到确认结束。
const ss = new MxCADSelectionSet();
ss.isWhileSelect = true; // 循环选择：多次选择不断累加
ss.isSelectHighlight = true; // 选中对象高亮显示
// 用户连续点选，每次都往 ss 里累加；结束后：
const ids = ss.getIds();
console.log("累计选中：", ss.count());
currentSelect(filter?) 用于读取当前已选中的对象（对应 AutoCAD 的 PICKFIRST 语义），返回当前已选对象的数量：
// 读取当前已选对象数量
const n = ss.currentSelect();
// 带条件：只统计直线
const lineCount = ss.currentSelect(new MxCADResbuf([DxfCode.kEntityType, "LINE"]));
isFilterLockLayer 是一个布尔开关，控制遍历时是否跳过锁定图层上的对象，默认不跳过：
ss.isFilterLockLayer = true; // 遍历时跳过锁定图层上的对象
三、无 UI 交互的选择
无 UI 交互的选择不依赖用户操作，由代码直接驱动，适合脚本、批处理和自动化场景。
3.1、全选：allSelect
const ss = new MxCADSelectionSet();
ss.allSelect(); // 全选当前空间的所有对象
也可以带条件，只选特定类型、特定图层上的对象：
import {
DxfCode } from "mxcad";
// 只选 0 层上的直线、圆弧、圆、多段线
ss.allSelect(new MxCADResbuf([
DxfCode.kEntityType, "LINE,ARC,CIRCLE,LWPOLYLINE",
DxfCode.kLayer, "0"
]));
console.log("对象数：", ss.count());
3.2、按已知 ID 查找：McObjectId
McObjectId 的构造函数接受一个对象 ID（number 类型），可以直接由已知的 ID 还原出实体：
import {
McObjectId } from "mxcad";
const id = new McObjectId(knownId);
if (id.isValid() && !id.isNull()) {
const ent = id.getMcDbEntity();
console.log(ent?.objectName);
}
这是选择结果与后续操作之间的衔接方式：drawEntity、allSelect、getIds() 等返回的都是 McObjectId，链式调用 getMcDbEntity() 即可继续编辑。
3.3、 按已知句柄查找：handleToIdIndex
句柄（handle）是对象在数据库中的字符串标识。数据库提供"句柄 → ID"的反查方法：
import {
MxCpp } from "mxcad";
const db = MxCpp.getCurrentMxCAD().getDatabase();
const id = db.handleToIdIndex("ABCD1234"); // 句柄 → McObjectId
if (id && id.isValid()) {
const ent = id.getMcDbEntity();
console.log("句柄对应实体：", ent?.objectName);
}
反向操作是实体侧的 getHandle()，用于从实体取出句柄。ID、句柄、实体三者可以互相转换。
3.4、按实体特征查找
按实体特征查找，就是按对象自身的属性把符合条件的对象挑出来。根据特征的类型，有三种由浅入深的方式。
3.4.1 条件筛选
allSelect 配合 MxCADResbuf，用 DxfCode 指定特征维度，可以直接筛选类型、图层、颜色、块名等：
// 找 0 层上、颜色为 1、类型为直线的对象
ss.allSelect(new MxCADResbuf([
DxfCode.kEntityType, "LINE",
DxfCode.kLayer, "0",
DxfCode.kColor, 1
]));
3.4.2 遍历加属性判定
条件筛选只能覆盖类型、图层、颜色、块名这类表级特征。如果要按几何量（半径、长度、坐标）识别对象，需要全选后遍历，逐个读取实体属性做判断：
ss.allSelect(new MxCADResbuf([DxfCode.kEntityType, "CIRCLE"]));
ss.forEach((id) => {
const circle = id.getMcDbEntity();
if (circle && Math.abs(circle.radius - 50) < 1e-6) {
console.log("找到半径约 50 的圆：", circle.objectName);
}
});
3.4.3 空间边界筛选：McDbSpatialFilter
按空间边界（点集围成的区域）筛选对象，典型用途是块参照的边界裁剪：
const spatialFilter = blkRef.getSpatialFilterId().getMcDbObject();
spatialFilter.setBoundary(aryPoint); // 设置剪切边界点集
spatialFilter.setEnable(true);
四、选择结果的读取与遍历
无论用哪种方式选择，选中的对象都存放在 MxCADSelectionSet 中，通过以下方法读取：
ss.count(); // 选中对象数量
ss.item(i); // 按索引取第 i 个对象的 McObjectId
ss.getIds(); // 取全部选中对象的 McObjectId 数组
ss.forEach((id) => {
// 遍历每个选中对象
const ent = id.getMcDbEntity();
});
ss.clear(); // 清空选择集
ss.isNull(); // 判断选择集是否为空
五、筛选条件 MxCADResbuf 的完整用法
前面每种选择方式都能挂上 MxCADResbuf，这是筛选贯穿两种选择方式的关键。
5.1. 构造筛选条件
import {
MxCADResbuf, DxfCode } from "mxcad";
// 方式一：链式 add
const f1 = new MxCADResbuf();
f1.AddMcDbEntityTypes("LINE,CIRCLE");
// 方式二：构造时直接给「组码, 值」对
const f2 = new MxCADResbuf([
DxfCode.kEntityType, "LINE,ARC",
DxfCode.kLayer, "0"
]);
5.2. 可用的特征维度
DxfCode 枚举定义了筛选时可用的特征维度：
| 组码 | 含义 | 组码 | 含义 |
|---|---|---|---|
kEntityType |
实体类型 | kLayer |
图层 |
kColor |
颜色 | kBlockName |
块名 |
kExDataName |
扩展数据名 | kAppName |
XData 类型 |
实体类型值域包括：LINE、ARC、CIRCLE、LWPOLYLINE、TEXT、MTEXT、INSERT、ELLIPSE、SPLINE、POINT、LinkLine。
5.3. 同一个 filter 同时用于交互与程序化
同一个 MxCADResbuf 实例，既可以挂到有 UI 交互的选择上，也可以挂到无 UI 交互的选择上：
const filter = new MxCADResbuf([DxfCode.kEntityType, "LINE"]);
// 交互侧
const getEnt = new MxCADUiPrEntity();
getEnt.setFilter(filter); // 点选时只允许选直线
const ss = new MxCADSelectionSet();
ss.userSelect("选择直线:", filter); // 框选时只选直线
ss.allSelect(filter); // 程序化全选时也只选直线
5.4. 读取与遍历筛选条件
MxCADResbuf 也能反向读出其中的条件，便于调试或复用：
filter.GetCount(); // 条件项数量
filter.AtString(0); // 取第 0 项字符串
filter.AtDouble(1); // 取第 1 项 double
filter.AtPoint(2); // 取第 2 项点坐标
filter.AtObjectId(3); // 取第 3 项对象 ID
六、把选择接上后续操作
选择只是第一步，选中对象后要做的是编辑、改属性、删除等。下面是一个"选择 → 批量改属性"的完整小命令，展示选完之后的用法：
import {
MxCADSelectionSet, MxCADResbuf, DxfCode } from "mxcad";
async function Mx_SelectAndSetLinetype() {
const ss = new MxCADSelectionSet();
const filter = new MxCADResbuf([DxfCode.kEntityType, "LINE"]);
if (!await ss.userSelect("选择要改线型的直线:", filter)) return;
ss.forEach((id) => {
const ent = id.getMcDbEntity();
if (ent) ent.linetype = "DASHED"; // 批量改线型
});
}
七、总结
对象选择是"用户意图"与"对象数据库"之间的环节，也是所有编辑命令的前置步骤。MxCAD 中对象选择分两类：
- 有 UI 交互：点选（
MxCADUiPrEntity/pointSelect）、框选（userSelect/crossingSelect/fenceSelect）、累加选择（isWhileSelect）。 - 无 UI 交互：全选（
allSelect）、按已知 ID 查找（new McObjectId）、按已知句柄查找（handleToIdIndex）、按实体特征查找（条件筛选 / 属性遍历 /McDbSpatialFilter）。
两类选择共用同一套筛选条件 MxCADResbuf，通过 DxfCode 指定类型、图层、颜色、块名等特征维度。选中的对象统一存放在 MxCADSelectionSet 中，通过 count、item、getIds、forEach 读取，再对每个 McObjectId 调用 getMcDbEntity() 拿到实体实例做后续操作。
掌握对象选择后，就可以进入修改工具，把选中的对象真正移动、复制、旋转编辑起来。
