組み込みの Office ボタンをカスタム コントロール グループとタブに統合する

  • [アーティクル]

アドインのマニフェストでマークアップを使用して、Office リボンのカスタム コントロール グループに組み込みの Office ボタンを挿入できます。 (カスタム アドイン コマンドを組み込みの Office グループに挿入することはできません)。組み込みの Office コントロール グループ全体をカスタム リボン タブに挿入することもできます。

注:

この記事では、 アドイン コマンドの基本的な概念に関する記事を理解していることを前提としています。 最近確認していない場合は、確認してください。

重要

  • この記事で説明するアドイン機能とマークアップは、PowerPoint on the web、Windows、Mac でのみ使用できます。
  • この記事で説明するマークアップは、要件セット AddinCommands 1.3 をサポートするプラットフォームでのみ機能します。 サポート されていないプラットフォームでの動作については、後のセクションを参照してください。

組み込みのコントロール グループをカスタム タブに挿入する

組み込みの Office コントロール グループをタブに挿入するには、親 <CustomTab> 要素に子要素として OfficeGroup 要素を追加します。 OfficeGroup> 要素の< の属性はid、組み込みグループの ID に設定されます。 「コントロールとコントロール グループの ID を検索する」を参照してください。

次のマークアップ例では、Office Paragraph コントロール グループをカスタム タブに追加し、カスタム グループの直後に表示されるように配置します。

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom1">
    <Group id="Contoso.myCustomTab.group1">
       <!-- additional markup omitted -->
    </Group>
    <OfficeGroup id="Paragraph" />
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

組み込みコントロールをカスタム グループに挿入する

組み込みの Office コントロールをカスタム グループに挿入するには、親 <Group> 要素に子要素として OfficeControl 要素を追加します。 OfficeControl> 要素の<属性はid、組み込みコントロールの ID に設定されます。 「コントロールとコントロール グループの ID を検索する」を参照してください。

次のマークアップ例では、Office 上付き文字コントロールをカスタム グループに追加し、カスタム ボタンの直後に表示されるように配置します。

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group1">
        <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.Button1">
            <!-- Information on the control omitted. -->
        </Control>
        <OfficeControl id="Superscript" />
        <!-- Other controls, as needed. -->
    </Group>
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

注:

ユーザーは Office アプリケーションでリボンをカスタマイズできます。 ユーザーのカスタマイズによって、マニフェスト設定がオーバーライドされます。 たとえば、ユーザーは任意のグループからボタンを削除し、タブから任意のグループを削除できます。

コントロールとコントロール グループの ID を検索する

サポートされているコントロールとコントロール グループの ID は、リポジトリ の Office コントロール ID 内のファイルにあります。 そのリポジトリの ReadMe ファイルの指示に従います。

サポートされていないプラットフォームでの動作

要件セット AddinCommands 1.3 をサポートしていないプラットフォームにアドインがインストールされている場合、この記事で説明するマークアップは無視され、組み込みの Office コントロール/グループはカスタム グループ/タブに表示されません。 マークアップをサポートしていないプラットフォームにアドインがインストールされないようにするには、マニフェストの [要件>] セクションで<要件セットへの参照を追加します。 手順については、「 アドインをホストできる Office のバージョンとプラットフォームを指定する」を参照してください。 または、「代替エクスペリエンスの設計」で説明されているように、 AddinCommands 1.3 がサポートされていない場合にエクスペリエンスを提供するようにアドイン を設計します。 たとえば、組み込みボタンがカスタム グループ内にあることを前提とする命令がアドインに含まれている場合は、組み込みボタンが通常の場所にのみ存在することを前提とするバージョンを設計できます。