IconUrl 元素

  • 项目

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

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

语法

<IconUrl DefaultValue="string" />

可以包含

属性

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

备注

对于邮件加载项，图标显示在“文件>管理加载项 UI (Outlook) ”或“设置>管理加载项”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 中使用图标。

图像必须采用下列任一文件格式进行保存：GIF、JPG、PNG、EXIF、BMP 或 TIFF。 对于内容和任务窗格应用程序，指定的图像必须是 32 x 32 像素。 对于邮件应用，图像分辨率必须为 64 x 64 像素。 还应使用 HighResolutionIconUrl 元素指定用于在高 DPI 屏幕上运行的 Office 客户端应用程序的图标。 有关详细信息，请参阅在 AppSource 和 Office 中创建有效的应用一览中的为你的应用创建一致的视觉标识部分。

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

示例

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

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