Создание надстроек в Microsoft Office: Справочник по C#

В Office 2013, Office 2010 и Office 2007, есть возможность расширения функционала используя инструменты разработчиков Office в Visual Studio. В них входят шаблоны проектов, помогающие создавать решения Office с использованием Visual Basic и Visual C#, а также визуальные конструкторы, позволяющие создавать настраиваемые пользовательские интерфейсы для решений Office. Рассмотрим создание надстройки для Microsoft Outlook 2010.
Запустите Microsoft Visual Studio и перейдите в «Файл» - «Создать проект». В левой части, открывшегося окна, расположен список разделов установленных шаблонов. Выберете раздел «Office», в центральной части окна, вам будет предложено выбрать один из шаблонов. Выберете шаблон «Надстройка Outlook 2010».

После создания проекта по шаблону, у вас автоматически откроется файл проекта «ThisAddIn.cs».

В обозревателе решений выберете ваш проект и сделайте клик правой клавишей мыши по нему. В открывшемся контекстном меню, выберете пункт «Добавить» - «Компонент…».

У вас откроется окно «Добавление нового элемента – OutlookAddIn1». В левой части окна «Установленные шаблоны», выберете раздел «Office». После выбора данного раздела, в центральной части окна вам будет предложено выбрать элемент для добавления, выберете «Лента (визуальный конструктор)». Нажмите на кнопку «Добавить».

После добавления нового элемента Ribbon (Лента (визуальный конструктор)), у вас откроется новая вкладка «Ribbon1.cs [Конструктор]» в режиме конструктора.

Ribbon или Microsoft Fluent Interface — тип интерфейса в GUI-приложениях, основанный на панелях инструментов, разделенных вкладками. Последние приложения, выпущенные компанией Microsoft, применяют эту форму интерфейса, главной частью которой является модульная лента.
Дополнительную информацию по данному типу интерфейса вы можете получить по адресу: http://ru.wikipedia.org/wiki/Ribbon.

По умолчанию, у вас создается вкладка «TabAddIns (Встроенный)» и в ней группа «group1». Сделайте клик правой клавишей мыши по группе «group1» и выберете из появившегося контекстного меню, пункт «Свойства».

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

Перейдите в «Панель элементов», из предложенного списка «Элементы управления ленты Office» выберете «Button» и добавьте его на группу «group1».

У вас получится приведенный ниже вариант.

Что бы вкладка отображалась в Microsoft Outlook, ей необходимо задать место отображения, это может быть как основное окно, так и отображение только в отдельном окне, например, создания сообщения. Зададим расположение данной вкладки, в ленте основного окна. В конструкторе «Ribbon1.cs», сделайте клик правой клавишей мыши по надписи «Ribbon1» и выберете из появившегося контекстного меню, пункт «Свойства».

У вас откроются свойства самого элемента управления «Ribbon». Найдите свойство «RibbonType». Данное свойство отвечает за определение типов инспекторов Outlook, к которым применяется лента, т.е. где будет отображаться вкладка с кнопкой. Напротив данного свойства присутствует выпадающий список инспекторов Outlook, выберете только «Microsoft.Outlook.Explorer». Данный тип устанавливает отображение вашей вкладки на ленте основного окна Microsoft Outlook.

В конструкторе «Ribbon», сделайте двойной клик по компоненту «Button». Вы перейдете в автоматически созданный метод «button1_Click». Добавьте в него приведенный ниже листинг кода. Данный код создает новое сообщение с заполнением некоторых полей.

Outlook.MailItem mailItem = (Outlook.MailItem)
         OutlookAddIn1.Globals.ThisAddIn.Application.CreateItem(Outlook.OlItemType.olMailItem);
 mailItem.Subject = "Тестовое письмо";
 mailItem.To = "test@csharpcoderr.com";
 mailItem.Body = "Текст сообщения";
 mailItem.Importance = Outlook.OlImportance.olImportanceLow;
 mailItem.Display(false);

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

using Outlook = Microsoft.Office.Interop.Outlook;
using Office = Microsoft.Office.Core;

Для проверки работоспособности вашего проекта, нажмите на клавиатуре клавишу «F5». У вас откроется Microsoft Outlook с вашей вкладкой в главной ленте.

Выберете вашу вкладку и нажмите на единственную кнопку, которую вы добавили. У вас откроется новое сообщение, с заполненными некоторыми полями.

Закройте Microsoft Outlook и остановите отладку вашего проекта. Если вы теперь запустите Microsoft Outlook, вы так же увидите вашу вкладку на ленте главной панели. Для удаления надстройки, необходимо удалить сборку надстройки, записи реестра и параметры безопасности. В противном случае, надстройка будет запускаться каждый раз при открытии Microsoft Outlook, на компьютере разработчика. Все это, можно сделать в два клика. Перейдите в Microsoft Visual Studio, «Построение» - «Очистить OutlookAddIn1».

Дополнительную информацию по данной проблеме вы можете получить по адресу http://msdn.microsoft.com/en-us/library/cc668191.aspx.

