Обзор ленты

Статья
10/10/2023

Лента — это способ упорядочить связанные команды, чтобы упростить поиск. Команды отображаются как элементы управления на ленте. Элементы управления организованы по группам вдоль горизонтальной полосы в верхней части окна приложения. Связанные группы расположены на вкладках.

Большинство доступных функций с помощью меню и панелей инструментов в более ранних версиях системы Microsoft Office теперь можно получить с помощью ленты. Дополнительные сведения см. в технической статье разработчика пользовательского интерфейса для системы Microsoft Office 2007.

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

Настройка ленты Microsoft Office

Чтобы настроить ленту, добавьте в проект Office один из следующих элементов ленты:

Лента (визуальный конструктор)
Лента (XML)

Например, для настройки ленты Excel добавьте элемент ленты в проект надстройки VSTO для Excel.

Элемент ленты (визуальный конструктор)

Элемент ленты (visual Designer) предоставляет расширенные средства, упрощающие разработку и разработку пользовательской ленты. Используйте элемент ленты (visual Designer), чтобы настроить ленту следующим образом:

Добавление настраиваемых или встроенных вкладок на ленту.
Добавление пользовательских групп на встроенную или пользовательскую вкладку на ленте.

Примечание.

Встроенная вкладка или группа — это та, которая уже существует на ленте microsoft Приложение Office lication. Например, вкладка "Данные" — это встроенная вкладка в Excel. Группа Подключение ions — это встроенная группа на вкладке "Данные".
Добавление пользовательских элементов в пользовательскую группу.
Добавление пользовательских элементов управления в представление Backstage.

Дополнительные сведения о настройке ленты с помощью элемента ленты (visual Designer) см . в конструкторе лент.

Элемент ленты (XML)

Используйте элемент ленты (XML), если вы хотите настроить ленту таким образом, который не поддерживается элементом ленты (визуальный конструктор). Используйте элемент ленты (XML), чтобы настроить ленту следующим образом:

Добавьте встроенные группы на настраиваемую вкладку или встроенную вкладку.
Добавление встроенных элементов управления в пользовательскую группу.
Добавление пользовательского кода для переопределения обработчиков событий встроенных элементов управления.
Настройка панели быстрого доступа.
Совместное использование настройки ленты между надстройками VSTO с помощью полного идентификатора.

Дополнительные сведения о настройке ленты с помощью элемента ленты (XML) см. в разделе XML ленты.

Экспорт ленты из конструктора лент в XML-файл ленты

Если вы создаете ленту с помощью конструктора лент, а затем решите, что вы хотите настроить ленту таким образом, чтобы элемент ленты (визуальный конструктор) не поддерживался, можно экспортировать ленту в XML.

Visual Studio автоматически создает элемент ленты (XML) и заполняет XML-файл ленты элементами и атрибутами для каждого элемента управления на ленте.

Не все свойства, которые находятся в окне свойств конструктора лент, передаются в XML-файл ленты. Например, Visual Studio не экспортирует значение свойства Image или Text . Это связано с тем, что необходимо создать метод обратного вызова в файле кода ленты экспортированного проекта, чтобы указать изображение или текст элемента управления. Visual Studio не создает методы обратного вызова автоматически в процессе экспорта.

Кроме того, все неизмененные значения свойств по умолчанию не отображаются в полученном файле XML-ленты.

Дополнительные сведения о экспорте ленты в XML см. в статье "Практическое руководство. Экспорт ленты из конструктора лент в XML-файл".

Обновление кода

Новый файл кода ленты добавляется в Обозреватель решений. Он содержит класс XML ленты. Вам необходимо создать методы обратного вызова в области Ribbon Callbacks этого класса для обработки действий пользователя, таких как нажатие кнопки. Переместите свой код из обработчиков событий в методы обратного вызова и модифицируйте этот код, чтобы работать с моделью программирования расширения ленты (RibbonX). Дополнительные сведения см. в разделе Ribbon XML.

