RibbonOfficeMenu インターフェイス

定義

名前空間:

Microsoft.Office.Tools.Ribbon

アセンブリ:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

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

public interface class RibbonOfficeMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")>]
type RibbonOfficeMenu = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonOfficeMenu
Implements IComponent, IDisposable, RibbonComponent

属性

GuidAttribute

実装

RibbonComponent IComponent IDisposable

例

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

1. リボン (Visual Designer) 項目を Office プロジェクトに追加します。

2. Microsoft Office ボタンにボタンを追加します。

3. ボタンの (Name) プロパティを に myOfficeMenuButton設定します。

4. Position プロパティの下の PositionType プロパティを AfterOfficeIDに設定します。

5. Position プロパティの下で OfficeID プロパティを FilePrintMenu に設定します。

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);
    }
}

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

注釈

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

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

注意

これは、Visual Studio Tools for Office Runtime によって実装されたインターフェイスです。 コードに実装されるものではありません。 詳細については、「Visual Studio Tools for Office ランタイムの概要」を参照してください。

使用

ここでは、.NET Framework 4 以降を対象とする Office プロジェクトで使用される型のバージョンについて説明します。 .NET Framework 3.5 を対象とするプロジェクトでは、この型のメンバーが異なること、およびこのコード例が動作しないことがあります。 .NET Framework 3.5 を対象とするプロジェクトの型の詳細については、Visual Studio 2008 ドキュメントの次の参照セクションを参照してください。http://go.microsoft.com/fwlink/?LinkId=160658

プロパティ

Items	Microsoft Office メニューに追加したリボン コントロールを取得します。
Name	この RibbonComponent の名前を取得または設定します。 (継承元 RibbonComponent)
Parent	この RibbonComponent の親を表す RibbonComponent を取得します。 (継承元 RibbonComponent)
Ribbon	コントロール階層を含む最上位 Ribbon オブジェクトを取得します。 (継承元 RibbonComponent)
RibbonUI	Microsoft Office アプリケーションによってリボン機能拡張コードに提供される IRibbonUI のインスタンスを取得します。 (継承元 RibbonComponent)
Tag	この RibbonComponent と関連付けられたアプリケーション固有のデータを取得または設定します。 (継承元 RibbonComponent)

メソッド

PerformDynamicLayout()	RibbonComponent に動的メニューなどの動的な親があり、レイアウトが中断されていない場合に、親コントロールの Microsoft.Office.Core.IRibbonUI.InvalidateControl メソッドを呼び出します。 (継承元 RibbonComponent)
PerformLayout()	に親があり、レイアウトが中断されていない場合に、RibbonComponentMicrosoft.Office.Core.IRibbonUI.InvalidateControl を呼び出します。 (継承元 RibbonComponent)
ResumeLayout()	SuspendLayout() メソッドの実行結果を元に戻します。 (継承元 RibbonComponent)
ResumeLayout(Boolean)	SuspendLayout() メソッドの実行結果を元に戻します。 (継承元 RibbonComponent)
SuspendLayout()	Microsoft Office アプリケーションがリボン上のコントロールの状態を更新しないようにします。 (継承元 RibbonComponent)