English
Home > PNL_PrimitiveRectangle > modify
PNL_PrimitiveRectangle.modify() 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.
修改矩形图元属性
Signature
typescript
function modify(
primitiveId: string | IPNL_PrimitiveRectangle,
property: {
x?: number;
y?: number;
width?: number;
height?: number;
rx?: number;
ry?: number;
layer?: EPNL_LayerId;
strokeColor?: string;
fillColor?: string;
strokeWidth?: number;
rotation?: number;
primitiveLock?: boolean;
},
): Promise<IPNL_PrimitiveRectangle | undefined>;1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Parameters
Parameter | Type | Description |
|---|---|---|
primitiveId | string | IPNL_PrimitiveRectangle | 图元 ID 或图元对象 |
property | { x?: number; y?: number; width?: number; height?: number; rx?: number; ry?: number; layer?: EPNL_LayerId; strokeColor?: string; fillColor?: string; strokeWidth?: number; rotation?: number; primitiveLock?: boolean } | 待更新的属性(传需要修改的字段即可) |
Returns
Promise<IPNL_PrimitiveRectangle | undefined>
修改后的图元对象,图元不存在或执行失败返回 undefined
Remarks
部分更新语义:仅覆盖传入的字段,未传入字段保持原值,可同时修改多个字段
修改 x / y 为移动参考点;修改 width / height 为沿矩形自身轴缩放,参考点保持不动;修改 rotation 为绕参考点逆时针旋转(度)
参考点取编辑器属性面板当前全局设置(九宫格,缺省左下角) ADD since EDA v4.1.105