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, и выводятся их имена.Перед выполнением этого примера выполните следующие действия:
Добавьте элемент Лента (визуальный конструктор) в проект 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);
}
}
См. также
Ссылки
Microsoft.Office.Tools.Ribbon - пространство имен
Другие ресурсы
Практическое руководство. Добавление элементов управления в представление Backstage