Home > PCB_Net > setNetColor

PCB_Net.setNetColor() method

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

设置指定网络的颜色

签名

function setNetColor(net: string, color: IPCB_NetInfo['color']): Promise<boolean>;

参数名

参数	类型	描述
net	string	网络名称
color	IPCB_NetInfo['color']	网络颜色

返回值

Promise<boolean>

是否设置成功, false 为不存在该网络

示例

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

// 2. 记录修改前的颜色
const before = await eda.pcb_Net.getNetColor('嘉立创示例_NET1');

// 3. 将网络设置为红色（修改类保留现场，便于在画布上观察效果）
const colorSet = await eda.pcb_Net.setNetColor('嘉立创示例_NET1', { r: 255, g: 0, b: 0, alpha: 1 });

// 4. 重新读取颜色，验证修改已生效
const after = await eda.pcb_Net.getNetColor('嘉立创示例_NET1');

console.log('colorSet:', colorSet);
console.log('before:', before);
console.log('after:', after);