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

HinwBemerkungeneise

Bei einem E-Mail-Add-In wird das Symbol auf der Benutzeroberfläche "Add-Ins für dateiverwalten>" (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 Script Lab-Add-In und ein anderes 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 symbol Script Lab. 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 Bild muss eines der folgenden Dateiformate aufweisen: GIF, JPG, PNG, EXIF, BMP oder TIFF. Für Inhalts- und Aufgabenbereich-Apps müssen angegebene Bilder das Format 32 x 32 Pixel aufweisen. Für Mail-Apps muss die Bildauflösung 64 x 64 Pixel betragen. 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 für Ihre App in Erstellen effektiver Angebote in AppSource und in Office.

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