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

Статья
04/28/2010

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

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

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

Тип проекта

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

Версия Microsoft Office

Outlook 2007

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

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

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

Преимущества областей форм
Добавление в проект области формы Outlook
Использование конструктора области формы
Использование области формы, разработанной в Outlook
Добавление пользовательского кода в область формы
Построение проекта
Отладка области формы
Развертывание области формы

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

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

Настройка страниц по умолчанию любой стандартной формы.
До 12 дополнительных страниц к любой стандартной форме.
Замена или расширение любой стандартной формы.
Отображение настраиваемого пользовательского интерфейса в области чтения и в инспекторе.

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

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

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

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

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

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

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

Тип области	Описание
Отдельная	Добавляет область формы как новую страницу на форме Outlook.
Прилегающая	Добавляет область формы в нижнюю часть страницы по умолчанию формы Outlook.
Заменяющая	Добавляет область формы как новую страницу, заменяющую страницу по умолчанию формы Outlook.
Заменяющая все	Заменяет всю форму Outlook на область формы.

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

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

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

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

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

OSF-файл.

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

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

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

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

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

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

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

Если уже имеется готовая область формы Outlook из другого проекта Visual Studio Tools for Office, ее можно повторно использовать в текущем проекте надстройки 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, выберите его из списка названий методов в верхней части редактора кода. Дополнительные сведения см. в разделе Практическое руководство. Создание обработчиков событий в редакторе кода Visual Basic.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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