Home > PCB_SelectControl > doCrossProbeSelect

PCB_SelectControl.doCrossProbeSelect() method

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

进行交叉选择

签名

function doCrossProbeSelect(
	components?: Array<string>,
	pins?: Array<string>,
	nets?: Array<string>,
	highlight?: boolean,
	select?: boolean,
): Promise<boolean>;

参数名

参数	类型	描述
components	Array<string>	（可选） 器件位号
pins	Array<string>	（可选） 器件位号_引脚编号，格式为 ['U1_1', 'U1_2']
nets	Array<string>	（可选） 网络名称
highlight	boolean	（可选） 是否高亮
select	boolean	（可选） 操作是否成功

返回值

Promise<boolean>

示例

// 1. 创建 2 个挂同一网络的测试焊盘，作为交叉选择的目标
const netName = '嘉立创示例_NET';
const pad1 = await eda.pcb_PrimitivePad.create(1, '1', 2000, 2000, 0, ['ELLIPSE', 60, 60], netName, null, 0, 0, 0, false, 0);
const pad2 = await eda.pcb_PrimitivePad.create(1, '2', 3000, 2000, 0, ['ELLIPSE', 60, 60], netName, null, 0, 0, 0, false, 0);
const padIds = [pad1.getState_PrimitiveId(), pad2.getState_PrimitiveId()];

// 2. 按网络名交叉选择（highlight=true 高亮，select=true 选中）
const crossProbed = await eda.pcb_SelectControl.doCrossProbeSelect(undefined, undefined, [netName], true, true);
console.log('crossProbed:', crossProbed);

// 3. 确认该网络上的焊盘已进入选中集
const selectedIds = await eda.pcb_SelectControl.getAllSelectedPrimitives_PrimitiveId();
console.log('选中图元数量：', selectedIds.length);

// 4. 清理选中状态和测试图元
await eda.pcb_SelectControl.clearSelected();
await eda.pcb_PrimitivePad.delete(padIds);