Icon 要素

Button コントロールまたは Menu コントロールの Image> 要素の<セットを定義します。

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

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

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

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

次の要件セットに関連付けられています。

• 親 <VersionOverrides が Taskpane 1.0 型の場合、AddinCommands> 1.1。
• 親 <VersionOverrides が「Mail 1.0」と入力されている場合の>メールボックス 1.3。
• 親 <VersionOverrides が「Mail 1.1」と入力されている場合の>メールボックス 1.5。

属性

属性	必須	説明
xsi:type	いいえ	定義されているアイコンの種類。 これは、モバイル フォーム ファクターのアイコンにのみ適用されます。 MobileFormFactor 要素に含まれるアイコン>要素には、この属性を に設定する必要があります。<bt:MobileIconList

子要素

要素	必須	説明
Image	はい	使用するイメージの resid

Image

ボタンの画像です。 resid 属性は 32 文字以内で指定でき、Resources 要素の Images> 要素の<Image> 要素の id 属性の<値に設定する必要があります。 size 属性は、画像のサイズをピクセル単位で示します。 他に 5 つのサイズ (20、24、40、48、64 ピクセル) がサポートされていますが、3 つの画像のサイズ (16、32、80 ピクセル) を必ず指定します。

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

重要

この画像がアドインの代表的なアイコンである場合は、サイズやその他の要件については、「 AppSource と Office 内で有効なリストを作成 する」を参照してください。

モバイル フォーム ファクターの追加要件

親 <Icon> 要素が MobileFormFactor 要素の子孫である場合、最低限必要なサイズは若干異なります。 マニフェストで、最小サイズを 25、32、および 48 ピクセルに指定する必要があります。 指定するサイズは、scale、1 または 2 に設定された 3 属性で必ずそれぞれ 3 回ずつ表示されます。 この属性は、iOS デバイスの UIScreen.scale プロパティを指定します。 詳細については、「 スケール」を参照してください。

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