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

Статья
04/28/2010

Обновлен: Ноябрь 2007

Применение
Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта Проекты уровня документа Проекты уровня приложения Версия Microsoft Office Excel 2007 Word 2007 Outlook 2007 PowerPoint 2007 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office.

Тип проекта

Проекты уровня документа
Проекты уровня приложения

Версия Microsoft Office

Excel 2007
Word 2007
Outlook 2007
PowerPoint 2007

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

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

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

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

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

Дополнительные сведения о классе Globals см. в разделе Глобальный доступ к объектам в Visual Studio Tools for 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";
}