画像要素

アイコンとして使用される画像ファイルの URL を指定します。

アドインの種類: 作業ウィンドウ、メール

次の VersionOverrides スキーマでのみ有効です:

  • 作業ウィンドウ 1.0
  • メール 1.0
  • メール 1.1

詳細については、「 アドインのみのマニフェストのバージョンのオーバーライド」を参照してください。

注:

<Image> 要素のすべての URL と子 <Override> 要素には、Secure Sockets Layer (SSL) を使用する必要があります。

各アイコンには、3 つの必須サイズのそれぞれに対して 1 つずつ、3 つの <Image> 要素が必要です。

  • 16x16
  • 32x32
  • 80x80

次の追加サイズもサポートされていますが、必須ではありません。

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

次の画像ファイル形式がサポートされています。

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

重要

  • 画像がアドインの代表的なアイコンである場合、サイズやその他の要件については、「 AppSource と Office 内で効果的なリストを作成する 」を参照してください。
  • Office アドインには、パフォーマンス目的で画像リソースをキャッシュする機能が必要です。 このため、画像リソースをホストするサーバーは、どんな CACHE-CONTROL ディレクティブも応答ヘッダーに追加してはいけません。 これらのディレクティブを使用すると、Office は汎用イメージまたは既定イメージを自動的に置き換えます。 開発用コンピューターで新しいアイコンを強制的に使用されるようにするには、 Office キャッシュをクリアします。 エンドユーザーのコンピューターで新しいアイコンを強制的に使用されるようにするには、新しいアイコンに古いアイコンとは異なる URL を指定する必要があります。
  • ICO 形式はサポートされていません。 これをマニフェストで使用すると、マニフェストの検証に失敗し、アドインはリボンまたはアクション バーに表示されなくなります。

子要素

要素 型 説明
Override image 指定したロケールに応じて URL をオーバーライドする方法を提供します。

例

<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>
  • Last updated on