Group 要素

[アーティクル]
08/24/2024

タブ内の 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 アドインではサポートされていません。

Label

必ず指定します。グループのラベルです。 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 つの <Control>が必要です。 <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 をサポートするアプリケーションとプラットフォームの組み合わせで、<Group>を非表示にするかどうかを指定します。既定値が存在しない場合は、 false。使用する場合は、<OverriddenByRibbonApi> が <Group> の最初の子である必要があります。詳細については、「 OverriddenByRibbonApi」を参照してください。

注: