次の方法で共有

カスタム タブをリボンに配置する

  • [アーティクル]

アドインのマニフェストでマークアップを使用して、アドインのカスタム タブを Office アプリケーションのリボンに表示する場所を指定できます。

注:

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

重要

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

既定では、リボンの末尾にカスタム タブが追加されます。 ただし、カスタム タブを表示する場所を指定するには、どの組み込み Office タブの横に配置するかを特定し、組み込みタブの左側または右側に配置するかどうかを指定します。アドインがマニフェスト マークアップの詳細に使用するマニフェストの種類のタブを開きます。

注:

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

カスタム タブを配置するには、"extensions.ribbons.tabs" オブジェクトに "position" プロパティを含めます。 "position.builtInTabId" プロパティを、カスタム タブの横に配置する組み込みタブの ID に設定します。 (「 組み込みの Office リボン タブの ID を検索する」を参照してください)。"position.align" プロパティを "before" (左) または "after" (右) に設定します。

次の例では、カスタム タブが [レビュー] タブの直後に表示されるように構成されています。

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        "id": "MyTab",
                        ...
                        "position": {
                            "builtInTabId": "TabReview",
                            "align": "after"
                        }
                    }
                ]
            }
        ]
    }
]

ユーザー アクションがカスタム タブの配置にどのように影響するか

  • ユーザーが同じ場所に対してカスタム タブが構成されている複数のアドインをインストールする場合は、[ レビュー ] タブの後に、最近インストールされたアドインのタブがその場所に配置されます。 以前にインストールしたアドインのタブは、1 か所に移動されます。 たとえば、ユーザーはアドイン A、B、C をその順序でインストールし、すべて [ レビュー ] タブの後にタブを挿入するように構成されます。その後、タブは次の順序で表示されます: Review、 AddinCTab、 AddinBTab、 AddinATab。
  • ユーザーは Office アプリケーションでリボンをカスタマイズできます。 たとえば、ユーザーはアドインのタブを移動または非表示にすることができます。これを防いだり、発生したことを検出したりすることはできません。
  • ユーザーが組み込みタブの 1 つを移動した場合、Office は組み込みタブの既定の場所の観点からマニフェスト内の配置マークアップを解釈します。たとえば、ユーザーが [校繂] タブをリボンの右端に移動した場合、Office は前の例のマークアップを "既定で [レビュー] タブが表示される場所の右側にカスタム タブを配置する" という意味として解釈します。

ドキュメントを開くときにフォーカスがあるタブを指定する

Office では常に、[ ファイル ] タブの右側にあるタブに既定のフォーカスが設定されます。既定では、これは [ ホーム ] タブです。[ ホーム ] タブの前にカスタム タブを構成した場合、ドキュメントが開いたときにカスタム タブにフォーカスが設定されます。

重要

アドインの不便さを過度に目立たせ、ユーザーや管理者を悩ませます。 ユーザーがドキュメントを操作する主な方法がアドインでない限り、[ ホーム ] タブの前にカスタム タブを配置しないでください。

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

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