English
Home > SCH_SourcePrimitiveText > add
SCH_SourcePrimitiveText.add() method
创建文本
Signature
typescript
function add(
options: ISCH_SourcePrimitiveTextAddOptions,
): Promise<TSCH_SourceResult<ISCH_SourcePrimitiveResult>>;1
2
3
2
3
Parameters
Parameter | Type | Description |
|---|---|---|
options | 文本创建选项 |
Returns
Promise<TSCH_SourceResult<ISCH_SourcePrimitiveResult>>
文本图元 ID,失败时通过 error.code 返回错误码
Remarks
**样式参数设计**
- 本接口**故意不提供**字体、字号、颜色、对齐等样式参数 - Source API 保持极简,以降低 AI / CLI 的参数选择与纠错成本 - 文本样式由内部按现有规则决定 - 需要精确控制样式时,使用旧图元 API SCH_PrimitiveText 或编辑器界面
**写入异步生效**
本接口返回 ok 仅表示已写入 Source 数据;网表 / DRC / 区域查询等接口异步刷新,通常需等待约 1 秒才能读到本次改动;写后立即验证请使用 Source 的 get / getGeometry,或等待约 1 秒后重试;不要把紧随其后的旧快照当成写入失败 ADD since EDA v4.1.83 cli - 本接口直接操作工程源数据,无需前端已打开对应图页;Source 故意不提供样式参数,保持接口极简