Icon-Element

Definiert einen Satz von <Bildelementen> für Schaltflächen- oder Menüsteuerelemente .

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.

Diesen Anforderungssätzen zugeordnet:

  • AddinCommands 1.1 , wenn der übergeordnete <VersionOverrides-Typ> Taskpane 1.0 ist.
  • Postfach 1.3 , wenn die übergeordnete <VersionOverrides> den Typ Mail 1.0 hat.
  • Postfach 1.5 , wenn die übergeordnete <VersionOverrides> den Typ Mail 1.1 hat.

Attribute

Attribut Erforderlich Beschreibung
xsi:type Nein Der Typ des Symbols, das definiert wird. Dies gilt nur für Symbole in mobilen Formularfaktoren. <Symbolelementen> , die in einem MobileFormFactor-Element enthalten sind, muss dieses Attribut auf bt:MobileIconListfestgelegt sein.

Untergeordnete Elemente

Element Erforderlich Beschreibung
Image Ja resid-Element eines zu verwendenden Bilds

Bild

Ein Bild für die Schaltfläche. Das resid-Attribut darf nicht mehr als 32 Zeichen lang sein und muss auf den Wert des id-Attributs eines <Image-Elements> im <Images-Element> im Resources-Element festgelegt werden. Das Attribut size gibt die Größe des Bilds in Pixel an. Drei Bildgrößen sind erforderlich (16, 32 und 80 Pixel), es werden aber fünf weitere Größen unterstützt (20, 24, 40, 48 und 64 Pixel).

<Icon>
  <bt:Image size="16" resid="blue-icon-16" />
  <bt:Image size="32" resid="blue-icon-32" />
  <bt:Image size="80" resid="blue-icon-80" />
</Icon>

Wichtig

Wenn dieses 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.

Weitere Anforderungen für mobile Formularfaktoren

Wenn das übergeordnete <Icon-Element> ein Nachfolger eines MobileFormFactor-Elements ist, unterscheiden sich die minimal erforderlichen Größen geringfügig. Das Manifest muss mindestens 25, 32 und 48 Pixelgrößen bereitstellen. Jede bereitgestellte Größe muss mindestens dreimal angezeigt werden, wobei das scale-Attribut auf 1, 2 oder 3 festgelegt ist. Dieses Attribut gibt die UIScreen.scale -Eigenschaft für iOS-Geräte an. Weitere Informationen finden Sie unter Skalieren.

<Icon xsi:type="bt:MobileIconList">
  <bt:Image resid="blue-icon-16" size="25" scale="1" />
  <bt:Image resid="blue-icon-16" size="25" scale="2" />
  <bt:Image resid="blue-icon-16" size="25" scale="3" />
  <bt:Image resid="blue-icon-32" size="32" scale="1" />
  <bt:Image resid="blue-icon-32" size="32" scale="2" />
  <bt:Image resid="blue-icon-32" size="32" scale="3" />
  <bt:Image resid="blue-icon-80" size="48" scale="1" />
  <bt:Image resid="blue-icon-80" size="48" scale="2" />
  <bt:Image resid="blue-icon-80" size="48" scale="3" />
</Icon>