RibbonOfficeMenu クラス (2007 System)

2008-08-22

更新 : 2007 年 11 月

Microsoft Office メニューに追加したコントロールにアクセスできるようにします。

名前空間 : Microsoft.Office.Tools.Ribbon
アセンブリ : Microsoft.Office.Tools.Common.v9.0 (Microsoft.Office.Tools.Common.v9.0.dll 内)

構文

'宣言
Public NotInheritable Class RibbonOfficeMenu _
    Inherits RibbonComponent
'使用
Dim instance As RibbonOfficeMenu

public sealed class RibbonOfficeMenu : RibbonComponent

解説

リボン (ビジュアルデザイナ) アイテムをプロジェクトに追加すると、Visual Studio Tools for Office によって、生成される OfficeRibbon クラスの OfficeMenu プロパティに新しい RibbonOfficeMenu オブジェクトが自動的に割り当てられます。実行時に Microsoft Office メニューに新しいコントロールを追加したり、Microsoft Office メニューに追加したコントロールにアクセスしたりするには、このオブジェクトを使用します。

実行時にコントロールを追加できます。ただし、リボンが読み込まれる前に行う必要があります。コントロールのインスタンスを作成した後、新しいコントロールを Items コレクションに追加します。詳細については、「リボンオブジェクトモデルの概要」を参照してください。

例

次の例では、Office のリボンメニューのカスタムコントロールを反復処理してメニュー名を表示します。このコード例を実行するには、最初に次の手順を実行する必要があります。

リボン (ビジュアルデザイナ) アイテムを Visual Studio Tools for Office プロジェクトに追加します。
ボタンを Microsoft Office ボタンに追加します。
ボタンの (Name) プロパティを myOfficeMenuButton に設定します。
Position プロパティにある AfterOfficeID に PositionType プロパティを設定します。
Position プロパティにある FilePrintMenu に OfficeID プロパティを設定します。

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub

private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}