Home > PCB_SelectControl > doSelectPrimitives

PCB_SelectControl.doSelectPrimitives() method

此 API 当前处于 BETA 预览状态，希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改，请不要将它用于任何正式环境。

使用图元 ID 选中图元

签名

function doSelectPrimitives(primitiveIds: string | Array<string>): Promise<boolean>;

参数名

参数	类型	描述
primitiveIds	string | Array<string>	图元 ID

返回值

Promise<boolean>

操作是否成功

示例

// 1. 创建测试焊盘
const pad = await eda.pcb_PrimitivePad.create(1, '1', 2000, 2000, 0, ['ELLIPSE', 60, 60], '', null, 0, 0, 0, false, 0);
const padId = pad.getState_PrimitiveId();

// 2. 用图元 ID 选中焊盘
const selected = await eda.pcb_SelectControl.doSelectPrimitives([padId]);
console.log('selected:', selected);

// 3. 确认焊盘已在选中集里
const selectedIds = await eda.pcb_SelectControl.getAllSelectedPrimitives_PrimitiveId();
console.log('选中数量：', selectedIds.length);
console.log('包含测试焊盘：', selectedIds.includes(padId));

// 4. 清理：清除选中并删除测试图元
await eda.pcb_SelectControl.clearSelected();
await eda.pcb_PrimitivePad.delete([padId]);