Практическое руководство. Экспорт лент из конструктора лент в XML-ленты

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

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

Элемент Лента (визуальный конструктор) поддерживает не все типы настроек ленты. Чтобы получить доступ к дополнительным настройкам лент, можно экспортировать ленту из конструктора в XML-ленту и внести изменения непосредственно в XML.

Примечание.
В файле XML-ленты отображаются не все значения свойств. Дополнительные сведения см. в разделе Обзор ленты.

Чтобы произвести экспорт ленты из конструктора лент в XML-ленты, выполните следующее.

1. В Обозревателе решений щелкните правой кнопкой мыши файл кода ленты и выберите пункт Конструктор представлений.

2. Щелкните конструктор лент правой кнопкой мыши и выберите команду Экспортировать ленту в XML-ленту.

   Visual Studio Tools for Office добавит файл XML-ленты и файл XML-кода ленты к проекту.

3. В классе кода ленты разместите комментарии, начинающиеся с TODO:.

4. Скопируйте фрагмент кода в комментариях в классы ThisAddin, ThisWorkbook или ThisDocument, в зависимости от разрабатываемого типа решения.

   Данный код позволяет приложению Microsoft Office найти и загрузить пользовательскую ленту. Дополнительные сведения см. в разделе XML-ленты.

5. Отмените комментарий в классах ThisAddin, ThisWorkbook или ThisDocument.

   После отмены комментариев код должен выглядеть приблизительно следующим образом. В этом примере класс ленты называется Ribbon1.

   Protected Overrides Function CreateRibbonExtensibilityObject() As  _
   Microsoft.Office.Core.IRibbonExtensibility
       Return New MyRibbon()
   End Function
   

   protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
   {
       return new MyRibbon();
   }
   

6. Переключитесь к файлу XML-кода ленты и найдите область Ribbon Callbacks.

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

7. Создайте метод обратного вызова для каждого обработчика событий, записанного в коде конструктора лент.

8. Переместите весь код обработчика событий из обработчиков событий в методы обратного вызова и измените код для работы с моделью программирования кода расширяемости ленты (RibbonX).

   Дополнительную информацию про создание методов обратного вызова и использование модели программирования RibbonX см. в разделе XML-ленты.

См. также

Задачи

Пошаговое руководство. Создание настраиваемой вкладки с помощью конструктора лент

Пошаговое руководство. Создание настраиваемой вкладки с помощью XML-лент

Основные понятия

Обзор ленты

Конструктор лент

XML-ленты