Home > IPCB_PrimitiveVia > setState_SolderMaskExpansion

IPCB_PrimitiveVia.setState_SolderMaskExpansion() method

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

设置属性状态：阻焊/助焊扩展

签名

function setState_SolderMaskExpansion(
	solderMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null,
): IPCB_PrimitiveVia;

参数名

参数	类型	描述
solderMaskExpansion	IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null	阻焊/助焊扩展

返回值

IPCB_PrimitiveVia

过孔图元对象

示例

// 1. 生成本次运行专用的坐标，放置一个默认扩展（遵循规则）的测试过孔
const x = 3000 + Math.floor(Math.random() * 100000);
const via = await eda.pcb_PrimitiveVia.create('', x, 3000, 20, 40);
const before = via.getState_SolderMaskExpansion();

// 2. 异步模式下自定义顶层阻焊扩展并提交
const a = via.toAsync();
a.setState_SolderMaskExpansion({ topSolderMask: 4 });
await a.done();

// 3. 从画布重新读取，确认扩展已生效（未设置的底层项返回 null）
const ref = await eda.pcb_PrimitiveVia.get(via.getState_PrimitiveId());

console.log('expansion:', before, '→', ref.getState_SolderMaskExpansion());