IconUrl 元素

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

重要

现在，AppSource 中分发的加载项需要此元素和 HighResolutionIconUrl 元素。

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

语法

<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 中创建有效列表中创建一致视觉标识部分。

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

当打开多个任务窗格时，该图像也会用于任务窗格的垂直选项卡栏。 每当打开第二个任务窗格时，选项卡栏都会显示在任务窗格旁边，无论它是同一加载项中的任务窗格还是其他加载项。 下图显示了同时启动 Script Lab 加载项和另一个加载项，并且打开了 Script Lab 的“代码”和“运行”任务窗格时的选项卡栏。

任务窗格的上一英寸，右上角右侧有三个方形选项卡。其中两个选项卡具有 Script Lab 图标。第三个具有其他加载项的图标。

对于所有加载项类型，如果将加载项发布到 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" />
  • Last updated on