如何在不使用任务窗格或返回值的情况下从自定义函数显示消息？

答案是：自定义函数的执行上下文无法直接显示UI消息（包括弹窗、状态栏提示），但可以通过共享运行时配合任务窗格间接实现。

为什么直接做不到？ #

Office自定义函数的设计定位是纯计算组件，运行在隔离的沙箱环境中，仅允许返回单元格计算结果，没有任何UI交互权限——哪怕启用了共享运行时，自定义函数的上下文仍然和插件主任务窗格的上下文是分离的，无法调用Office.context.ui相关API，也不能直接操作状态栏、弹窗等UI元素。

可行的间接实现方案：共享运行时+消息传递 #

核心思路是：自定义函数将需要提示的信息传递给任务窗格，由任务窗格来处理UI展示（弹窗、状态栏提示、单元格注释等）。具体步骤如下：

1. 启用共享运行时

首先需要在插件的manifest文件中配置共享运行时，确保自定义函数和任务窗格能共享同一运行环境：

<Runtimes>
  <Runtime resid="Taskpane.Url" type="shared" />
</Runtimes>

2. 自定义函数传递消息

在自定义函数中，通过OfficeRuntime.storage将提示信息存入共享存储：

/**
 * @customfunction
 * @param {number} input 计算输入值
 * @returns {number} 计算结果
 */
function calcAndNotify(input) {
  const result = input * 3;
  // 存储提示消息，附带唯一标识避免重复触发
  const notificationKey = "funcNotification";
  OfficeRuntime.storage.setItem(notificationKey, `计算完成：结果为 ${result}`)
    .catch(err => console.error("存储消息失败:", err));
  
  return result;
}

3. 任务窗格监听并展示消息

在任务窗格的代码中，监听共享存储的变化，收到消息后展示UI提示：

// 初始化时监听存储变化
OfficeRuntime.storage.addOnChangedHandler((changes) => {
  const notificationKey = "funcNotification";
  if (changes[notificationKey]?.newValue) {
    const message = changes[notificationKey].newValue;
    // 显示可关闭的弹窗（这里用浏览器原生alert，也可以用自定义模态框）
    alert(message);
    
    // 可选：更新状态栏提示（Office没有直接操作状态栏的API，但可以在任务窗格底部显示固定提示）
    document.getElementById("status-bar").textContent = message;
    
    // 清空存储，避免重复触发提示
    OfficeRuntime.storage.removeItem(notificationKey);
  }
});

注意事项

• 任务窗格需要保持打开状态才能接收消息，否则监听逻辑不会运行。可以在插件启动时自动打开任务窗格，或者提示用户手动打开。
• 如果需要精准关联到自定义函数所在的单元格，可以让用户将单元格地址作为参数传入函数，再将地址存入共享存储，任务窗格收到后可针对该单元格添加注释等操作。

其他替代方案 #

• 单元格返回值提示：如果允许将提示信息作为返回值的一部分，可以直接返回类似"✅ 计算完成：123"的内容，结合单元格条件格式高亮，也能起到提示作用。
• 单元格注释：通过任务窗格调用Excel API，为自定义函数所在单元格添加注释，注释内容为提示信息，用户 hover 单元格时即可查看。

内容的提问来源于stack exchange，提问作者T.J. Crowder