次の方法で共有

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でのみ使用できます。

グループ

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

OfficeGroup

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

重要

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

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

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

  • 作業ウィンドウ 1.0

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

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

Label (タブ)

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

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

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

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

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

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

InsertAfter

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

重要

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

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

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

  • 作業ウィンドウ 1.0

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

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

InsertBefore

省略可能。 指定した組み込み Office タブの直前にカスタム タブを指定します。要素の値は、 TabHome や TabReviewなど、組み込みタブの ID です。 要素の値は、 TabHome や TabReviewなど、組み込みタブの 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>