RibbonOfficeMenu Класс (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Предоставляет доступ к элементам управления, добавленным в меню 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 свойству OfficeMenu созданного класса OfficeRibbon. Этот объект используется для добавления новых элементов управления в меню Microsoft Office во время выполнения, а также для обращения к добавленным в меню Microsoft Office элементам.

Элементы управления можно добавлять во время выполнения до загрузки ленты. Создайте экземпляр элемента управления и добавьте его в коллекцию Items. Дополнительные сведения см. в разделе Общие сведения об объектной модели ленты.

Примеры

В следующем примере выполняется итерация по пользовательским элементам управления, находящимся в меню ленты Office, и выводятся их имена. Перед выполнением этого примера выполните следующие действия:

Добавьте элемент Лента (визуальный конструктор) в проект Visual Studio Tools for Office.
Добавьте кнопку к кнопке Microsoft Office.
Установите для свойства (Name) кнопки значение myOfficeMenuButton.
Для свойства Position укажите в поле PositionType значение AfterOfficeID.
Для свойства 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);
    }
}

Иерархия наследования

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonOfficeMenu

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.