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 на ленте и отображается их имя. Чтобы запустить этот пример кода, необходимо сначала выполнить следующие действия:

Добавление элемента ленты (visual Designer) в проект Office.
Добавьте кнопку в кнопку Microsoft Office.
Задайте для свойства (Name) кнопки значение myOfficeMenuButton.
Присвойте свойству PositionType значение AfterOfficeID в свойстве Position .
Присвойте свойству OfficeID значение FilePrintMenu в свойстве Position .

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

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

Примечание

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

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

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4 или более поздних ее версий. В проектах, предназначенных для платформы .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	Получает экземпляр IRibbonUI, предоставляемый приложением Microsoft Office коду расширяемости ленты. (Унаследовано от RibbonComponent)
Tag	Получает или задает данные приложения, связанные с этим объектом RibbonComponent. (Унаследовано от RibbonComponent)

Методы

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)

Применяется к

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