Доступ к ленте во время выполнения
Существует возможность написания кода для отображения, скрытия и изменения ленты, а также предоставления пользователям возможности запуска кода из элементов управления настраиваемой области задач, панели действий или области формы Outlook.
Можно получить доступ к ленте с помощью класса Globals.Для проектов Outlook доступ к лентам можно получить в определенном окне инспектора или проводника Outlook.
Применение. Сведения этого раздела применяются к проектам уровня документа и уровня приложения для следующих приложений: Excel 2013 и Excel 2010; InfoPath 2013 и InfoPath 2010; Outlook 2013 и Outlook 2010; PowerPoint 2013 и PowerPoint 2010; Project 2013 и Project 2010; Visio 2013 и Visio 2010; Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.
Доступ к ленте с помощью класса Globals.
Можно использовать класс Globals, чтобы получить доступ к ленте в проекте уровня документа или проекте уровня приложения из любого места в проекте.
Дополнительные сведения о классе Globals см. в разделе Глобальный доступ к объектам в проектах Office.
В следующем примере используется класс Globals, чтобы получить доступ к пользовательской ленте с именем Ribbon1 и задать текст Hello World, отображаемый в поле со списком на ленте.
Private Sub Access_All_Ribbons_Globals()
Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub
private void Access_All_Ribbons_Globals()
{
Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}
Доступ к коллекции лент, отображаемым в определенном окне инспектора Outlook
Можно получить доступ к коллекции лент, появляющихся в Инспекторах Outlook.Инспектор представляет собой окно, открываемое в Outlook при выполнении пользователем определенных действий, например создании сообщений электронной почты.Для доступа к лентам в окне инспектора, необходимо вызвать свойство Ribbons класса Globals и передать ему объект Inspector, представляющий инспектор в качестве параметра.
В следующем примере показано, как получить коллекцию лент в инспекторе, в котором на данный момент находится фокус.Далее в примере производится доступ к ленте под названием Ribbon1 и задается текст Hello World, отображаемый в поле со списком на ленте.
Private Sub Access_Ribbons_By_Inspector()
Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
(Globals.ThisAddIn.Application.ActiveInspector())
ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Inspector()
{
ThisRibbonCollection ribbonCollection =
Globals.Ribbons
[Globals.ThisAddIn.Application.ActiveInspector()];
ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}
Доступ к коллекции лент, отображаемым для определенного проводника Outlook
Можно получить доступ к коллекции лент, отображаемой в проводнике Outlook.Проводник — это основной пользовательский интерфейс приложения для экземпляра Outlook.Для доступа к ленте окна проводника вызовите свойство Ribbons класса Globals и передайте ему объект Explorer, представляющий проводник.
В следующем примере показано, как получить коллекцию лент в проводнике, который на данный момент имеет фокус.Далее в примере производится доступ к ленте под названием Ribbon1 и задается текст Hello World, отображаемый в поле со списком на ленте.
Private Sub Access_Ribbons_By_Explorer()
Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
(Globals.ThisAddIn.Application.ActiveExplorer())
ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Explorer()
{
ThisRibbonCollection ribbonCollection =
Globals.Ribbons
[Globals.ThisAddIn.Application.ActiveExplorer()];
ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}
См. также
Задачи
Пошаговое руководство. Создание настраиваемой вкладки с помощью конструктора лент
Пошаговое руководство. Обновление элементов управления на ленте во время выполнения
Основные понятия
Общие сведения об объектной модели ленты
Доступ к области формы во время выполнения