Bildelement

Enthält die URL einer Bilddatei, die als Symbol verwendet wird.

Add-In-Typ: Aufgabenbereich, Mail

Nur in diesen VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Hinweis

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

Jedes Symbol muss über drei <Bildelemente> verfügen, eines für jede der drei obligatorischen Größen:

  • 16x16
  • 32x32
  • 80x80

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

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

Die folgenden Bilddateiformate werden unterstützt.

  • BMP (Englisch)
  • EXIF
  • GIF
  • JPG
  • PNG
  • TIFF

Wichtig

  • Wenn es sich bei dem Bild um das repräsentative Symbol Ihres Add-Ins handelt, lesen Sie Erstellen effektiver Einträge in AppSource und in Office für Größe und andere Anforderungen.
  • Office-Add-Ins erfordern die Möglichkeit, Bildressourcen 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. Um die Verwendung neuer Symbole auf Ihrem Entwicklungscomputer zu erzwingen, löschen Sie den Office-Cache. Um die Verwendung neuer Symbole auf den Computern der Endbenutzer zu erzwingen, müssen Sie den neuen Symbolen andere URLs als den alten geben.
  • Das ICO-Format wird nicht unterstützt. Wenn du es in deinem Manifest verwendest, schlägt die Manifestvalidierung fehl und dein Add-In wird nicht im Menüband oder in der Aktionsleiste angezeigt.

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>