次の方法で共有

Group 要素

  • [アーティクル]

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

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

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

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

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

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

属性

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

id 属性

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

子要素

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

Label

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

ヒント

アドインの種類: メール

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

  • メール 1.1

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

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

省略可能。 グループのヒント。 resid 属性は 32 文字以内であり、<String> 要素の id 属性の値に設定する必要があります。 <String> 要素は、Resources 要素の子である <LongStrings>要素の子です。

注:

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

アイコン

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

注:

この子要素は、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

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

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

注:

この子要素は、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」を参照してください。

注:

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

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.CustomTab">
    <Group id="Contoso.CustomTab.group1">
      <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
      <!-- other child elements of the group -->
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>