Поделиться через

Элемент Image

  • Статья

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

Тип надстройки: Область задач, почта

Допустимо только в следующих схемах VersionOverrides:

  • Область задач 1.0
  • Почта 1.0
  • Почта 1.1

Дополнительные сведения см. в разделе Переопределения версий в манифесте только надстройки.

Примечание.

Необходимо использовать протокол SSL для всех URL-адресов в элементе <Image> и всех дочерних <элементов Переопределения> .

Каждый значок должен содержать три <элемента Image> , по одному для каждого из трех обязательных размеров:

  • 16 x 16
  • 32x32
  • 80x80

Следующие дополнительные размеры также поддерживаются, но не требуются.

  • 20x20
  • 24x24
  • 40x40
  • 48x48
  • 64x64

Поддерживаются следующие форматы файлов изображений.

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

Важно!

  • Если изображение является репрезентативным значком надстройки, см. статью Создание эффективных списков в AppSource и в Office , чтобы узнать о размере и других требованиях.
  • Надстройкам Office требуется возможность кэшировать ресурсы образов для повышения производительности. Поэтому сервер, на котором размещен ресурс изображения, не должен добавлять директивы CACHE-CONTROL в заголовок ответа. Эти директивы приводят к тому, что Office автоматически подстановка универсального образа или образа по умолчанию. Чтобы принудительно использовать новые значки на компьютере разработки, очистите кэш Office. Чтобы принудительно использовать новые значки на компьютерах пользователей, необходимо присвоить новым значкам другие URL-адреса, отличные от старых.

Дочерние элементы

Элемент Тип Описание
Override изображение Предоставляет способ переопределения URL-адреса в зависимости от указанного языкового стандарта.

Пример

<Resources>
      <bt:Images>
        <bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
        </bt:Image>
        <bt:Image id="icon1_32x32" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp32-icon_default.png" />
        </bt:Image>
        <bt:Image id="icon1_80x80" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp80-icon_default.png" />
        </bt:Image>
      </bt:Images>
      <bt:Urls>
        <bt:Url id="residDesktopFuncUrl" DefaultValue="https://www.contoso.com/Pages/Home.aspx">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/Pages/Home.aspx" />
        </bt:Url>
      </bt:Urls>
      <bt:ShortStrings>
        <bt:String id="residLabel" DefaultValue="GetData">
          <bt:Override Locale="ja-jp" Value="JA-JP-GetData" />
        </bt:String>
      </bt:ShortStrings>
      <bt:LongStrings>
        <bt:String id="residToolTip" DefaultValue="Get data for your document.">
          <bt:Override Locale="ja-jp" Value="JA-JP - Get data for your document." />
        </bt:String>
      </bt:LongStrings>
    </Resources>