Элемент IconUrl

  • Статья

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

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

Синтаксис

<IconUrl DefaultValue="string" />

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

Атрибуты

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

Замечания

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

  • BMP
  • EXIF
  • GIF
  • JPG
  • PNG
  • РАЗМОЛВКА

Ниже приведены требования к разрешению изображений.

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

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

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

Изображение также используется на вертикальной панели вкладок для области задач, когда открыто несколько областей задач. Панель вкладок появляется рядом с областью задач при открытии второй области задач независимо от того, является ли она областью задач в той же надстройке или другой надстройке. На следующем рисунке показана панель вкладок, когда были запущены надстройка "Лаборатория сценариев" и другая надстройка, а также открыты области задач "Код " и "Запуск " в лаборатории сценариев.

Верхний дюйм области задач с тремя квадратными вкладками справа от правого верхнего угла. Две вкладки имеют значок Лаборатории скриптов. Третий имеет значок для другой надстройки.

Для всех типов надстроек значок также используется в 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" />