RibbonOfficeMenu 类 (2007 system)

2008-09-04

更新：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 会自动将新的 RibbonOfficeMenu 对象分配给生成的 OfficeRibbon 类的 OfficeMenu 属性。使用此对象可以在运行时将新控件添加到 Microsoft Office 菜单，或者访问已添加到 Microsoft Office 菜单的控件。

可以在运行时添加控件，但只能在加载功能区之前添加。创建该控件的实例，然后将新控件添加到 Items 集合。有关更多信息，请参见功能区对象模型概述。

示例

下面的示例循环访问“功能区”Office 菜单上的自定义控件并显示它们的名称。若要运行此代码示例，必须先执行下列步骤：

将一个“功能区(可视化设计器)”项添加到 Visual Studio Tools for Office 项目。
向“Microsoft Office 按钮”添加一个按钮。
将该按钮的“(Name)”属性设置为 myOfficeMenuButton。
将“PositionType”属性设置为“Position”属性下的“AfterOfficeID”。
将“OfficeID”属性设置为“Position”属性下的“FilePrintMenu”。

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