Элемент IconUrl

Указывает полный абсолютный URL-адрес изображения, которое используется для представления надстройки Office во вставке пользовательского интерфейса, AppSource и на вертикальной панели вкладок области задач.

Важно!

Этот элемент и элемент HighResolutionIconUrl теперь необходимы для надстроек, распространяемых в AppSource.

Тип надстройки: контентные и почтовые надстройки, надстройки области задач

Синтаксис

<IconUrl DefaultValue="string" />

Может содержать:

• Override

Атрибуты

Атрибут	Тип	Обязательный	Описание
DefaultValue	string	Да	Задает значение по умолчанию для этого параметра, представленное для языкового стандарта, который указан с помощью элемента DefaultLocale.

Примечания

Изображение должно быть в одном из следующих форматов:

• БМП
• EXIF
• GIF
• JPG
• PNG
• TIFF

Требования к разрешению изображения следующие.

Тип надстройки	Разрешение (пикселей)
Содержимое	32 х 32
Почта	64 x 64
Область задач	32 х 32

Необходимо также указать значок для использования с клиентскими приложениями Office, работающими на экранах с высоким DPI с помощью элемента HighResolutionIconUrl . Дополнительные сведения см. в разделе "Создание единого визуального оформления в статье Создание эффективных списков в AppSource и в Office".

Для почтовых надстроек значок отображается в пользовательском интерфейсе> управлениянадстройками файла (Outlook) или в параметрах> пользовательского интерфейса управлениянадстройками (Outlook в Интернете). Значок надстройки области задач или контентной надстройки отображается в разделе Вставка>Надстройки.

Изображение также используется на вертикальной панели вкладок области задач, если открыто несколько областей задач. Панель вкладок отображается рядом с областью задач при каждом открытии второй области задач независимо от того, является ли она областью задач в той же или другой надстройке. На следующем рисунке показана панель вкладок, если запущена надстройка 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" />