Freigeben über

IconUrl-Element

  • Artikel

Gibt die vollständige, absolute URL des Bilds an, das verwendet wird, um Ihr Office-Add-In in der Einfüge-UX, In AppSource und der vertikalen Registerkartenleiste des Aufgabenbereichs darzustellen.

Add-In-Typ: Inhalt, Aufgabenbereich, E-Mail

Syntax

<IconUrl DefaultValue="string" />

Kann enthalten

Attribute

Attribut Typ Erforderlich Beschreibung
DefaultValue string Ja Gibt den Standardwert für diese Einstellung an, der für das im DefaultLocale-Element angegebene Gebietsschema ausgedrückt wird.

Hinweise

Das Bild muss in einem der folgenden Dateiformate vorliegen.

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

Die Anforderungen an die Bildauflösung sind wie folgt.

Add-In-Typ Auflösung (Pixel)
Inhalt 32 x 32
E-Mail 64 x 64
Aufgabenbereich 32 x 32

Sie sollten auch ein Symbol für die Verwendung mit Office-Clientanwendungen angeben, die auf Bildschirmen mit hohem DPI-Wert ausgeführt werden, indem Sie das HighResolutionIconUrl-Element verwenden. Weitere Informationen finden Sie im Abschnitt Erstellen einer konsistenten visuellen Identität unter Erstellen effektiver Einträge in AppSource und in Office.

Für ein Mail-Add-In wird das Symbol auf der Benutzeroberfläche "Add-Ins für Datei> verwalten" (Outlook) oder "Einstellungen>Add-Ins verwalten" (Outlook im Web) angezeigt. Bei Inhalts- oder Aufgabenbereich-Add-Ins wird das Symbol in der Benutzeroberfläche Einfügen>Add-Ins angezeigt.

Das Bild wird auch auf der vertikalen Registerkartenleiste für den Aufgabenbereich verwendet, wenn mehr als ein Aufgabenbereich geöffnet ist. Die Registerkartenleiste wird immer neben dem Aufgabenbereich angezeigt, wenn ein zweiter Aufgabenbereich geöffnet wird, unabhängig davon, ob es sich um einen Aufgabenbereich im selben Add-In oder ein anderes Add-In handelt. Die folgende Abbildung zeigt die Registerkartenleiste, wenn das Skript-Lab-Add-In und ein weiteres Add-In gestartet wurden und die Aufgabenbereiche Code und Ausführen von Script Lab geöffnet wurden.

Der obere Zoll eines Aufgabenbereichs mit drei quadratischen Registerkarten rechts von der oberen rechten Ecke. Zwei der Registerkarten verfügen über das Skript-Lab-Symbol. Das dritte verfügt über ein Symbol für ein anderes Add-In.

Für alle Add-In-Typen wird das Symbol auch in AppSource verwendet, wenn Sie Ihr Add-In in AppSource veröffentlichen.

Das Ändern des Werts des IconUrl Elements zur Laufzeit wird derzeit nicht unterstützt.

Beispiele

<IconUrl DefaultValue="https://localhost:3000/assets/images/icon-32.png" />

<IconUrl DefaultValue="https://script-lab.azureedge.net/assets/images/icon-32.png" />