Icon-Element

Definiert eine Reihe von <Image-Elementen> für Schaltflächen - oder Menüsteuerelemente .

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.

Diesen Anforderungssätzen zugeordnet:

  • AddinCommands 1.1 , wenn die übergeordnete <VersionOverrides> vom Typ Taskbereich 1.0 ist.
  • Postfach 1.3 , wenn die übergeordnete <VersionOverrides> vom Typ Mail 1.0 ist.
  • Postfach 1.5 , wenn die übergeordnete <VersionOverrides> vom Typ Mail 1.1 ist.

Attribute

Attribut Erforderlich Beschreibung
xsi:type Nein Der Typ des Symbols, das definiert wird. Dies gilt nur für Symbole in mobilen Formularfaktoren. <Für Icon-Elemente> , die in einem MobileFormFactor-Element enthalten sind, muss dieses Attribut auf bt:MobileIconListgesetzt 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 länger als 32 Zeichen sein und muss auf den Wert des id-Attributseines<> 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 es sich bei diesem 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.

Weitere Anforderungen für mobile Formularfaktoren

Wenn das übergeordnete <Icon-Element> ein untergeordnetes Element eines MobileFormFactor-Elements ist, unterscheiden sich die erforderlichen Mindestgröß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 Skalierung.

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