MS Word 365自定义任务窗格点击文件菜单消失的问题咨询

一、区分两种关闭操作 #

Office本身没有直接提供事件来区分「用户手动点击任务窗格关闭按钮（X）」和「进入File菜单（Backstage视图）导致的任务窗格隐藏」，但可以通过检测当前文档模式间接判断：
进入File菜单时，文档模式会切换为Office.DocumentMode.Backstage；用户手动关闭任务窗格时，文档模式仍处于编辑/阅读模式（Edit或Read）。

你可以在TaskPaneVisibleChanged事件处理函数中加入模式判断逻辑：

// 初始化时绑定任务窗格可见性变化事件
Office.onReady(() => {
  Office.context.ui.taskPane.addHandlerAsync(
    Office.EventType.TaskPaneVisibleChanged,
    handleVisibleChange
  );
});

function handleVisibleChange(eventArgs) {
  const isVisible = eventArgs.isVisible;
  
  if (!isVisible) {
    const currentMode = Office.context.document.mode;
    // 判断隐藏原因
    if (currentMode === Office.DocumentMode.Backstage) {
      // 因进入File菜单导致隐藏
      console.log("任务窗格被Backstage视图隐藏");
      // 此处跳过组件关闭逻辑
    } else {
      // 用户手动点击X关闭
      console.log("用户手动关闭任务窗格");
      // 执行你的组件关闭逻辑
    }
  }
}

二、实现点击File菜单时不关闭加载项 #

Office默认会在进入Backstage视图时隐藏任务窗格，无法直接禁用该行为，但可以通过监听文档模式变化+恢复可见性的方式，让任务窗格在退出File菜单后自动恢复显示：

1. 记录任务窗格进入Backstage前的可见状态
2. 当退出Backstage（回到编辑/阅读模式）时，恢复之前的可见状态

具体代码示例：

let prevTaskPaneVisible = false;

Office.onReady(() => {
  const taskPane = Office.context.ui.taskPane;

  // 初始化时保存任务窗格初始可见状态
  taskPane.getVisibleAsync((result) => {
    if (result.status === Office.AsyncResultStatus.Succeeded) {
      prevTaskPaneVisible = result.value;
    }
  });

  // 监听任务窗格可见性变化
  taskPane.addHandlerAsync(
    Office.EventType.TaskPaneVisibleChanged,
    (eventArgs) => {
      // 仅当非Backstage模式下的隐藏才更新记录状态
      if (!eventArgs.isVisible && Office.context.document.mode !== Office.DocumentMode.Backstage) {
        prevTaskPaneVisible = false;
        // 执行手动关闭的组件逻辑
      } else if (eventArgs.isVisible) {
        prevTaskPaneVisible = true;
      }
    }
  );

  // 监听文档模式切换事件
  Office.context.document.addHandlerAsync(
    Office.EventType.DocumentModeChanged,
    (eventArgs) => {
      const newMode = eventArgs.mode;
      // 退出Backstage视图，恢复任务窗格可见性
      if ((newMode === Office.DocumentMode.Edit || newMode === Office.DocumentMode.Read) && prevTaskPaneVisible) {
        taskPane.setVisibleAsync(true);
      }
      // 进入Backstage视图，记录当前可见状态
      else if (newMode === Office.DocumentMode.Backstage) {
        taskPane.getVisibleAsync((result) => {
          if (result.status === Office.AsyncResultStatus.Succeeded) {
            prevTaskPaneVisible = result.value;
          }
        });
      }
    }
  );
});

注意事项 #

• 确保加载项使用较新版本的Office.js，DocumentModeChanged事件在旧版本中可能不支持
• 测试时需注意：在Backstage视图内任务窗格会被暂时隐藏，但退出后会自动恢复，这是当前可行的折中方案——Office没有提供强制让任务窗格在Backstage中保持可见的API

内容的提问来源于stack exchange，提问作者Antonio Argentieri