IconUrl 元素

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

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

语法

<IconUrl DefaultValue="string" />

可以包含

• Override

属性

属性	类型	必需	说明
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" />