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

Доступ к ленте во время выполнения

  • Статья

Вы можете написать код, чтобы отобразить, скрыть или изменить ленту и позволить пользователям запускать код из элементов управления в настраиваемой области задач, панели действий или области формы Outlook.

Доступ к ленте осуществляется с помощью класса Globals. Для проектов Outlook можно получить доступ к лентам, которые отображаются в конкретном окне инспектора или проводника Outlook.

Область применения: сведения в этом разделе относятся к проектам на уровне документа и проектам надстроек VSTO для следующих приложений: Excel; InfoPath 2013 и InfoPath 2010; Outlook; Powerpoint; Проекта; Visio; Слово. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

Доступ к ленте с помощью класса Globals

Вы можете использовать класс Globals для доступа к ленте в проекте уровня документа или проекте надстройки VSTO из любого места в проекте.

Дополнительные сведения о классе см. в статье "Глобальный Globals доступ к объектам в проектах Office".

Следующий пример использует класс Globals для доступа к пользовательской ленте с именем Ribbon1 и задает текст Hello World, отображаемый в поле со списком на ленте.

private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

Доступ к коллекции лент, отображаемых в определенном окне инспектора Outlook

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

Следующий пример получает коллекцию лент в инспекторе, в котором фокус находится в данный момент. Пример кода затем получает доступ к ленте Ribbon1 и задает текст Hello World, отображаемый в поле со списком на ленте.

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 void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Связанный контент