Создание областей форм Outlook

Области форм используются для настройки форм Microsoft Office Outlook.Visual Studio предоставляет расширенные средства, которые облегчают проектирование, разработку и отладку областей форм.

Применение. Сведения этого раздела применяются к проектам уровня приложения для Outlook 2013 и Outlook 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

В данном разделе содержатся следующие сведения:

• Преимущества областей форм

• Добавление в проект области формы Outlook

• Использование конструктора области формы

• Использование области формы, разработанной в Outlook

• Добавление пользовательского кода в область формы

• Построение проекта

• Отладка области формы

• Развертывание области формы

Преимущества областей форм

Области форм значительно расширяют возможности обычных форм Outlook.

• Настройка страниц по умолчанию любой стандартной формы.

• До 12 дополнительных страниц к любой стандартной форме.

• Замена или расширение любой стандартной формы.

• Отображение настраиваемого пользовательского интерфейса в области чтения и в инспекторе.

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

Добавление в проект области формы Outlook

Мастер Новая область формы Outlook позволяет создавать новую область формы или импортировать область формы, разработанную ранее в Outlook.Также можно повторно использовать существующую область формы, созданную в другом проекте надстройки Outlook.

Создание новой области формы с помощью мастера

Для создания области формы добавьте в проект надстройки элемент Область формы Outlook.Откроется мастер Новая область формы Outlook.

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

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

Мастеру также можно указать условия отображения и выбрать тип расширения формы.Дополнительные сведения см. в разделе Практическое руководство. Добавление области формы в проект надстройки Outlook.

Вышеуказанные настройки определяют параметры, доступные на других страницах мастера.Например, если на странице Создание новой области формы Outlook выбрать тип области формы Отдельная или Прилегающая, то на странице Ввод описания и выбор параметров отображения станут недоступны поля Заголовок и Описание.поскольку Outlook не использует эти поля при отображении отдельных и прилегающих областей форм.

Файлы области формы

После завершения работы мастера Новая область формы Outlook Visual Studio автоматически добавит в проект следующие файлы:

• Файл с исходным кодом области формы.Этот файл имеет имя, указанное в диалоговом окне Добавление нового элемента для элемента Область формы Outlook.Добавьте в этот файл код для обработки событий области формы.

• Файл с исходным кодом конструктора области формы.Этот файл содержит созданный конструктором области формы код, который не следует изменять непосредственно.

• OSF-файл.

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

Класс фабрики области формы

Файл с исходным кодом области формы содержит разделяемый класс, который реализует интерфейс IFormRegionFactory.Это класс фабрики области формы.Класс фабрики области формы отвечает за создание новых экземпляров области формы.

Найти этот класс можно, развернув область Form Region Factory.

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

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

Добавление в проект существующей области формы

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

Существующая область формы должна быть реализована в VB- или CS-файле. C помощью диалогового окна Добавление существующего элемента нельзя добавить OFS-файлы.Тем не менее, можно создать новую область формы путем импорта OFS-файла.Дополнительные сведения см. в разделе Практическое руководство. Добавление области формы в проект надстройки Outlook.

Использование конструктора области формы

Конструктор области формы помогает спроектировать расположение и внешний вид области формы:перетаскивать управляемые элементы управления на поверхность конструктора, с помощью двойного щелчка элементов управления открывать обработчики событий, устанавливать их свойства в окне Свойства.

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

Конструктор области формы доступен только в том случае, если в мастере Новая область формы Outlook на странице Способ создания области формы была выбрана команда Создать новую область формы.

Существует три способа открыть конструктор области форм:

• Дважды щелкните файл с исходным кодом области формы в обозревателе решений.

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

• В обозревателе решений выделите файл исходного кода области формы, после чего выберите в меню Вид пункт Конструктор.

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

Импорт области формы, разработанной в Outlook

При разработке в Outlook можно использовать собственные элементы управления Outlook на областях формы.Собственные элементы управления Outlook позволяют выполнять привязку данных Outlook в режиме разработки.Однако после этого нельзя использовать конструктор области формы для добавления управляемых элементов управления или изменения структуры области формы.

Мастер Новая область формы Outlook позволяет импортировать области форм в проект надстройки Outlook.На странице Ввод описания и выбор параметров отображения выберите команду Импортировать OFS-файл.Затем необходимо указать расположение OSF-файла.(Outlook сохраняет области форм как OFS-файлы).

Мастер Новая область формы Outlook копирует OFS-файл в каталог проекта и добавляет в файл конструктора области формы ссылки на элементы управления.Затем в файле с исходным кодом области формы можно создавать обработчики событий элементов управления.

Чтобы обработать событие в проекте Visual Basic, выберите его из списка названий методов в верхней части редактора кода.

Чтобы обработать событие элемента управления в проекте C#, подпишитесь на него в методе FormRegionShowing.Дополнительные сведения см. в разделе Практическое руководство. Подписка и отмена подписки на события (Руководство по программированию в C#).

Изменить свойства области формы можно в методе InitializeManifest класса фабрики области формы.

Примечание
Чтобы импортировать область формы, необходимо работать с проектом, предназначенным для версии Outlook, установленной на компьютере разработки.Например, если установлено приложение Outlook 2010, то импорт области формы будет выполняться только в проекте, созданном с помощью шаблона проекта Надстройка Outlook 2010.

Обновление структуры импортированной области формы

Элементы управления на области формы можно добавлять, удалять и изменять.Перед выполнением этих действий создайте резервные копии всего кода, добавленного в файлы области формы.Затем необходимо открыть OSF-файл в Outlook, изменить область формы и сохранить изменения.Для импорта измененных OSF-файлов необходимо использовать мастер Новая область формы Outlook.Затем можно вставить код в файл с кодом области формы.

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

Пространство имен Microsoft.Office.Tools.Outlook обеспечивает доступ к классам, которые представляют область формы, элементу Outlook, отображающему область формы, и другим полезным элементам.Элемент Область формы Outlook автоматически добавит ссылку на эту сборку в проект и вставит соответствующую инструкцию using или Imports в начало файла с кодом области формы.

Классы, методы и свойства пространства имен Microsoft.Office.Interop.Outlook позволяют решить большинство задач при программировании для Outlook.Дополнительные сведения об объектной модели Outlook см. в разделе Общие сведения об объектной модели Outlook.Примеры типичных задач, при которых используется объектная модель Outlook, см. в разделе Решения Outlook.

Обработка событий области формы

Элемент Область формы Outlook автоматически добавляет три следующих обработчика событий в файл с кодом области формы.

Построение проекта

При построении проекта надстройки Outlook, содержащей область формы, Visual Studio добавляет в реестр следующие данные:

• Один раздел на каждый класс сообщений, связанный с одной или несколькими областями форм.

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

Outlook использует эту информацию для загрузки областей форм.

Отладка области формы

Процесс отладки надстройки Outlook, содержащей область формы, происходит аналогично отладке других проектов Visual Studio.При запуске отладчика Visual Studio Visual Studio автоматически запускает Outlook.

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

Развертывание области формы

Области форм развертываются автоматически вместе с соответствующей надстройкой Outlook.Поэтому не требуется выполнять каких-либо действий для развертывания области формы.Дополнительные сведения о развертывании надстроек см. в разделе Развертывание решения Office.

Связанные разделы