Image-Element

Stellt die URL einer Bilddatei bereit, die als Symbol verwendet wird.

Add-In-Typ: Aufgabenbereich, E-Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Hinweis

Sie müssen Secure Sockets Layer (SSL) für alle URLs im <Image-Element> und alle untergeordneten< Override-Elemente> verwenden.

Jedes Symbol muss drei <Image-Elemente> aufweisen, eines für jede der drei obligatorischen Größen:

  • 16x16
  • 32x32
  • 80x80

Die folgenden zusätzlichen Größen werden ebenfalls unterstützt, aber nicht erforderlich.

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

Die folgenden Bilddateiformate werden unterstützt.

  • BMP
  • EXIF
  • GIF
  • JPG
  • PNG
  • TIFF

Wichtig

  • Wenn das Bild das repräsentative Symbol Ihres Add-Ins ist, finden Sie unter Erstellen effektiver Einträge in AppSource und in Office informationen zu Größe und anderen Anforderungen.
  • Office-Add-Ins erfordern die Möglichkeit, Imageressourcen aus Leistungsgründen zwischenzuspeichern. Aus diesem Grund darf der Server, der eine Bildressource hostet, keine CACHE-CONTROL-Richtlinien zum Antwortheader hinzufügen. Diese Anweisungen führen dazu, dass Office automatisch ein generisches oder Standardbild ersetzt. Löschen Sie den Office-Cache, um die Verwendung neuer Symbole auf Ihrem Entwicklungscomputer zu erzwingen. Um die Verwendung neuer Symbole auf den Computern Ihres Endbenutzers zu erzwingen, müssen Sie den neuen Symbolen andere URLs als die alten zuweisen.

Untergeordnete Elemente

Element Typ Beschreibung
Override Abbildung Bietet eine Möglichkeit, die URL abhängig von einem angegebenen Gebietsschema zu überschreiben.

Beispiel

<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>