カスタム タブをリボンに配置する
アドインのマニフェストでマークアップを使用して、アドインのカスタム タブを Office アプリケーションのリボンに表示する場所を指定できます。
注:
この記事では、 アドイン コマンドの基本的な概念に関する記事を理解していることを前提としています。 最近確認していない場合は、確認してください。
重要
- この記事で説明するアドイン機能とマークアップは、PowerPoint on the webでのみ使用できます。
- この記事で説明するマークアップは、要件セット AddinCommands 1.3 をサポートするプラットフォームでのみ機能します。 以下の「 サポートされていないプラットフォームでの動作」を 参照してください。
カスタム タブを表示する場所を指定するには、どの組み込み Office タブの横に配置するかを指定し、組み込みタブの左側と右側のどちらに配置するかを指定します。アドインのマニフェストの CustomTab 要素に InsertBefore (左) 要素または InsertAfter (右) 要素を含めて、これらの仕様を作成します。 (両方の要素を持つことはできません)。
次の例では、カスタム タブが [レビュー] タブの直後に表示されるように構成されています。InsertAfter> 要素の<値は、組み込みの Office タブの ID であることに注意してください。
<ExtensionPoint xsi:type="ContosoRibbonTab">
<CustomTab id="Contoso.TabCustom2">
<Group id="Contoso.TabCustom2.group2">
<!-- additional markup omitted -->
</Group>
<Label resid="customTabLabel1" />
<InsertAfter>TabReview</InsertAfter>
</CustomTab>
</ExtensionPoint>
次の点に注意してください。
- <InsertBefore> 要素と <InsertAfter> 要素は省略可能です。 どちらも使用しない場合は、カスタム タブがリボンの右端のタブとして表示されます。
- <InsertBefore> 要素と <InsertAfter> 要素は相互に排他的です。 両方を使用することはできません。
- ユーザーが同じ場所に対してカスタム タブが構成されている複数のアドインをインストールする場合は、[ レビュー ] タブの後に、最近インストールされたアドインのタブがその場所に配置されます。 以前にインストールしたアドインのタブは、1 か所に移動されます。 たとえば、ユーザーはアドイン A、B、C をその順序でインストールし、すべて [ レビュー ] タブの後にタブを挿入するように構成されます。その後、タブは次の順序で表示されます: Review、 AddinCTab、 AddinBTab、 AddinATab。
- ユーザーは Office アプリケーションでリボンをカスタマイズできます。 たとえば、ユーザーはアドインのタブを移動または非表示にすることができます。これを防いだり、発生したことを検出したりすることはできません。
- ユーザーが組み込みタブの 1 つを移動した場合、Office は、組み込みタブの既定の場所に関して InsertBefore> 要素と InsertAfter 要素を解釈<します。><たとえば、ユーザーが [校繂] タブをリボンの右端に移動した場合、Office は前の例のマークアップを "既定で [レビュー] タブが表示される場所の右側にカスタム タブを配置する" という意味として解釈します。
ドキュメントを開くときにフォーカスがあるタブを指定する
Office では常に、[ ファイル ] タブの右側にあるタブに既定のフォーカスが設定されます。既定では、これは [ ホーム ] タブです。[ ホーム ] タブの前に カスタム タブを 構成した場合は、 を使用 <InsertBefore>TabHome</InsertBefore>して、ドキュメントが開いたときにカスタム タブにフォーカスが設定されます。
重要
アドインの不便さを過度に目立たせ、ユーザーや管理者を悩ませます。 ユーザーがドキュメントを操作する主な方法がアドインでない限り、[ ホーム ] タブの前にカスタム タブを配置しないでください。
サポートされていないプラットフォームでの動作
要件セット AddinCommands 1.3 をサポートしていないプラットフォームにアドインがインストールされている場合、この記事で説明されているマークアップは無視され、カスタム タブがリボンの右端のタブとして表示されます。 マークアップをサポートしていないプラットフォームにアドインがインストールされないようにするには、マニフェストの [要件>] セクションで<要件セットへの参照を追加します。 手順については、「 アドインをホストできる Office のバージョンとプラットフォームを指定する」を参照してください。 または、「代替エクスペリエンスの設計」で説明されているように、 AddinCommands 1.3 がサポートされていない場合に 代替エクスペリエンスを持つようアドインを設計します。 たとえば、アドインにカスタム タブが必要な場所であることを前提とする命令が含まれている場合は、タブが右端であることを前提とする代替バージョンを使用できます。
Office Add-ins