Для установки проекта на другие компьютера, вы можете выполнить создание файла установки (Setup.exe). Сделайте клик правой клавишей мыши по вашему решению в обозревателе решений и выберете из появившегося контекстного меню «Добавить» - «Создать проект…».

У вас откроется новое окно «Добавить новый проект». В левой части окна «Установленные шаблоны», выберете раздел «Другие типы проектов» - «Установка и развёртывание» - «Установщик Visual Studio». После выбора данного раздела, в центральной части окна, вам будет предложено выбрать тип шаблона установки, выберете шаблон «Проект установки».

В обозревателе решений у вас появится новый проект установки. Сделайте клик правой клавишей мыши по новому проекту и выберете из появившегося контекстного меню, пункт «Добавить» - «Выходной элемент проекта…».

У вас откроется новое окно «Добавление выходной группы проекта». По умолчанию, у вас выберется ваш проект надстройки, а так же будет предложен список, какие файлы проекта вы можете добавить в файл установщика. Выберете «Основные выходные файлы».

После нажатия кнопки «ОК», в обозревателе решений, в проекте установки, у вас появится список обнаруженных зависимостей, а так же новое свойство проекта «Основные выходные файлы из OutlookAddIn1 (Активный)».

При построении проекта в папке «Debug» у вас создался установочный файл надстройки с расширением *.vsto и дополнительный файл с расширением *.dll.manifest. Эти два файла также необходимо добавить в проект установки.

Манифест сборки(*.dll.manifest).
Любая сборка, статическая или динамическая, содержит коллекцию данных с описанием того, как ее элементы связаны друг с другом. Эти метаданные содержатся в манифесте сборки. Манифест сборки содержит все метаданные, необходимые для задания требований сборки к версиям и удостоверения безопасности, а также все метаданные, необходимые для определения области действия сборки и разрешения ссылок на ресурсы и классы.
Дополнительную информацию вы можете получить по адресу http://msdn.microsoft.com/ru-ru/library/1w45z383(v=vs.110).aspx.

Для добавления этих файлов в проект установки, сделайте клик правой клавишей мыши по проекту установки и выберете из появившегося контекстного меню, пункт «Добавить» - «Файл…».

У вас откроется окно «Добавление файлов», перейдите в выходной каталог «Debug», вашего проекта и выберете два файла, с расширением *.vsto и дополнительный файл с расширением *.dll.manifest.

После нажатия на кнопку «Открыть», в обозревателе решений, в проекте установки, вы увидите имена ваших добавленных файлов.

Нажмите на клавиатуре клавишу «F6», для построения всего решения. А так же в обозревателе решений вашего проекта, сделайте клик правой клавишей мыши по проекту установки «SetupOutlookAddIn» и выберете из появившегося контекстного меню пункт «Построение».

В папке «OutlookAddIn1\SetupOutlookAddIn\Release» вашего проекта, вы найдете файл установки.

Запустите его и следуйте указаниям мастера установки. После успешной установки, перезапустите Microsoft Outlook, если он был запущен или запустите его. На панели вкладок вы увидите вашу надстройку. Так же в «Панель управления» - «Программы и компоненты» (Установка и удаление программ), в списке установленных программ вы найдете вашу надстройку.

Так же можно выполнить установку вашей надстройки и без проекта установщика Visual Studio. Перейдите в каталог «Release» вашего проекта «OutlookAddIn1». Найдите файл с именем «OutlookAddIn1.vsto» и сделайте двойной клик левой клавишей мыши по нему. У вас запустится «Установщик настройки Microsoft Office». Нажмите на кнопку «Установить».

После успешной установки, вы увидите сообщение: «Настройка Microsoft Office успешно установлена».

Чтобы скрыть или удалить вашу надстройку, откройте Microsoft Outlook и перейдите в «Файл» - «Параметры».

В открывшемся окне «Параметры Outlook», выберете в левой части окна раздел «Надстройки». После выбора данного раздела, в правой части окна, откроется список установленных надстроек. Найдите и выберете вашу надстройку, в нижней части окна, расположено поле «Управление», с кнопкой «Перейти», нажмите на нее.

У вас откроется окно «Настройки для модели компонентных объектов (COM)». Для отключения (скрытия) вашей надстройки снимите галочку, расположенную перед именем вашей надстройки. Чтобы удалить вашу надстройку из Microsoft Outlook, выберете вашу надстройку и нажмите на кнопку «Удалить».

После нажатия кнопки «Удалить», ваша надстройка автоматически удалится из панели вкладок. Но если захотите повторно выполнить установку данной надстройки, запуском файла с именем «OutlookAddIn1.vsto», вы получите сообщение «Последняя версия этой настройки уже установлена».

Microsoft Outlook удалил, только ссылки на вашу надстройку. Для полного удаления, зайдите в «Панель управления» - «Программы и компоненты» (Установка и удаление программ). В списке установленных программ вы найдете вашу надстройку, выберете ее и нажмите на кнопку «Удалить». Только после выполнения этих действий ваша надстройка полностью удалится с компьютера.

Ссылка для скачивания примера: Яндекс.Диск