@windypro-rourou/dsh-eda 0.1.0 → 0.1.2

package/skill/references/classes/ISCH_PrimitiveAttribute.md

@@ -0,0 +1,2541 @@
+# ISCH\_PrimitiveAttribute class
+
+Property primitive
+
+## Signature
+
+```typescript
+class ISCH_PrimitiveAttribute implements ISCH_Primitive
+```
+**Implements:** [ISCH\_Primitive](../interfaces/ISCH_Primitive.md)
+
+## Remarks
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+</th><th>
+
+Modifiers
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[done()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Apply the changes to the primitives to the canvas
+
+</td></tr>
+<tr><td>
+
+[getState\_AlignMode()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: alignment mode
+
+</td></tr>
+<tr><td>
+
+[getState\_Bold()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: whether it is bold
+
+</td></tr>
+<tr><td>
+
+[getState\_Color()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: text color
+
+</td></tr>
+<tr><td>
+
+[getState\_FillColor()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: fill color
+
+</td></tr>
+<tr><td>
+
+[getState\_FontName()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: font name
+
+</td></tr>
+<tr><td>
+
+[getState\_FontSize()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: font size
+
+</td></tr>
+<tr><td>
+
+[getState\_Italic()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: whether it is italic
+
+</td></tr>
+<tr><td>
+
+[getState\_Key()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: key
+
+</td></tr>
+<tr><td>
+
+[getState\_KeyVisible()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: whether the key is visible
+
+</td></tr>
+<tr><td>
+
+[getState\_ParentPrimitiveId()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: parent primitive ID
+
+</td></tr>
+<tr><td>
+
+[getState\_PrimitiveId()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: primitive ID
+
+</td></tr>
+<tr><td>
+
+[getState\_PrimitiveType()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: primitive type
+
+</td></tr>
+<tr><td>
+
+[getState\_Rotation()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: rotation angle
+
+</td></tr>
+<tr><td>
+
+[getState\_UnderLine()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: whether it is underlined
+
+</td></tr>
+<tr><td>
+
+[getState\_Value()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: value
+
+</td></tr>
+<tr><td>
+
+[getState\_ValueVisible()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: whether the value is visible
+
+</td></tr>
+<tr><td>
+
+[getState\_X()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: X coordinate
+
+</td></tr>
+<tr><td>
+
+[getState\_Y()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Get the property state: Y coordinate
+
+</td></tr>
+<tr><td>
+
+[isAsync()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Query whether the primitive is an async primitive
+
+</td></tr>
+<tr><td>
+
+[reset()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Reset the async primitive to the current canvas state
+
+</td></tr>
+<tr><td>
+
+[setState\_AlignMode(alignMode)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: alignment mode
+
+</td></tr>
+<tr><td>
+
+[setState\_Bold(bold)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: whether it is bold
+
+</td></tr>
+<tr><td>
+
+[setState\_Color(color)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: text color
+
+</td></tr>
+<tr><td>
+
+[setState\_FillColor(fillColor)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: fill color
+
+</td></tr>
+<tr><td>
+
+[setState\_FontName(fontName)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: font name
+
+</td></tr>
+<tr><td>
+
+[setState\_FontSize(fontSize)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: font size
+
+</td></tr>
+<tr><td>
+
+[setState\_Italic(italic)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: whether it is italic
+
+</td></tr>
+<tr><td>
+
+[setState\_Key(key)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: key
+
+</td></tr>
+<tr><td>
+
+[setState\_KeyVisible(keyVisible)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: whether the key is visible
+
+</td></tr>
+<tr><td>
+
+[setState\_Rotation(rotation)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: rotation angle
+
+</td></tr>
+<tr><td>
+
+[setState\_UnderLine(underLine)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: whether it is underlined
+
+</td></tr>
+<tr><td>
+
+[setState\_Value(value)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: value
+
+</td></tr>
+<tr><td>
+
+[setState\_ValueVisible(valueVisible)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: whether the value is visible
+
+</td></tr>
+<tr><td>
+
+[setState\_X(x)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: X coordinate
+
+</td></tr>
+<tr><td>
+
+[setState\_Y(y)](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Set the property state: Y coordinate
+
+</td></tr>
+<tr><td>
+
+[toAsync()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Convert Primitive to Async primitive
+
+</td></tr>
+<tr><td>
+
+[toSync()](./ISCH_PrimitiveAttribute.md)
+
+</td><td>
+
+</td><td>
+
+Convert Primitive to Sync primitive
+
+</td></tr>
+</tbody></table>
+
+---
+
+## 方法详情
+
+### done
+
+# ISCH\_PrimitiveAttribute.done() 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.
+
+Apply the changes to the primitives to the canvas
+
+## Signature
+
+```typescript
+function done(): Promise<ISCH_PrimitiveAttribute>;
+```
+
+## Returns
+
+Promise&lt;[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)<!-- -->&gt;
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 记录修改前的字号和旋转角度
+const fontSizeBefore = designator.getState_FontSize();
+const rotationBefore = designator.getState_Rotation();
+
+// 4. 批量修改两个属性，一次 done() 提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_FontSize(50);
+asyncAttr.setState_Rotation(90);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('fontSize:', fontSizeBefore, '→', refetched.getState_FontSize());
+console.log('rotation:', rotationBefore, '→', refetched.getState_Rotation());
+```
+
+### getstate_alignmode
+
+# ISCH\_PrimitiveAttribute.getState\_AlignMode() method
+
+Get the property state: alignment mode
+
+## Signature
+
+```typescript
+function getState_AlignMode(): ESCH_PrimitiveTextAlignMode | null;
+```
+
+## Returns
+
+[ESCH\_PrimitiveTextAlignMode](../enums/ESCH_PrimitiveTextAlignMode.md) \| null
+
+Alignment mode
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本的对齐模式（1~9 对应左上/中上/居中等九宫格方位，null 为跟随默认）
+const alignMode = designator.getState_AlignMode();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('alignMode:', alignMode);
+```
+
+### getstate_bold
+
+# ISCH\_PrimitiveAttribute.getState\_Bold() method
+
+Get the property state: whether it is bold
+
+## Signature
+
+```typescript
+function getState_Bold(): boolean | null;
+```
+
+## Returns
+
+boolean \| null
+
+Whether it is bold
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本是否加粗（null 表示跟随默认样式）
+const bold = designator.getState_Bold();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('bold:', bold);
+```
+
+### getstate_color
+
+# ISCH\_PrimitiveAttribute.getState\_Color() method
+
+Get the property state: text color
+
+## Signature
+
+```typescript
+function getState_Color(): string | null;
+```
+
+## Returns
+
+string \| null
+
+Text color
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本颜色（null 表示跟随默认颜色）
+const color = designator.getState_Color();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('color:', color);
+```
+
+### getstate_fillcolor
+
+# ISCH\_PrimitiveAttribute.getState\_FillColor() method
+
+Get the property state: fill color
+
+## Signature
+
+```typescript
+function getState_FillColor(): string | null;
+```
+
+## Returns
+
+string \| null
+
+Fill color
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本底色（null 表示无底色）
+const fillColor = designator.getState_FillColor();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('fillColor:', fillColor);
+```
+
+### getstate_fontname
+
+# ISCH\_PrimitiveAttribute.getState\_FontName() method
+
+Get the property state: font name
+
+## Signature
+
+```typescript
+function getState_FontName(): string | null;
+```
+
+## Returns
+
+string \| null
+
+Font name
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本的字体名称（null 表示跟随默认字体）
+const fontName = designator.getState_FontName();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('fontName:', fontName);
+```
+
+### getstate_fontsize
+
+# ISCH\_PrimitiveAttribute.getState\_FontSize() method
+
+Get the property state: font size
+
+## Signature
+
+```typescript
+function getState_FontSize(): number | null;
+```
+
+## Returns
+
+number \| null
+
+Font size
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本的字号，单位 mm（null 表示跟随默认字号）
+const fontSize = designator.getState_FontSize();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('fontSize:', fontSize);
+```
+
+### getstate_italic
+
+# ISCH\_PrimitiveAttribute.getState\_Italic() method
+
+Get the property state: whether it is italic
+
+## Signature
+
+```typescript
+function getState_Italic(): boolean | null;
+```
+
+## Returns
+
+boolean \| null
+
+Whether it is italic
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本是否斜体（null 表示跟随默认样式）
+const italic = designator.getState_Italic();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('italic:', italic);
+```
+
+### getstate_key
+
+# ISCH\_PrimitiveAttribute.getState\_Key() method
+
+Get the property state: key
+
+## Signature
+
+```typescript
+function getState_Key(): string;
+```
+
+## Returns
+
+string
+
+Key
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取器件全部属性的 Key（属性名）
+const keys = attrs.map(a => a.getState_Key());
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('keys:', keys.join(', '));
+```
+
+### getstate_keyvisible
+
+# ISCH\_PrimitiveAttribute.getState\_KeyVisible() method
+
+Get the property state: whether the key is visible
+
+## Signature
+
+```typescript
+function getState_KeyVisible(): boolean | null;
+```
+
+## Returns
+
+boolean \| null
+
+Whether the key is visible
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取 Key（属性名前缀）是否可见
+const keyVisible = designator.getState_KeyVisible();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('keyVisible:', keyVisible);
+```
+
+### getstate_parentprimitiveid
+
+# ISCH\_PrimitiveAttribute.getState\_ParentPrimitiveId() method
+
+Get the property state: parent primitive ID
+
+## Signature
+
+```typescript
+function getState_ParentPrimitiveId(): string;
+```
+
+## Returns
+
+string
+
+Parent primitive ID
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取父图元 ID，并与所属器件的 ID 比对
+const parentPrimitiveId = designator.getState_ParentPrimitiveId();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('parentPrimitiveId:', parentPrimitiveId);
+console.log('belongs to component:', parentPrimitiveId === compId);
+```
+
+### getstate_primitiveid
+
+# ISCH\_PrimitiveAttribute.getState\_PrimitiveId() method
+
+Get the property state: primitive ID
+
+## Signature
+
+```typescript
+function getState_PrimitiveId(): string;
+```
+
+## Returns
+
+string
+
+Primitive ID
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取属性图元 ID
+const primitiveId = designator.getState_PrimitiveId();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('primitiveId:', primitiveId);
+```
+
+### getstate_primitivetype
+
+# ISCH\_PrimitiveAttribute.getState\_PrimitiveType() method
+
+Get the property state: primitive type
+
+## Signature
+
+```typescript
+function getState_PrimitiveType(): ESCH_PrimitiveType;
+```
+
+## Returns
+
+[ESCH\_PrimitiveType](../enums/ESCH_PrimitiveType.md)
+
+Primitive type
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取图元类型（属性图元固定为 Attribute）
+const primitiveType = designator.getState_PrimitiveType();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('primitiveType:', primitiveType);
+```
+
+### getstate_rotation
+
+# ISCH\_PrimitiveAttribute.getState\_Rotation() method
+
+Get the property state: rotation angle
+
+## Signature
+
+```typescript
+function getState_Rotation(): number | null;
+```
+
+## Returns
+
+number \| null
+
+Rotation angle
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本的旋转角度（度）
+const rotation = designator.getState_Rotation();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('rotation:', rotation);
+```
+
+### getstate_underline
+
+# ISCH\_PrimitiveAttribute.getState\_UnderLine() method
+
+Get the property state: whether it is underlined
+
+## Signature
+
+```typescript
+function getState_UnderLine(): boolean | null;
+```
+
+## Returns
+
+boolean \| null
+
+Whether it is underlined
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本是否加下划线（null 表示跟随默认样式）
+const underLine = designator.getState_UnderLine();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('underLine:', underLine);
+```
+
+### getstate_value
+
+# ISCH\_PrimitiveAttribute.getState\_Value() method
+
+Get the property state: value
+
+## Signature
+
+```typescript
+function getState_Value(): string;
+```
+
+## Returns
+
+string
+
+Value
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号属性的值
+const value = designator.getState_Value();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('value:', value);
+```
+
+### getstate_valuevisible
+
+# ISCH\_PrimitiveAttribute.getState\_ValueVisible() method
+
+Get the property state: whether the value is visible
+
+## Signature
+
+```typescript
+function getState_ValueVisible(): boolean | null;
+```
+
+## Returns
+
+boolean \| null
+
+Whether the value is visible
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取值是否可见
+const valueVisible = designator.getState_ValueVisible();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('valueVisible:', valueVisible);
+```
+
+### getstate_x
+
+# ISCH\_PrimitiveAttribute.getState\_X() method
+
+Get the property state: X coordinate
+
+## Signature
+
+```typescript
+function getState_X(): number | null;
+```
+
+## Returns
+
+number \| null
+
+X coordinate
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本的 X 坐标（原理图单位，1 单位 = 10mil）
+const attrX = designator.getState_X();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('attrX:', attrX);
+```
+
+### getstate_y
+
+# ISCH\_PrimitiveAttribute.getState\_Y() method
+
+Get the property state: Y coordinate
+
+## Signature
+
+```typescript
+function getState_Y(): number | null;
+```
+
+## Returns
+
+number \| null
+
+Y coordinate
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取编号文本的 Y 坐标（原理图单位，1 单位 = 10mil）
+const attrY = designator.getState_Y();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('attrY:', attrY);
+```
+
+### isasync
+
+# ISCH\_PrimitiveAttribute.isAsync() method
+
+Query whether the primitive is an async primitive
+
+## Signature
+
+```typescript
+function isAsync(): boolean;
+```
+
+## Returns
+
+boolean
+
+Whether Is async primitive
+
+## Example
+
+```javascript
+// 1. 放置一个测试器件（属性图元随器件生成，无法单独创建）
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], 600, 600);
+const compId = comp.getState_PrimitiveId();
+
+// 2. 取出器件的属性图元，定位 Designator（编号）属性
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(compId);
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 查询异步状态
+const isAsync = designator.isAsync();
+
+// 4. 清理测试器件（属性图元随器件一起删除）
+await eda.sch_PrimitiveComponent.delete([compId]);
+
+console.log('isAsync:', isAsync);
+```
+
+### reset
+
+# ISCH\_PrimitiveAttribute.reset() 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.
+
+Reset the async primitive to the current canvas state
+
+## Signature
+
+```typescript
+function reset(): Promise<ISCH_PrimitiveAttribute>;
+```
+
+## Returns
+
+Promise&lt;[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)<!-- -->&gt;
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 记录画布上的原始值
+const original = designator.getState_Value();
+
+// 4. 异步模式下改一个错误值，但不提交，直接 reset() 丢弃
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_Value('SHOULD-DISCARD');
+await asyncAttr.reset();
+
+// 5. 从画布重新读取，确认值仍是原始值（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('value:', original, '→', refetched.getState_Value(), '(修改已丢弃)');
+```
+
+### setstate_alignmode
+
+# ISCH\_PrimitiveAttribute.setState\_AlignMode() 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: alignment mode
+
+## Signature
+
+```typescript
+function setState_AlignMode(alignMode: ESCH_PrimitiveTextAlignMode | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+alignMode
+
+</td><td>
+
+[ESCH\_PrimitiveTextAlignMode](../enums/ESCH_PrimitiveTextAlignMode.md) \| null
+
+</td><td>
+
+Alignment mode
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取修改前的对齐模式
+const before = designator.getState_AlignMode();
+
+// 4. 切换异步模式设置为中上对齐并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_AlignMode(4);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('alignMode:', before, '→', refetched.getState_AlignMode());
+```
+
+### setstate_bold
+
+# ISCH\_PrimitiveAttribute.setState\_Bold() 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: whether it is bold
+
+## Signature
+
+```typescript
+function setState_Bold(bold: boolean | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+bold
+
+</td><td>
+
+boolean \| null
+
+</td><td>
+
+Whether it is bold
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 切换异步模式加粗编号并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_Bold(true);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('bold:', refetched.getState_Bold());
+```
+
+### setstate_color
+
+# ISCH\_PrimitiveAttribute.setState\_Color() 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: text color
+
+## Signature
+
+```typescript
+function setState_Color(color: string | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+color
+
+</td><td>
+
+string \| null
+
+</td><td>
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 切换异步模式，Color 与 FillColor 同时设置才生效
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_Color('#FFEC8B');
+asyncAttr.setState_FillColor('#FFEC8B');
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('color:', refetched.getState_Color());
+```
+
+### setstate_fillcolor
+
+# ISCH\_PrimitiveAttribute.setState\_FillColor() 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: fill color
+
+## Signature
+
+```typescript
+function setState_FillColor(fillColor: string | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+fillColor
+
+</td><td>
+
+string \| null
+
+</td><td>
+
+Fill color
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 切换异步模式设置底色并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_FillColor('#FFEC8B');
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('fillColor:', refetched.getState_FillColor());
+```
+
+### setstate_fontname
+
+# ISCH\_PrimitiveAttribute.setState\_FontName() 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: font name
+
+## Signature
+
+```typescript
+function setState_FontName(fontName: string | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+fontName
+
+</td><td>
+
+string \| null
+
+</td><td>
+
+Font name
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 切换异步模式设置字体并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_FontName('Arial');
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('fontName:', refetched.getState_FontName());
+```
+
+### setstate_fontsize
+
+# ISCH\_PrimitiveAttribute.setState\_FontSize() 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: font size
+
+## Signature
+
+```typescript
+function setState_FontSize(fontSize: number | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+fontSize
+
+</td><td>
+
+number \| null
+
+</td><td>
+
+Font size
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 切换异步模式设置字号并提交（传入 50，读回 0.5mm）
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_FontSize(50);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('fontSize:', refetched.getState_FontSize());
+```
+
+### setstate_italic
+
+# ISCH\_PrimitiveAttribute.setState\_Italic() 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: whether it is italic
+
+## Signature
+
+```typescript
+function setState_Italic(italic: boolean | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+italic
+
+</td><td>
+
+boolean \| null
+
+</td><td>
+
+Whether it is italic
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 切换异步模式设置斜体并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_Italic(true);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('italic:', refetched.getState_Italic());
+```
+
+### setstate_key
+
+# ISCH\_PrimitiveAttribute.setState\_Key() 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: key
+
+## Signature
+
+```typescript
+function setState_Key(key: string): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+key
+
+</td><td>
+
+string
+
+</td><td>
+
+Key
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取修改前的属性名
+const before = designator.getState_Key();
+
+// 4. 切换异步模式重命名属性并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_Key('Ref');
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('key:', before, '→', refetched.getState_Key());
+```
+
+### setstate_keyvisible
+
+# ISCH\_PrimitiveAttribute.setState\_KeyVisible() 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: whether the key is visible
+
+## Signature
+
+```typescript
+function setState_KeyVisible(keyVisible: boolean | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+keyVisible
+
+</td><td>
+
+boolean \| null
+
+</td><td>
+
+Whether the key is visible
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 切换异步模式显示属性名前缀并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_KeyVisible(true);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('keyVisible:', refetched.getState_KeyVisible());
+```
+
+### setstate_rotation
+
+# ISCH\_PrimitiveAttribute.setState\_Rotation() 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: rotation angle
+
+## Signature
+
+```typescript
+function setState_Rotation(rotation: number | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+rotation
+
+</td><td>
+
+number \| null
+
+</td><td>
+
+Rotation angle
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取修改前的角度，切换异步模式旋转 90° 并提交
+const before = designator.getState_Rotation();
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_Rotation(90);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('rotation:', before, '→', refetched.getState_Rotation());
+```
+
+### setstate_underline
+
+# ISCH\_PrimitiveAttribute.setState\_UnderLine() 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: whether it is underlined
+
+## Signature
+
+```typescript
+function setState_UnderLine(underLine: boolean | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+underLine
+
+</td><td>
+
+boolean \| null
+
+</td><td>
+
+Whether it is underlined
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 切换异步模式加下划线并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_UnderLine(true);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('underLine:', refetched.getState_UnderLine());
+```
+
+### setstate_value
+
+# ISCH\_PrimitiveAttribute.setState\_Value() 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: value
+
+## Signature
+
+```typescript
+function setState_Value(value: string): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+value
+
+</td><td>
+
+string
+
+</td><td>
+
+Value
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取修改前的属性值
+const before = designator.getState_Value();
+
+// 4. 切换异步模式修改属性值并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_Value(`${before}-MOD`);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('value:', before, '→', refetched.getState_Value());
+```
+
+### setstate_valuevisible
+
+# ISCH\_PrimitiveAttribute.setState\_ValueVisible() 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: whether the value is visible
+
+## Signature
+
+```typescript
+function setState_ValueVisible(valueVisible: boolean | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+valueVisible
+
+</td><td>
+
+boolean \| null
+
+</td><td>
+
+Whether the value is visible
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取修改前的可见状态
+const before = designator.getState_ValueVisible();
+
+// 4. 切换异步模式隐藏属性值并提交
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_ValueVisible(false);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('valueVisible:', before, '→', refetched.getState_ValueVisible());
+```
+
+### setstate_x
+
+# ISCH\_PrimitiveAttribute.setState\_X() 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: X coordinate
+
+## Signature
+
+```typescript
+function setState_X(x: number | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+x
+
+</td><td>
+
+number \| null
+
+</td><td>
+
+X coordinate
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取修改前的 X 坐标，向右平移 50 单位（约 12.7mm）
+const before = designator.getState_X();
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_X(before + 50);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('attrX:', before, '→', refetched.getState_X());
+```
+
+### setstate_y
+
+# ISCH\_PrimitiveAttribute.setState\_Y() 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: Y coordinate
+
+## Signature
+
+```typescript
+function setState_Y(y: number | null): ISCH_PrimitiveAttribute;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+y
+
+</td><td>
+
+number \| null
+
+</td><td>
+
+Y coordinate
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取修改前的 Y 坐标，向下平移 50 单位（读回值符号相反）
+const before = designator.getState_Y();
+const asyncAttr = designator.toAsync();
+asyncAttr.setState_Y(before + 50);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('attrY:', before, '→', refetched.getState_Y());
+```
+
+### toasync
+
+# ISCH\_PrimitiveAttribute.toAsync() method
+
+Convert Primitive to Async primitive
+
+## Signature
+
+```typescript
+function toAsync(): ISCH_PrimitiveAttribute;
+```
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 转换为异步句柄并确认其异步状态
+const asyncAttr = designator.toAsync();
+
+// 4. 通过异步句柄修改字号并提交（传入 50，读回 0.5mm）
+asyncAttr.setState_FontSize(50);
+await asyncAttr.done();
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('isAsync:', asyncAttr.isAsync());
+console.log('fontSize:', refetched.getState_FontSize());
+```
+
+### tosync
+
+# ISCH\_PrimitiveAttribute.toSync() method
+
+Convert Primitive to Sync primitive
+
+## Signature
+
+```typescript
+function toSync(): ISCH_PrimitiveAttribute;
+```
+
+## Returns
+
+[ISCH\_PrimitiveAttribute](./ISCH_PrimitiveAttribute.md)
+
+Attribute primitive object
+
+## Example
+
+```javascript
+// 1. 生成本次运行专用的坐标，避免与之前保留的测试器件重合
+const x = 2000 + Math.floor(Math.random() * 6000);
+const y = 2000 + Math.floor(Math.random() * 6000);
+
+// 2. 放置测试器件并取出 Designator（编号）属性
+const devices = await eda.lib_Device.search('C0402');
+const comp = await eda.sch_PrimitiveComponent.create(devices[0], x, y);
+const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId(comp.getState_PrimitiveId());
+const attrs = await eda.sch_PrimitiveAttribute.get(attrIds);
+const designator = attrs.find(a => a.getState_Key() === 'Designator');
+
+// 3. 读取修改前的属性值
+const before = designator.getState_Value();
+
+// 4. 转换为同步图元后直接修改，立即生效（无需 done()）
+const syncAttr = designator.toSync();
+syncAttr.setState_Value(`${before}-SYNC`);
+
+// 5. 从画布重新读取，确认修改已生效（保留现场供观察）
+const refetched = await eda.sch_PrimitiveAttribute.get(designator.getState_PrimitiveId());
+
+console.log('value:', before, '→', refetched.getState_Value());
+```