Group 要素

[アーティクル]
11/08/2023

タブ内の UI コントロールのグループを定義します。カスタムタブでは、アドインは複数のグループを作成できます。アドインは、カスタムタブ 1 つに制限されています。

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

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

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

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

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

AddinCommands 1.1

属性

属性	必須	説明
id	はい	グループの一意の ID。

id 属性

必須です。グループの一意識別子。最大 125 文字の文字列です。これは、マニフェスト内のすべての Group 要素で一意である必要があります。

子要素

要素	必須	説明
Label	はい	グループのラベル。
Icon	はい	グループのイメージ。 Outlook アドインではサポートされていません。
Control	いいえ	Control オブジェクトを表します。 0 以上を指定できます。
OfficeControl	いいえ	組み込みの Office コントロールのいずれかを表します。 0 以上を指定できます。 PowerPoint アドインでのみサポートされます。
OverriddenByRibbonApi	いいえ	カスタムコンテキストタブをサポートするアプリケーションとプラットフォームの組み合わせにグループを表示するかどうかを指定します。 Outlook アドインではサポートされていません。

ラベル

必ず指定します。グループのラベルです。 resid 属性は 32 文字以下であり、Resources 要素の ShortStrings> 要素の<String> 要素の id 属性の<値に設定する必要があります。

アイコン

必須です。タブに多数のグループが含まれており、プログラムウィンドウのサイズが変更された場合は、代わりに指定したイメージが表示されることがあります。

注:

この子要素は、Outlook アドインではサポートされていません。

コントロール

省略可能ですが、存在しない場合は、少なくとも 1 つの <OfficeControl> が必要です。サポートされているコントロールの種類の詳細については、 Control 要素を参照してください。マニフェストの Control> と OfficeControl の順序は交換可能であり、複数の<要素がある場合は混在させることができますが、すべて Icon> 要素の<下にある必要があります。><

<Group id="Contoso.CustomTab1.group1">
    <Label resid="CustomTabGroupLabel"/>
    <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.Button1">
        <!-- information on the control -->
    </Control>
    <!-- other controls, as needed -->
</Group>

OfficeControl

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

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

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

作業ウィンドウ 1.0

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

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

AddinCommands 1.3

注:

この子要素は、PowerPoint アドインでのみサポートされます。

<Group id="Contoso.CustomTab2.group2">
    <Label resid="CustomTabGroupLabel"/>
    <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 -->
    </Control>
    <OfficeControl id="Superscript" />
    <!-- other controls, as needed -->
</Group>

OverriddenByRibbonApi

省略可能 (ブール値)。実行時にリボンにカスタムコンテキストタブを <インストールする API をサポートするアプリケーションとプラットフォームの組み合わせでグループ> を非表示にするかどうかを指定します。既定値 (存在しない場合) はです false。使用する場合、<OverriddenByRibbonApi> は Group> の最初の<子である必要があります。詳細については、「 OverriddenByRibbonApi」を参照してください。

注: