Home > PCB_Layer > modifyLayer

PCB_Layer.modifyLayer() method

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

修改图层属性

签名

function modifyLayer(
	layer: TPCB_LayersInTheSelectable,
	property: {
		name?: undefined | string;
		type?: undefined | EPCB_LayerType.SIGNAL | EPCB_LayerType.INTERNAL_ELECTRICAL;
		color?: undefined | string;
		transparency?: undefined | number;
	},
): Promise<boolean>;

参数名

参数	类型	描述
layer	TPCB_LayersInTheSelectable	层
property	{ name?: undefined | string; type?: undefined | EPCB_LayerType.SIGNAL | EPCB_LayerType.INTERNAL_ELECTRICAL; color?: undefined | string; transparency?: undefined | number }	属性

返回值

Promise<boolean>

修改后的图层属性，如若为 undefined 则代表修改失败或图层不存在

备注

仅内层和自定义层允许修改名称；仅内层允许修改类型, 透明度仅支持0-100之间的数

示例

// 1. 新增一个自定义层作为修改对象
const customLayerId = await eda.pcb_Layer.addCustomLayer();

// 2. 读取修改前的名称与颜色
const before = (await eda.pcb_Layer.getAllLayers()).find(l => l.id === customLayerId);

// 3. 修改名称、颜色与透明度（保留现场供观察）
const modifyResult = await eda.pcb_Layer.modifyLayer(customLayerId, {
	name: '嘉立创示例_工艺说明',
	color: '#FF6600',
	transparency: 30,
});

// 4. 重新读取图层列表确认修改生效
const after = (await eda.pcb_Layer.getAllLayers()).find(l => l.id === customLayerId);

console.log('modifyResult:', modifyResult);
console.log('nameBefore:', before?.name, '→ nameAfter:', after?.name);
console.log('colorBefore:', before?.color, '→ colorAfter:', after?.color);