Home > LIB_Symbol > openInEditor

LIB_Symbol.openInEditor() method

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

在编辑器打开文档

签名

function openInEditor(
	symbolUuid: string,
	libraryUuid: string,
	splitScreenId?: string,
): Promise<string | undefined>;

参数名

参数	类型	描述
symbolUuid	string	符号 UUID
libraryUuid	string	库 UUID，可以使用 LIB_LibrariesList 内的接口获取
splitScreenId	string	（可选） 分屏 ID，不填写则默认在最后输入焦点的分屏内打开，可以使用 DMT_EditorControl 内的接口获取

返回值

Promise<string | undefined>

标签页 ID，对应 IDMT_EditorTabItem.tabId，可使用 DMT_EditorControl.getSplitScreenIdByTabId() 获取到分屏 ID

示例

// 1. 获取个人库 UUID，从系统库复制一个符号作为编辑对象
const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
const symbolUuid = await eda.lib_Symbol.copy(
	source.uuid,
	source.libraryUuid,
	libraryUuid,
	[],
	`嘉立创示例_编辑符号_${Date.now()}`
);

// 2. 在编辑器中打开该符号，返回标签页 ID（uuid@libraryUuid 格式）
const tabId = await eda.lib_Symbol.openInEditor(symbolUuid, libraryUuid);

// 打开后保留现场（编辑器停留在新符号页供观察；不需要时可传 tabId 给
// dmt_EditorControl.closeDocument 关闭）

console.log('symbolUuid:', symbolUuid);
console.log('tabId:', tabId);