Home > DMT_EditorControl > zoomToSelectedPrimitives

DMT_EditorControl.zoomToSelectedPrimitives() method

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

缩放到已选中图元（适应选中）

签名

function zoomToSelectedPrimitives(
	tabId?: string,
): Promise<{ left: number; right: number; top: number; bottom: number } | false>;

参数名

参数	类型	描述
tabId	string	（可选） 标签页 ID，如若未传入，则为最后输入焦点的画布

返回值

Promise<{ left: number; right: number; top: number; bottom: number } | false>

缩放到的区域数据，false 表示画布不支持该缩放操作或 tabId 不存在

备注

在返回数据中，原理图、符号画布坐标单位跨度为 0.01inch，PCB、封装画布坐标单位跨度为 mil

示例

// 1. 打开原理图页，创建一个文本图元作为选中目标
const pages = await eda.dmt_Schematic.getAllSchematicPagesInfo();
const tabId = await eda.dmt_EditorControl.openDocument(pages[0].uuid);
const text = await eda.sch_PrimitiveText.create(100, 80, '嘉立创示例_缩放目标');

// 2. 以图元 ID 建立选中状态
const selected = await eda.sch_SelectControl.doSelectPrimitives([text.getState_PrimitiveId()]);
console.log('selected:', selected);

// 3. 缩放到选中的图元，返回可视区域边界
const bounds = await eda.dmt_EditorControl.zoomToSelectedPrimitives(tabId);
console.log('bounds:', bounds);

// 4. 清理：取消选中并删除测试图元
await eda.sch_SelectControl.clearSelected();
await eda.sch_PrimitiveText.delete([text.getState_PrimitiveId()]);
console.log('cleaned');