実行時のリボンへのアクセス

[アーティクル]
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

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

リボンの表示、非表示、および変更を行うコードを作成し、そのコードをユーザーがカスタム作業ウィンドウ、操作ウィンドウ、または Outlook フォーム領域のコントロールから実行できるようにすることが可能です。

Globals クラスを使用して、リボンにアクセスできます。Outlook オブジェクトでは、特定の Outlook インスペクタウィンドウに表示されるリボンにアクセスできます。

Globals クラスによるリボンへのアクセス

Globals クラスを使用すると、プロジェクト内の任意の場所からドキュメントレベルのプロジェクトまたはアプリケーションレベルのプロジェクトのリボンにアクセスできます。

Globals クラスの詳細については、「Visual Studio Tools for Office プロジェクト内のオブジェクトへのグローバルアクセス」を参照してください。

次のコード例は、Globals クラスを使用して、Ribbon1 というカスタムリボンにアクセスし、そのリボン上のコンボボックスに表示されるテキストを Hello World に設定します。

Private Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub

private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

Outlook のリボンコレクションへのアクセス

Outlook のインスペクタに表示されるリボンのコレクションにアクセスできます。インスペクタは、ユーザーが電子メールメッセージの作成などの特定のタスクを実行するときに Outlook で開くウィンドウです。インスペクタウィンドウのリボンにアクセスするには、Globals クラスの Ribbons プロパティを呼び出し、インスペクタを表す Inspector オブジェクトを渡します。

次のコード例は、現在フォーカスがあるインスペクタのリボンコレクションを取得します。次に、Ribbon1 という名前のリボンにアクセスし、そのリボン上のコンボボックスに表示されるテキストを Hello World に設定します。

Private Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub

private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}