RibbonMenu Класс (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)

Синтаксис

'Декларация
<ToolboxBitmapAttribute(GetType(RibbonMenu), "RibbonMenu.bmp")> _
Public NotInheritable Class RibbonMenu _
    Inherits RibbonControl
'Применение
Dim instance As RibbonMenu

[ToolboxBitmapAttribute(typeof(RibbonMenu), "RibbonMenu.bmp")]
public sealed class RibbonMenu : RibbonControl

Заметки

При перетаскивании элемента управления Menu с вкладки Элементы управления ленты Officeпанели элементов в конструктор лент Visual Studio Tools for Office автоматически создаст экземпляр класса RibbonMenu.

Общие задачи

В следующей таблице перечислены члены, используемые при выполнении общих задач. Все приведенные задачи можно выполнять во время разработки. Во время выполнения некоторые из этих задач можно выполнять только перед загрузкой ленты в приложение Office или до того, как элемент управления будет добавлен в динамическое меню. Дополнительные сведения см. в разделе Общие сведения об объектной модели ленты.

Задача	Член
Отображение изображения в меню.	Используйте свойство Image или ImageName. Также можно повторно использовать изображения, которые отображаются на встроенных элементах ленты. Для этого присвойте свойству OfficeImageId значение идентификатора встроенного изображения Microsoft Office, которое необходимо использовать в качестве значка меню.
Изменение размера меню.	Присвойте свойству ControlSize соответствующее значение. Например, для создания крупного меню установите значение Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Изменение размера элементов меню.	Присвойте свойству ItemSize соответствующее значение. Например, для отображения крупных элементов установите значение Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Включение возможности изменения меню (например добавления элементов управления в меню) во время выполнения.	Установите для свойства Dynamic значение true.
Обращение к элементам управления меню, их добавление или удаление.	Используйте свойство Items.
Добавление меню в меню Microsoft Office, группу или другой элемент управления, поддерживающий меню.	Создайте экземпляр класса RibbonMenu с помощью конструктора RibbonMenu, затем добавьте новый объект RibbonMenu к свойству Items меню Microsoft Office, группы или элемента управления.

Примеры

В следующем примере демонстрируется добавление подменю к существующему меню и его заполнение во время выполнения.

Более подробный пример обновления элементов управления во время выполнения и извлечения сведений из демонстрационной базы данных AdventureWorks с использованием LINQ (Language-Integrated Query — запросы, интегрированные в язык программирования) см. в разделе Пошаговое руководство. Обновление элементов управления на ленте во время выполнения.

Перед выполнением этого примера выполните следующие действия:

Добавьте элемент Лента (визуальный конструктор) в проект Visual Studio Tools for Office.
Добавьте группу на пользовательскую вкладку.
Добавьте меню в группу.
Установите для свойства (Name) меню значение CustomerMenu.
Установите для свойства Label меню значение Customers.
Установите для свойства Dynamic меню значение true.

Это дает возможность добавлять и удалять элементы управления в меню во время выполнения после загрузки ленты в приложение Office.

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As New RibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As New RibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(New RibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = new RibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = new RibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}

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

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonMenu

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

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