Home > ISCH_PrimitivePin > done

ISCH_PrimitivePin.done() method

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

将对图元的更改应用到画布

签名

public done(): Promise<ISCH_PrimitivePin>;

返回值

Promise<ISCH_PrimitivePin>

引脚图元对象

示例

// 0. 确保当前文档是符号编辑器：优先复用测试符号，没有则新建后打开
const libUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
const found = await eda.lib_Symbol.search('嘉立创示例_Pin测试符号', libUuid);
const symUuid = found[0] ? found[0].uuid : await eda.lib_Symbol.create(libUuid, '嘉立创示例_Pin测试符号');
await eda.lib_Symbol.openInEditor(symUuid, libUuid);

// 1. 生成本次运行专用的坐标，避免与之前保留的测试引脚重合
const x = 2000 + Math.floor(Math.random() * 8000);
const y = 2000 + Math.floor(Math.random() * 8000);

// 2. 在符号画布上创建一个测试引脚
const pin = await eda.sch_PrimitivePin.create(x, y, '1', 'CLK', 0, 10, null, 'None', 'IN');

// 3. 异步模式下连续修改编号和名称（此时画布尚未变化）
const asyncPin = pin.toAsync();
asyncPin.setState_PinNumber('A1');
asyncPin.setState_PinName('SYS_CLK');

// 4. done() 一次性提交两处修改
const applied = await asyncPin.done();

// 5. 从画布重新取引脚，确认修改已生效（保留现场供观察）
const refetched = await eda.sch_PrimitivePin.get(pin.getState_PrimitiveId());

console.log('applied number:', refetched.getState_PinNumber());
console.log('applied name:', refetched.getState_PinName());
console.log('done returns same primitive:', applied.getState_PrimitiveId() === pin.getState_PrimitiveId());