Home > DMT_Panel > modifyPanelName

DMT_Panel.modifyPanelName() method

修改面板名称

签名

function modifyPanelName(panelUuid: string, panelName: string): Promise<boolean>;

参数名

参数	类型	描述
panelUuid	string	面板 UUID
panelName	string	面板名称

返回值

Promise<boolean>

是否修改成功

示例

// 1. 改名目标优先用当前面板（它必然已打开），其次用列表里的现有面板，都没有时创建一个
let target = await eda.dmt_Panel.getCurrentPanelInfo();
if (!target) {
	const panels = await eda.dmt_Panel.getAllPanelsInfo();
	target = panels[0];
}
let createdHere = false;
if (!target) {
	createdHere = true;
	const uuid = await eda.dmt_Panel.createPanel();
	await new Promise(r => setTimeout(r, 1500));
	target = await eda.dmt_Panel.getPanelInfo(uuid);
}

// 2. 打开目标面板（改名只对已打开的面板生效）
await eda.dmt_EditorControl.openDocument(target.uuid);
await new Promise(r => setTimeout(r, 1000));

// 3. 修改面板名称
const newName = '嘉立创示例_面板新名称';
const renamed = await eda.dmt_Panel.modifyPanelName(target.uuid, newName);
console.log('renamed:', renamed);

// 4. 等 1s 让改名同步，回读验证（英文名可能被归一化为小写，按不区分大小写比较）
await new Promise(r => setTimeout(r, 1000));
const info = await eda.dmt_Panel.getPanelInfo(target.uuid);
console.log('renamedTo:', info?.name);
console.log('renameVerified:', (info?.name ?? '').toLowerCase() === newName.toLowerCase());

// 5. 本例创建的测试面板验证后删除清理；现有面板保留改名现场，人工验收后可改回原名
if (createdHere) {
	await eda.dmt_Panel.deletePanel(target.uuid);
}