Home > PCB_PrimitivePour > getAll

PCB_PrimitivePour.getAll() method

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

获取所有覆铜边框图元

签名

function getAll(
	net?: string,
	layer?: TPCB_LayersOfCopper,
	primitiveLock?: boolean,
): Promise<Array<IPCB_PrimitivePour>>;

参数名

参数	类型	描述
net	string	（可选） 网络名称
layer	TPCB_LayersOfCopper	（可选） 层
primitiveLock	boolean	（可选） 是否锁定

返回值

Promise<Array<IPCB_PrimitivePour>>

覆铜边框图元对象数组

示例

// 1. 创建一条顶层测试覆铜边框作为过滤目标（随机坐标避免重合）
const x = 2000 + Math.floor(Math.random() * 100000);
const y = 2000 + Math.floor(Math.random() * 100000);
const polygon = eda.pcb_MathPolygon.createPolygon(['R', x, y, 500, 300, 0, 0]);
const pour = await eda.pcb_PrimitivePour.create('GND', 1, polygon, 'solid', false, '嘉立创示例_覆铜', 5, 10, false);
const pourId = pour.getState_PrimitiveId();

// 2. 不带参数：获取 PCB 上全部覆铜边框
const all = await eda.pcb_PrimitivePour.getAll();

// 3. 按网络和层过滤：只取 GND 网络顶层（1）的覆铜边框
const gndTop = await eda.pcb_PrimitivePour.getAll('GND', 1);

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

console.log('total pours:', all.length);
console.log('GND top layer pours:', gndTop.length);
console.log('marker pour found in GND top layer:', gndTop.some(p => p.getState_PrimitiveId() === pourId));