Icon 要素

  • [アーティクル]

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

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

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

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

詳細については、「マニフェストでのバージョンの上書き」をご覧ください。

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

  • 親 <VersionOverrides> が Taskpane 1.0 型の場合、AddinCommands 1.1。
  • 親 <VersionOverrides> が Mail 1.0 型の場合、Mailbox 1.3。
  • 親 <VersionOverrides> が Mail 1.1 型の場合、Mailbox 1.5。

属性

属性 必須 説明
xsi:type いいえ 定義されているアイコンの種類。 これは、モバイル フォーム ファクターのアイコンにのみ適用されます。 <Icon>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>