Поделиться через

RibbonOfficeMenu - интерфейс

  • Статья

Предоставляет доступ к элементам управления, добавленным в меню Microsoft Office.

Пространство имен:  Microsoft.Office.Tools.Ribbon
Сборки:   Microsoft.Office.Tools.Common (в Microsoft.Office.Tools.Common.dll)
  Microsoft.Office.Tools.Common.v4.0.Utilities (в Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Синтаксис

'Декларация
<GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")> _
Public Interface RibbonOfficeMenu _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : RibbonComponent, 
    IComponent, IDisposable

Тип RibbonOfficeMenu предоставляет следующие члены.

Свойства

  Имя Описание
Открытое свойство Items Возврат элементов управления, добавленных в меню Microsoft Office.
Открытое свойство Name Получает или задает имя данного объекта RibbonComponent. (Унаследовано от RibbonComponent.)
Открытое свойство Parent Возврат объекта RibbonComponent, который является родительским для этого объекта RibbonComponent. (Унаследовано от RibbonComponent.)
Открытое свойство Ribbon Возврат объекта верхнего уровня Ribbon, который содержит иерархию элементов управления. (Унаследовано от RibbonComponent.)
Открытое свойство RibbonUI Инфраструктура. Получает экземпляр IRibbonUI, предоставляемый приложением Microsoft Office коду расширяемости ленты. (Унаследовано от RibbonComponent.)
Открытое свойство Site Возвращает или задает объект ISite, связанный с объектом IComponent. (Унаследовано от IComponent.)
Открытое свойство Tag Возврат или установка данных приложения, связанных с этим объектом RibbonComponent. (Унаследовано от RibbonComponent.)

В начало страницы

Методы

  Имя Описание
Открытый метод Dispose Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.)
Открытый метод PerformDynamicLayout Вызов метода Microsoft.Office.Core.IRibbonUI.InvalidateControl родительского элемента управления, если для объекта RibbonComponent существует динамический родительский элемент, например динамическое меню, и размещение не приостановлено. (Унаследовано от RibbonComponent.)
Открытый метод PerformLayout Вызов метода Microsoft.Office.Core.IRibbonUI.InvalidateControl, если для объекта RibbonComponent существует родительский объект, и размещение не приостановлено. (Унаследовано от RibbonComponent.)
Открытый метод ResumeLayout() Отменяет результат вызова метода SuspendLayout. (Унаследовано от RibbonComponent.)
Открытый метод ResumeLayout(Boolean) Отменяет результат вызова метода SuspendLayout. (Унаследовано от RibbonComponent.)
Открытый метод SuspendLayout Запрет на обновление состояния элементов управления ленты в приложении Microsoft Office. (Унаследовано от RibbonComponent.)

В начало страницы

События

  Имя Описание
Открытое событие Disposed Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.)

В начало страницы

Заметки

При добавлении в проект элемента Лента (визуальный конструктор) Visual Studio автоматически присваивает новый объект RibbonOfficeMenu свойству OfficeMenu созданного интерфейса OfficeRibbon. Этот объект используется для добавления новых элементов управления в меню Microsoft Office во время выполнения, а также для обращения к добавленным в меню Microsoft Office элементам.

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

Примечание

Данный интерфейс реализуется набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Использование

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформ .NET Framework 4 и .NET Framework 4.5. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Примеры

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

  1. Добавьте элемент Лента (визуальный конструктор) в проект Office.

  2. Добавьте кнопку к кнопке Microsoft Office.

  3. Установите для свойства (Name) кнопки значение myOfficeMenuButton.

  4. Для свойства Position укажите в поле PositionType значение AfterOfficeID.

  5. Для свойства 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);
    }
}

См. также

Ссылки

Microsoft.Office.Tools.Ribbon - пространство имен

Другие ресурсы

Практическое руководство. Добавление элементов управления в представление Backstage

Общие сведения об объектной модели ленты