リボンの概要

[アーティクル]
04/28/2010

更新 : 2007 年 11 月

対象
このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。プロジェクトの種類ドキュメントレベルのプロジェクトアプリケーションレベルのプロジェクト Microsoft Office のバージョン Excel 2007 Word 2007 Outlook 2007 PowerPoint 2007 詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。

プロジェクトの種類

ドキュメントレベルのプロジェクト
アプリケーションレベルのプロジェクト

Microsoft Office のバージョン

Excel 2007
Word 2007
Outlook 2007
PowerPoint 2007

詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

2007 Microsoft Office system には、リボンと呼ばれる新しいユーザーインターフェイス (UI) 要素が導入されています。Visual Studio Tools for Office を使用して、次のアプリケーションのリボンをカスタマイズできます。

Microsoft Office Excel 2007
Microsoft Office Outlook 2007
Microsoft Office PowerPoint 2007
Microsoft Office Word 2007

Microsoft Office System のリボンについて

リボンとは、関連するコマンドを見つけやすいように整理するための手段です。コマンドは、コントロールとしてリボンに表示されます。コントロールは、アプリケーションウィンドウの上端に水平に表示されるストリップに、グループごとに整理されます。関連するグループは、タブに整理されます。

以前のバージョンの Microsoft Office system で、メニューやツールバーを使用してアクセスしていたほとんどの機能には、このリボンを使用してアクセスできます。詳細については、技術資料「<開発者向け> 2007 Office system のユーザーインターフェイスに関する概要」を参照してください。

Microsoft Office リボンのカスタマイズ

リボンをカスタマイズするには、Visual Studio Tools for Office プロジェクトに次のいずれかのリボン項目を追加します。

リボン (ビジュアルデザイナ)
リボン (XML)

たとえば、Excel のリボンをカスタマイズするには、Excel アドインプロジェクトにリボン項目を追加します。

リボン (ビジュアルデザイナ) 項目

リボン (ビジュアルデザイナ) 項目は、カスタムリボンのデザイン作業と開発作業を容易にするための高度なツールを提供します。リボン (ビジュアルデザイナ) 項目を使用して、次のようにリボンをカスタマイズします。

リボンにカスタムタブまたは組み込みタブを追加します。

カスタムタブまたは組み込みタブにカスタムグループを追加します。

メモ :
組み込みタブまたは組み込みグループは、Microsoft Office アプリケーションのリボンにあらかじめ用意されているものです。たとえば、[データ] タブは、Excel の組み込みタブです。[接続] グループは、[データ] タブの組み込みグループです。

カスタムグループにカスタムコントロールを追加します。
Microsoft Office メニューにカスタムコントロールを追加します。

リボン (ビジュアルデザイナ) 項目を使用してリボンをカスタマイズする方法の詳細については、「リボンデザイナ」を参照してください。

リボン (XML) 項目

リボン (XML) 項目を使用すると、リボン (ビジュアルデザイナ) 項目ではサポートされていない方法でリボンをカスタマイズできます。リボン (XML) 項目を使用して、次のようにリボンをカスタマイズします。

カスタムタブまたは組み込みタブに組み込みグループを追加します。
カスタムグループに組み込みコントロールを追加します。
カスタムコードを追加して、組み込みコントロールのイベントハンドラをオーバーライドします。
クイックアクセスツールバーをカスタマイズします。
修飾識別子を使用して、アドイン間でリボンのカスタマイズを共有します。

リボン (XML) 項目を使用してリボンをカスタマイズする方法の詳細については、「リボン XML」を参照してください。

リボンデザイナからリボン XML へのリボンのエクスポート

リボンデザイナを使用してリボンを作成し、リボン (ビジュアルデザイナ) 項目ではサポートされていない方法でリボンをカスタマイズするには、リボンを XML にエクスポートします。

Visual Studio Tools for Office によって、自動的にリボン (XML) 項目が作成され、リボン XML ファイルが作成されます。リボン XML ファイルには、リボンの各コントロールについて要素と属性が設定されます。

