Home > ISCH_PrimitiveComponent > setState_Designator

ISCH_PrimitiveComponent.setState_Designator() method

This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Set the property state: designator

Signature

function setState_Designator(designator: string | undefined): ISCH_PrimitiveComponent;

Parameters

Parameter	Type	Description
designator	string | undefined	Designator

Returns

ISCH_PrimitiveComponent

Device primitive object

Example

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

// 2. 放置一个测试器件，读取自动分配的临时位号（如 C?）
const devices = await eda.lib_Device.search('C0402');
const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
const before = comp.getState_Designator();

// 3. 切换异步模式，写入正式位号后提交
const asyncComp = comp.toAsync();
asyncComp.setState_Designator('C100');
await asyncComp.done();

// 4. 从画布重新读取，确认修改已生效（保留现场供观察）
const refetched = await eda.sch_PrimitiveComponent.get(comp.getState_PrimitiveId());

console.log('designator:', before, '→', refetched.getState_Designator());