Связывание области формы с классом сообщений 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 отображают область формы путем связывания области формы с классом сообщений каждого элемента. Например, если требуется присоединить область формы к нижней части сообщения, то можно связать область формы с классом сообщений IPM.Note.

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

Основные сведения о классах сообщений Outlook

Класс сообщений Outlook определяет тип элемента Outlook. В следующей таблице перечислены восемь стандартных типов элементов и имена их классов сообщений.

Тип элемента Outlook	Имя класса сообщений
AppointmentItem	IPM.Appointment
ContactItem	IPM.Contact
DistListItem	IPM.DistList
JournalItem	IPM.Activity
MailItem	IPM.Note
PostItem	IPM.Post или IPM.Post.RSS
TaskItem	IPM.Task

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

Примечание.
Для замены и групповой замены всех областей форм можно указать новое имя пользовательского класса сообщений. Не нужно использовать имя класса сообщений существующей настраиваемой формы. Имя пользовательского класса имен должно быть уникальным. Один из способов обеспечения уникальности имени — это использование следующего соглашения об именовании: <StandardMessageClassName>.<Company>.<MessageClassName> (например: IPM.Note.Contoso.MyMessageClass).

Для замены и групповой замены всех областей форм можно указать новое имя пользовательского класса сообщений. Не нужно использовать имя класса сообщений существующей настраиваемой формы. Имя пользовательского класса имен должно быть уникальным. Один из способов обеспечения уникальности имени — это использование следующего соглашения об именовании: <StandardMessageClassName>.<Company>.<MessageClassName> (например: IPM.Note.Contoso.MyMessageClass).

Связывание области формы с классом сообщений Outlook

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

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

Использование мастера "Новая область формы Outlook".

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

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

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

При вводе имен необходимо соблюдать следующие рекомендации:

Используйте полное имя класса сообщений (например: "IPM.Note.Contoso").
Используйте разделители для отделения нескольких имен классов сообщений.
Не включайте стандартные классы сообщений Outlook, например, "IPM.Note" или "IPM.Contact". Включайте только пользовательские классы сообщений, например, "IPM.Note.Contoso".
Не указывайте основной класс сообщений (например: "IPM").
Не превышайте заданное количество символов для каждого класса сообщений (256 символов).

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

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

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

Применение атрибутов классов.

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

В следующем примере показаны два атрибута FormRegionMessageClassAttribute, прикрепленные к классу фабрики области формы под названием myFormRegion. Первый атрибут связывает область формы со стандартным классом сообщений для формы сообщений. Второй атрибут связывает область формы с пользовательским классом сообщения под названием IPM.Task.Contoso.

<Microsoft.Office.Tools.Outlook.FormRegionMessageClass(Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)> _
<Microsoft.Office.Tools.Outlook.FormRegionMessageClass("IPM.Task.Contoso")> _
<Microsoft.Office.Tools.Outlook.FormRegionName("Trin_Outlook_FR_Attributes.FormRegion1")> _
Partial Public Class FormRegion1Factory

' Occurs before the form region is initialized.
' To prevent the form region from appearing, set e.Cancel to true.
' Use e.OutlookItem to get a reference to the current Outlook item.
    Private Sub FormRegion1Factory_FormRegionInitializing(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) Handles Me.FormRegionInitializing

End Sub

[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
    (Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)]
[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
    ("IPM.Task.Contoso")]
[Microsoft.Office.Tools.Outlook.FormRegionName
    ("Trin_Outlook_FR_Attributes.FormRegion1")]
public partial class FormRegion1Factory
{
    // Occurs before the form region is initialized.
    // To prevent the form region from appearing, set e.Cancel to true.
    // Use e.OutlookItem to get a reference to the current Outlook item.
    private void FormRegion1Factory_FormRegionInitializing(object sender, 
        Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs e)
    {
    }
}

Атрибуты должны соответствовать следующим рекомендациям:

Для пользовательских классов сообщений используйте полное имя класса сообщений (например: "IPM.Note.Contoso").
Не указывайте основной класс сообщений (например: "IPM").
Не превышайте заданное количество символов для каждого класса сообщений (256 символов).
Не включайте имена стандартных классов сообщений, если область формы производит замену всей формы или заданной по умолчанию страницы формы. Можно указать имена стандартных классов сообщений только для форм, добавляющих новую страницу к форме или прикрепленных в нижней части формы. Дополнительные сведения см. в разделе Практическое руководство. Добавление области формы в проект надстройки Outlook.

Visual Studio Tools for Office выполняет проверку формата имен классов сообщений при построении проекта.

Примечание.
Visual Studio Tools for Office выполняет проверку правильности или допустимости имен классов сообщений.

См. также

Поделиться через

Связывание области формы с классом сообщений Outlook

Основные сведения о классах сообщений Outlook

Связывание области формы с классом сообщений Outlook

Использование мастера "Новая область формы Outlook".

Применение атрибутов классов.

См. также

Задачи

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

Ссылки

Дополнительные ресурсы