Рекомендации по созданию областей формы 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

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

Представленные ниже сведения позволяют обеспечить оптимизацию и избежать проблем при использовании областей формы:

Использование имен области формы.
Отключение наследования областей формы.
Общие сведения об именах типов и классов сообщений.
Разработка примыкающих к области чтения областей формы.
Выбор оптимального размера значков.

Дополнительные сведения об областях формы см. в разделе Создание областей форм Outlook.

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

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

Имя области формы	Описание
Имя элемента области формы	Имя, которое задается в диалоговом окне Добавление нового элемента для элемента Область формы Outlook. Это имя файла кода для области формы, которое отображается в обозревателе решений.
Свойство FormRegionName	Это имя задается в мастере Новая область формы Outlook на странице Ввод описания и выбор параметров отображения. Это имя отображается в качестве свойства FormRegionName в окне Свойства. В свойстве FormRegionName содержится метка, определяющая область формы в пользовательском интерфейсе Outlook. Для отдельных областей формы это имя отображается на кнопке ленты в меню Outlook. Для примыкающей области формы это имя отображается в заголовке области формы.
Атрибут Microsoft.Office.Tools.Outlook.FormRegionName	При добавлении элемента Область формы Outlook в проект в Visual Studio Tools for Office этому свойству автоматически присваивается полное имя области формы. По умолчанию полное имя содержит разделенные точкой имя надстройки и имя области формы, например OutlookAddIn1.FormRegion1. Это полное имя также отображается как атрибут в начале класса производства области формы. Атрибут Microsoft.Office.Tools.Outlook.FormRegionName используется для однозначного определения области формы во всех надстройках Outlook. Значение атрибута Microsoft.Office.Tools.Outlook.FormRegionName нельзя изменить посредством переименования области формы или изменения свойства FormRegionName. Чтобы изменить это имя, необходимо изменить атрибут Microsoft.Office.Tools.Outlook.FormRegionName в файле кода области формы.

Имя элемента области формы

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

Свойство FormRegionName

Это имя задается в мастере Новая область формы Outlook на странице Ввод описания и выбор параметров отображения. Это имя отображается в качестве свойства FormRegionName в окне Свойства.

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

Для примыкающей области формы это имя отображается в заголовке области формы.

Атрибут Microsoft.Office.Tools.Outlook.FormRegionName

При добавлении элемента Область формы Outlook в проект в Visual Studio Tools for Office этому свойству автоматически присваивается полное имя области формы. По умолчанию полное имя содержит разделенные точкой имя надстройки и имя области формы, например OutlookAddIn1.FormRegion1.

Это полное имя также отображается как атрибут в начале класса производства области формы.

Атрибут Microsoft.Office.Tools.Outlook.FormRegionName используется для однозначного определения области формы во всех надстройках Outlook. Значение атрибута Microsoft.Office.Tools.Outlook.FormRegionName нельзя изменить посредством переименования области формы или изменения свойства FormRegionName. Чтобы изменить это имя, необходимо изменить атрибут Microsoft.Office.Tools.Outlook.FormRegionName в файле кода области формы.

Отключение наследования областей формы

По умолчанию пользовательский класс сообщений наследует все сопоставления области формы исходного класса сообщений. Например, класс сообщений IPM.Task.Contoso является производным от класса IPM.Task. Следовательно класс IPM.Task.Contoso наследует сопоставления области формы класса IPM.Task.

Если необходимо отменить сопоставления области формы с любым производным классом сообщения, то необходимо задать для свойства ExactMessageClass области формы значение true. Например, сопоставление примыкающей области формы с классом IPM.Task и задание для свойства ExactMessageClass значения true приведет лишь к тому, что область формы будет добавлена к нижней части стандартной формы задач. Область формы не будет добавлена к нижней части любых настраиваемых стандартных форм задач.

Общие сведения об именах типов и классов сообщений

Имена типа и класса сообщений для элемента Outlook различаются. Например, для элемента RSS используется имя типа Microsoft.Office.Interop.Outlook.PostItem. Однако в качестве имени класса сообщений для элемента RSS используется IPM.Post.RSS.

Имя типа используется для ссылки на элемент Outlook в коде. Список имен типов см. в разделе Связывание области формы с классом сообщений Outlook.

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

Разработка примыкающих к области чтения областей формы

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

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

Выделите фрагмент текста в текстовом поле области формы.
Нажмите клавишу DELETE.
Вместо текста в поле удаляется все сообщение.

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

Кроме того, можно присвоить свойству ShowInspectorRead области формы значение False. В этом случае не допускается использование области формы в области чтения.

Выбор оптимального размера значков

В окне Свойства в группе свойств Значки можно определить свойства значков, отображаемых в области формы. Чтобы обеспечить оптимальный внешний вид, следуйте приведенным ниже рекомендациям:

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

Значок страницы отображается на ленте инспектора для элементов, содержащих отдельные замещающие или заменяющие области формы.

Значок окна отображается в области уведомлений и в диалоговом окне переключения между элементами (ALT+TAB) для открытых элементов, содержащих замещающие и заменяющие области формы.