通过

IconUrl 元素

  • 项目

指定用于在插入 UX、 AppSource 和垂直任务窗格选项卡栏中表示 Office 加载项的图像的完整绝对 URL。

加载项类型：内容、任务窗格和邮件

语法

<IconUrl DefaultValue="string" />

可以包含

属性

属性 类型 必需 说明
DefaultValue string 是 指定该设置的默认值，表示为 DefaultLocale 元素中指定的区域设置。

备注

图像必须使用以下文件格式之一。

  • BMP
  • EXIF
  • GIF
  • JPG
  • PNG
  • TIFF

图像分辨率要求如下。

外接程序类型 分辨率 (像素)
内容 32 x 32
邮件 64 x 64
任务窗格 32 x 32

还应使用 HighResolutionIconUrl 元素指定用于在高 DPI 屏幕上运行的 Office 客户端应用程序的图标。 有关详细信息，请参阅在 AppSource 和 Office 中创建有效列表中的创建一致的视觉标识部分。

对于邮件加载项，图标显示在 “文件>管理加载项 UI (Outlook) ”或 “设置>”管理加载项 UI (Outlook 网页版) 。 For a content or task pane add-in, the icon is displayed in the Insert>Add-ins UI.

打开多个任务窗格时，该图像还会在任务窗格的垂直选项卡栏上使用。 每当打开第二个任务窗格时，选项卡栏都将显示在任务窗格旁边，无论它是同一外接程序中的任务窗格还是其他加载项中的任务窗格。 下图显示了 脚本实验室 加载项和另一个加载项都已启动且脚本实验室的 “代码 ”和“ 运行” 任务窗格均已打开时的选项卡栏。

任务窗格的上英寸，右上角右侧有三个方形选项卡。其中两个选项卡具有“脚本实验室”图标。第三个具有不同加载项的图标。

如果将外接程序发布到 AppSource，则对于所有加载项类型，也会在 AppSource 中使用图标。

当前不支持在运行时更改元素的值 IconUrl 。

示例

<IconUrl DefaultValue="https://localhost:3000/assets/images/icon-32.png" />

<IconUrl DefaultValue="https://script-lab.azureedge.net/assets/images/icon-32.png" />