Home > PCB_Net > getAllPrimitivesByNet

PCB_Net.getAllPrimitivesByNet() method

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

获取关联指定网络的所有图元

签名

function getAllPrimitivesByNet(
	net: string,
	primitiveTypes?: Array<EPCB_PrimitiveType>,
): Promise<Array<IPCB_Primitive>>;

参数名

参数	类型	描述
net	string	网络名称
primitiveTypes	Array<EPCB_PrimitiveType>	（可选） 图元类型数组，如若指定图元类型不存在网络属性，返回的数据将恒为空

返回值

Promise<Array<IPCB_Primitive>>

图元对象数组

示例

// 1. 创建带网络名的过孔，让 PCB 中出现可查询的网络
const via = await eda.pcb_PrimitiveVia.create('嘉立创示例_NET1', 2000, 2000, 20, 40);

// 2. 获取该网络关联的全部图元
const primitives = await eda.pcb_Net.getAllPrimitivesByNet('嘉立创示例_NET1');

// 3. 查看图元数据对象的典型字段（pcbItemPrimitiveType 为图元类型名称）
const first = primitives[0];

// 4. 清理测试图元（查询类需要清理）
await eda.pcb_PrimitiveVia.delete([via.getState_PrimitiveId()]);

console.log('primitiveCount:', primitives.length);
console.log('firstItemPrimitiveType:', first?.pcbItemPrimitiveType);
console.log('firstNet:', first?.net);
console.log('firstCenter:', first?.center);