CustomTab 要素

  • [アーティクル]

Office リボンのカスタム タブを定義します。 アドインのリボン コントロールとグループを、いずれかのビルドイン Office タブまたは独自のカスタム タブに追加します。CustomTab> 要素を<使用して、カスタム タブをリボンに追加します。 カスタム タブでは、アドインにカスタム グループまたは組み込みグループを含めることができます。 アドインは、カスタム タブ 1 つに制限されています。

重要

Outlook on Mac では、<CustomTab> 要素は使用できませんが、代わりに組み込みの OfficeTabの 1 つにコントロールのカスタム グループを配置できます。 Outlook の組み込みタブに組み込みグループを配置することはできません。

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

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

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

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

注:

一部の子要素は、メール スキーマでは無効です。 「 子要素」を参照してください。

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

属性

属性 必須 説明
id はい カスタム タブの一意の ID。

id 属性

必須です。 カスタム タブの一意の識別子。最大 125 文字の文字列です。 これはマニフェスト内で一意である必要があります。

子要素

要素 必須 説明
Group いいえ コマンドのグループを定義します。
OfficeGroup いいえ 組み込みの Office コントロール グループを表します。 重要: Outlook では使用できません。
Label はい CustomTab のラベル。
InsertAfter いいえ 指定した組み込み Office タブの直後にカスタム タブを指定します。 重要: PowerPoint でのみ使用できます。
InsertBefore いいえ 指定した組み込みの Office タブの直前にカスタム タブを指定します。 重要: PowerPoint でのみ使用できます。

Group

省略可能ですが、存在しない場合は、少なくとも 1 つの <OfficeGroup> 要素が必要です。 Group 要素を参照してください。 マニフェストの Group> と OfficeGroup の<順序は、カスタム タブに表示する順序にする必要があります。><複数の要素がある場合は混在させることができますが、すべて Label> 要素の上にある<必要があります。

OfficeGroup

省略可能ですが、存在しない場合は、少なくとも 1 つの <Group> 要素が必要です。 組み込みの Office コントロール グループを表します。 id 属性は、組み込みの Office グループの ID を指定します。 組み込みグループの ID を見つけるには、「 コントロールとコントロール グループの ID を検索する」を参照してください。 マニフェストの Group> と OfficeGroup の<順序は、カスタム タブに表示する順序にする必要があります。><複数の要素がある場合は混在させることができますが、すべて Label> 要素の上にある<必要があります。

重要

<OfficeGroup> 要素は Outlook では使用できません。 PowerPoint では、Mac と Windows のプレビュー段階です。ただし、PowerPoint on the webの運用アドインで使用できます。

アドインの種類: 作業ウィンドウ

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

  • 作業ウィンドウ 1.0

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

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

Label (タブ)

必須です。 カスタム タブのラベル。resid 属性は 32 文字以下であり、Resources 要素の ShortStrings> 要素の<String> 要素の id 属性の<値に設定する必要があります。

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

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

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

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

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

InsertAfter

オプション。 指定した組み込み Office タブの直後にカスタム タブを指定します。要素の値は、または TabReviewなどのTabHome組み込みタブの ID です。 組み込みタブの一覧については、「 OfficeTab」を参照してください。 存在する場合は、Label> 要素の後に を指定する<必要があります。 InsertAfter> と InsertBefore の両方<を使用することはできません。><

重要

<InsertAfter> 要素は PowerPoint でのみ使用できます。

アドインの種類: 作業ウィンドウ

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

  • 作業ウィンドウ 1.0

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

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

InsertBefore

オプション。 指定した組み込み Office タブの直前にカスタム タブを指定します。要素の値は、または TabReviewなどのTabHome組み込みタブの ID です。 要素の値は、または TabReviewなどのTabHome組み込みタブの ID です。 組み込みタブの一覧については、「 OfficeTab」を参照してください。 存在する場合は、Label> 要素の後に を指定する<必要があります。 InsertAfter> と InsertBefore の両方<を使用することはできません。><

重要

<InsertBefore> 要素は PowerPoint でのみ使用できます。

アドインの種類: 作業ウィンドウ

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

  • 作業ウィンドウ 1.0

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

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

例

次のマークアップ例では、Office Paragraph コントロール グループをカスタム タブに追加し、カスタム グループの直後に表示されるように配置します。

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.TabCustom1.group1">
       <!-- additional markup omitted -->
    </Group>
    <OfficeGroup id="Paragraph" />
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

次のマークアップ例では、Office 上付き文字コントロールをカスタム グループに追加し、カスタム ボタンの直後に表示されるように配置します。

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom">
    <Group id="Contoso.TabCustom2.group2">
        <Label resid="residCustomTabGroupLabel"/>
        <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>
        <Control xsi:type="Button" id="Contoso.Button2">
            <!-- information on the control omitted -->
        </Control>
        <OfficeControl id="Superscript" />
        <!-- other controls, as needed -->
    </Group>
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>