Home > IPCB_PrimitivePad > setState_Hole

IPCB_PrimitivePad.setState_Hole() method

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

设置属性状态：孔

签名

function setState_Hole(hole: TPCB_PrimitivePadHole): IPCB_PrimitivePad;

参数名

参数	类型	描述
hole	TPCB_PrimitivePadHole	焊盘钻孔

返回值

IPCB_PrimitivePad

焊盘图元对象

备注

设置孔时将会联动设置部分其它属性状态：

1. 层将会强制切换到多层

本接口无法将孔设置为 null，如果想要移除孔属性，请使用 setState_Layer 方法切换层为顶层或底层

示例

// 1. 生成本次运行专用的坐标，创建一个无孔的贴片焊盘
const x = 3000 + Math.floor(Math.random() * 100000);
const pad = await eda.pcb_PrimitivePad.create(1, '1', x, 3000, 0, ['ELLIPSE', 80, 80], '', null, 0, 0, 0, false, 0);
const beforeHole = pad.getState_Hole();

// 2. 异步模式下设置 35mil 圆孔并提交
const a = pad.toAsync();
a.setState_Hole(['ROUND', 35]);
await a.done();

// 3. 从画布重新读取，确认孔已生效且层被联动切到多层（保留现场供观察）
const ref = await eda.pcb_PrimitivePad.get(pad.getState_PrimitiveId());

console.log('hole:', beforeHole, '→', ref.getState_Hole());
console.log('layer:', ref.getState_Layer());