You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在运行时修改功能区命令按钮的Tooltip?

能否在运行时修改功能区命令按钮的Tooltip文本?

可以。哪怕功能区按钮的Tooltip初始是在manifest.xml里静态配置的,也完全能在运行时动态修改。

具体实现可通过Office.js提供的API完成,步骤如下:

  • 构造包含目标控件新属性的配置对象,指定对应选项卡、组、按钮的ID,以及要更新的tooltip值;
  • 调用Office.Ribbon.requestUpdateAsync方法提交更新请求。

示例代码如下:

// 构建功能区更新配置
const ribbonUpdateConfig = {
  tabs: [
    {
      id: "YourCustomTabId", // 替换为manifest中定义的自定义选项卡ID
      groups: [
        {
          id: "YourCustomGroupId", // 替换为manifest中定义的自定义组ID
          controls: [
            {
              id: "TargetButtonId", // 替换为要修改的按钮ID
              properties: {
                tooltip: "这是更新后的Tooltip文本"
              }
            }
          ]
        }
      ]
    }
  ]
};

// 发送更新请求
Office.Ribbon.requestUpdateAsync(ribbonUpdateConfig, (result) => {
  if (result.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Tooltip已成功更新");
  } else {
    console.error("更新失败: " + result.error.message);
  }
});

需要注意:代码中使用的选项卡、组、按钮ID必须和manifest.xml里定义的完全匹配,否则更新会失效。该方法适用于所有支持Office.js的Office应用(如Excel、Word、Outlook等)。

内容的提问来源于stack exchange,提问作者Samuel Diaz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.04 20:55:57