CustomTab 要素

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

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

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

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

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

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

• AddinCommands 1.1
• AddinCommands 1.3. 一部の子要素で必要です。 子要素を参照してください。

属性

id 属性

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

子要素

グループ

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

OfficeGroup

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

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

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

• 作業ウィンドウ 1.0

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

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

• AddinCommands 1.3

Label (タブ)

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

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

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

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

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

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

• AddinCommands 1.1

InsertAfter

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

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

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

• 作業ウィンドウ 1.0

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

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

• AddinCommands 1.3

InsertBefore

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

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

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

• 作業ウィンドウ 1.0

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

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

• AddinCommands 1.3

例

次の変更履歴とコメントの例では、[Office 段落] コントロール グループをカスタム タブに追加し、カスタム グループの直後に表示されるように配置します。

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <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="PrimaryCommandSurface">
  <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>