Home > DMT_EditorControl > zoomTo

DMT_EditorControl.zoomTo() method

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

缩放到坐标

签名

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

参数名

参数	类型	描述
x	number	（可选） 中心坐标 X，如若不传入则不改变当前 X 坐标
y	number	（可选） 中心坐标 Y，如若不传入则不改变当前 Y 坐标
scaleRatio	number	（可选） 缩放比，如若不传入则不改变当前缩放比，单位跨度为 1/100，如若传入 200，则表示缩放比为 200%
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);

// 2. 视口中心移到 (100, 100)，缩放比 200%（单位跨度 1/100）
const bounds = await eda.dmt_EditorControl.zoomTo(100, 100, 200, tabId);
console.log('bounds:', bounds);