リボンデザイナの [プロパティ] ウィンドウにあるすべてのプロパティがリボン XML ファイルに転送されるわけではありません。たとえば、Visual Studio Tools for Office では、Image プロパティや Text プロパティの値はエクスポートされません。これは、コントロールのイメージを割り当てたり、コントロールのテキストを設定したりするには、エクスポートしたプロジェクトのリボンコードファイルにコールバックメソッドを作成する必要があるためです。Visual Studio Tools for Office で、エクスポートプロセスの一環としてコールバックメソッドが自動的に生成されることはありません。

また、既定値から変更されていない値は、リボン XML ファイルには設定されません。

リボンを XML にエクスポートする方法の詳細については、「方法 : リボンをリボンデザイナからリボン XML にエクスポートする」を参照してください。

コードの更新

新しいリボンコードファイルは、ソリューションエクスプローラに追加されます。このファイルには、リボン XML クラスが含まれています。このクラスの Ribbon Callbacks 領域にコールバックメソッドを作成し、ボタンのクリックなどのユーザーによる操作を処理できます。イベントハンドラからコールバックメソッドにコードを移動し、コードを変更して、リボン機能拡張 (RibbonX) プログラミングモデルで動作するようにコードを変更します。詳細については、「リボン XML」を参照してください。

ThisAddIn、ThisWorkbook、ThisDocument のいずれかのクラスに、CreateRibbonExtensibilityObject メソッドをオーバーライドして Office アプリケーションにリボン XML クラスを返すコードを追加することも必要です。

詳細については、「リボン XML」を参照してください。

プロジェクトへの複数のリボン項目の追加

1 つのプロジェクトに複数のリボン項目を追加することができます。これは、次の 2 つのタスクのうち、いずれかを実行する場合に役立ちます。

Outlook インスペクタにリボンを作成します。

メモ :

インスペクタは、ユーザーが電子メールメッセージの作成などの特定のタスクを実行するときに開くウィンドウです。
実行時に表示するリボンを選択します。

メモ :
インスペクタは、ユーザーが電子メールメッセージの作成などの特定のタスクを実行するときに開くウィンドウです。

Outlook インスペクタ用のリボンの作成

Outlook では、メインのアプリケーションウィンドウにリボンは表示されません。Outlook では、リボンはインスペクタに表示されます。Outlook アドインプロジェクトに対して、各インスペクタのリボンを追加できます。詳細については、「Outlook のリボンのカスタマイズ」を参照してください。

実行時に表示するリボンの選択

1 つのプロジェクトに複数のリボンを含めることができるため、実行時に表示するリボンを選択できます。

実行時に表示するリボンを選択するには、プロジェクトの ThisAddin、ThisWorkbook、ThisDocument のいずれかのクラスの CreateRibbonExtensibilityObject メソッドをオーバーライドし、表示するリボンを返します。次の例では、myCondition というフィールドの値をチェックし、適切なリボンを返します。

メモ :
この例で使用されている構文では、リボン (ビジュアルデザイナ) 項目を使用して作成されたリボンを返します。リボン (XML) 項目を使用して作成されたリボンを返す構文とは、少し異なります。リボン (XML) 項目を返す場合の詳細については、「リボン XML」を参照してください。

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return New Microsoft.Office.Tools.Ribbon.RibbonManager _
            (New Microsoft.Office.Tools.Ribbon.OfficeRibbon() _
                 {New Ribbon1()})
    Else
        Return New Microsoft.Office.Tools.Ribbon.RibbonManager _
            (New Microsoft.Office.Tools.Ribbon.OfficeRibbon() _
                {New Ribbon2()})
    End If
End Function

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon1() });
        }
        else
        {
            return new Microsoft.Office.Tools.Ribbon.RibbonManager(
                new Microsoft.Office.Tools.Ribbon.OfficeRibbon[] 
                    { new Ribbon2() });
        }
    }