次の方法で共有

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

  • [アーティクル]

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

注:

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

重要

この記事で説明するアドイン機能は、web、Windows、Mac の PowerPoint でのみ使用できます。

アドインがマニフェスト マークアップの詳細に使用するマニフェストの種類のタブを開きます。

注:

Microsoft 365 の統合マニフェストは、運用環境の Outlook アドインで使用できます。Excel、PowerPoint、Word アドインのプレビューとしてのみ使用できます。

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

組み込みの Office コントロール グループをカスタム タブに挿入するには、" id" プロパティではなく "builtInGroupId" プロパティを持つグループ オブジェクトを、カスタム タブ オブジェクトの "groups" 配列に追加します。 組み込みグループの ID に設定します。 「コントロールとコントロール グループの ID を検索する」を参照してください。 組み込みのグループ オブジェクトには、他のプロパティを含めてはいけません。

次の例では、Office Paragraph コントロール グループをカスタム タブに追加します。

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        "id": "MyTab",
                        ...
                        "groups": [
                            ... // Optionally, other groups in the tab
                            {
                                "builtInGroupId": "Paragraph"
                            },
                            ... // Optionally, other groups in the tab
                        ]
                    }
                ]
            }
        ]
    }
]

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

組み込みの Office コントロールをカスタム グループに挿入するには、" id" プロパティではなく "builtInControlId" プロパティを持つコントロール オブジェクトを、カスタム グループ オブジェクトの "controls" 配列に追加します。 組み込みコントロールの ID に設定します。 「コントロールとコントロール グループの ID を検索する」を参照してください。 組み込みのコントロール オブジェクトには、他のプロパティを含めてはいけません。

次の例では、Office 上付き文字コントロールをカスタム グループに追加します。

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        ...
                        "groups": [
                            {
                                "id": "MyGroup",
                                ...
                                "controls": [
                                    ... // Optionally, other controls in the group
                                    {
                                        "builtInControlId": "Superscript"
                                    },
                                    ... // Optionally, other controls in the group
                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

注:

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

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

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

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

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