Вы также должны добавить код в класс ThisAddIn, ThisWorkbook или ThisDocument, который переопределяет метод CreateRibbonExtensibilityObject и возвращает XML-класс ленты в приложение Office.

Дополнительные сведения см. в разделе Ribbon XML.

Добавление нескольких элементов ленты в проект

В один проект можно добавить несколько лент. Это полезно, если вам необходимо выполнить одно из следующих действий.

Создание лент для инспекторов Outlook. Дополнительные сведения см. в разделе "Настройка ленты" для Outlook.

Примечание.

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

Выбор ленты для отображения во время выполнения

Так как проект может содержать несколько лент, можно выбрать ленту для отображения во время выполнения.

Чтобы выбрать ленту для отображения во время выполнения, переопределите CreateRibbonExtensibilityObject метод в ThisAddinThisWorkbookThisDocument или классе проекта и верните ленту, которую вы хотите отобразить. В следующем примере проверка значение поля с именем myCondition и возвращает соответствующую ленту.

Примечание.

Синтаксис, используемый в этом примере, возвращает ленту, созданную с помощью элемента ленты (visual Designer). Синтаксис для возврата ленты, созданной с помощью элемента ленты (XML), немного отличается. Дополнительные сведения о возврате элемента ленты (XML) см. в xml-коде ленты.

Добавьте следующий код:

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon1()})
    Else
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon2()})
    End If
End Function

Заголовок	Description
Практическое руководство. Начало настройки ленты	Показывает, как настроить ленту microsoft Приложение Office lication, добавить элемент ленты (визуальный конструктор) или элемент ленты (XML) в проект Office.
Конструктор лент	Описывает, как использовать конструктор лент для добавления настраиваемых вкладок, групп и элементов управления на ленту microsoft Приложение Office lication.
Пошаговое руководство. Создание настраиваемой вкладки с помощью конструктора лент	Здесь показано, как создать настраиваемую вкладку ленты с помощью конструктора лент. Конструктор лент позволяет добавлять и размещать элементы управления на настраиваемой вкладке.
Обзор объектной модели ленты	Содержит обзор строго типизированной объектной модели, которую можно использовать для получения и задания свойств элементов управления лентой во время выполнения.
Пошаговое руководство. Обновление элементов управления на ленте во время выполнения	Демонстрируется, как использовать объектную модель ленты для обновления элементов управления на ленте после ее загрузки в приложение Office.
Настройка ленты для Outlook	Содержит рекомендации по настройке ленты в Microsoft Office Outlook.
Настройка ленты для InfoPath	Содержит рекомендации по настройке ленты в Microsoft Office InfoPath.
Доступ к ленте во время выполнения	Показывает, как отображать, скрывать и изменять ленту и разрешать пользователям запускать код из элементов управления в пользовательской области задач, области действий или области формы Outlook.
Практическое руководство. Изменение положения вкладки на ленте	Показывает, как изменить порядок вкладок на ленте.
Практическое руководство. Настройка встроенной вкладки	Здесь показано, как добавить группы и элементы управления на встроенную вкладку.
Практическое руководство. Добавление элементов управления в представление Backstage	Показывает, как добавить элементы управления в меню, которое открывается при щелчке файла.
Практическое руководство. Добавление средства запуска диалогового окна в группу ленты	Показывает, как добавить средство запуска диалогового окна в любую группу на ленте.
Практическое руководство. Экспорт ленты из конструктора лент в XML-файл ленты	Показывает, как настроить ленту расширенными способами, экспортируя ленту из конструктора в XML-файл ленты.
Ribbon XML	Объясняет, как настроить ленту с помощью XML-кода ленты.
Пошаговое руководство. Создание настраиваемой вкладки с помощью конструктора лент	Демонстрируется создание настраиваемой вкладки ленты с помощью элемента ленты (XML ).