IconUrl 要素

挿入 UX、 AppSource、および作業ウィンドウの垂直タブ バーで Office アドインを表すために使用される、画像の完全な絶対 URL を指定します。

重要

この要素と HighResolutionIconUrl 要素は、 AppSource で配布されるアドインに必要になりました。

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

構文

<IconUrl DefaultValue="string" />

含めることができるもの

• Override

属性

属性	種類	必須	説明
DefaultValue	文字列	はい	この設定の既定値を指定します。この値は、DefaultLocale 要素に指定されるロケールを対象としています。

注釈

画像は次のいずれかのファイル形式である必要があります。

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

画像解像度の要件は次のとおりです。

アドインの種類	解像度 (ピクセル)
コンテンツ	32 x 32
メール	64 x 64
作業ウィンドウ	32 x 32

また、 HighResolutionIconUrl 要素を使用して、高 DPI 画面で実行されている Office クライアント アプリケーションで使用するためのアイコンも指定する必要があります。 詳細については、「AppSource と Office 内で効果的なリストを作成する」の「一貫性のあるビジュアル ID を作成する」セクションを参照してください。

メール アドインの場合、アイコンは [ファイル>アドインの管理] UI (Outlook) または [設定>アドインの管理 UI] (Outlook on the web) に表示されます。 コンテンツ アドインまたは作業ウィンドウ アドインでは、アイコンは、[挿入]>[アドイン] UI に表示されます。

この画像は、複数の作業ウィンドウが開いている場合にも、作業ウィンドウの垂直タブ バーで使用されます。 タブ バーは、同じアドインの作業ウィンドウか別のアドインの作業ウィンドウかに関係なく、2 番目の作業ウィンドウを開くたびに作業ウィンドウの横に表示されます。 次の画像は、Script Lab アドインと別のアドインの両方が起動され、Script Lab の [コード] と [実行] の両方の作業ウィンドウが開かれている場合のタブ バーを示しています。

すべての種類のアドインについて、アドインを AppSource に発行する場合、このアイコンは AppSource でも使用されます。

実行時に IconUrl 要素の値を変更することは、現在サポートされていません。

例

<IconUrl DefaultValue="https://localhost:3000/assets/images/icon-32.png" />

<IconUrl DefaultValue="https://script-lab.azureedge.net/assets/images/icon-32.png" />