Partager via


Élément Image

Fournit l’URL d’un fichier image utilisé comme icône.

Type de complément : Volet Office, Courrier

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0
  • Mail 1.0
  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Remarque

Vous devez utiliser SSL (Secure Sockets Layer) pour toutes les URL de l’élément <Image> et tous les éléments Override> enfants<.

Chaque icône doit avoir trois <éléments Image> , un pour chacune des trois tailles obligatoires :

  • 16x16
  • 32x32
  • 80x80

Les tailles supplémentaires suivantes sont également prises en charge, mais pas obligatoires.

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

Les formats de fichier image suivants sont pris en charge.

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

Importante

  • Si l’image est l’icône représentative de votre complément, voir Créer des listes effectives dans AppSource et dans Office pour connaître la taille et d’autres exigences.
  • Les compléments Office nécessitent la possibilité de mettre en cache les ressources d’image à des fins de performances. Par conséquent, le serveur qui héberge une ressource d’image ne doit pas ajouter les directives CACHE-CONTROL à l’en-tête de réponse. Ces directives entraînent la substitution automatique par Office d’une image générique ou par défaut. Pour forcer l’utilisation de nouvelles icônes sur votre ordinateur de développement, effacez le cache Office. Pour forcer l’utilisation de nouvelles icônes sur les ordinateurs de votre utilisateur final, vous devez attribuer aux nouvelles icônes des URL différentes des anciennes.

Éléments enfants

Élément Type Description
Override image Fournit un moyen de remplacer l’URL en fonction d’un paramètre régional spécifié.

Exemple

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