Home > PCB_PrimitiveRegion > getAll

PCB_PrimitiveRegion.getAll() method

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

获取所有区域

签名

public getAll(layer?: TPCB_LayersOfRegion, ruleType?: Array<EPCB_PrimitiveRegionRuleType>, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveRegion>>;

参数名

参数	类型	描述
layer	TPCB_LayersOfRegion	（可选） 层
ruleType	Array<EPCB_PrimitiveRegionRuleType>	（可选） 区域规则类型，只会匹配所有规则类型均一致的图元
primitiveLock	boolean	（可选） 是否锁定

返回值

Promise<Array<IPCB_PrimitiveRegion>>

区域图元对象数组

示例

// 1. 创建一个顶层测试区域作为过滤目标：规则 [2] 即禁止元件（随机坐标避免重合）
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 region = await eda.pcb_PrimitiveRegion.create(1, polygon, [2], '嘉立创示例_过滤目标');
const regionId = region.getState_PrimitiveId();

// 2. 不带参数：获取 PCB 上全部区域
const all = await eda.pcb_PrimitiveRegion.getAll();

// 3. 按层过滤：只取顶层（1）的区域
const topLayer = await eda.pcb_PrimitiveRegion.getAll(1);

// 4. 按规则类型过滤：只取规则为 [2]（禁止元件）的区域，要求规则完全一致
const noComponents = await eda.pcb_PrimitiveRegion.getAll(undefined, [2]);

// 5. 清理测试图元（查询类需要清理）
await eda.pcb_PrimitiveRegion.delete([regionId]);

console.log('total regions:', all.length);
console.log('top layer regions:', topLayer.length);
console.log('no-component regions:', noComponents.length);
console.log('marker region found:', noComponents.some(r => r.getState_PrimitiveId() === regionId));