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

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

  • Статья

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

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

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

Основные сведения о классах сообщений 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).

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

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

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

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

Bb157886.collapse_all(ru-ru,VS.110).gifИспользование мастера "Новая область формы Outlook".

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

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

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

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

  • Используйте полное имя класса сообщений (например: "IPM.Note.Contoso").

  • Используйте разделители для отделения нескольких имен классов сообщений.

  • Не включайте стандартные классы сообщений Outlook, например, "IPM.Note" или "IPM.Contact".Включайте только пользовательские классы сообщений, например, "IPM.Note.Contoso".

  • Не указывайте основной класс сообщений (например: "IPM").

  • Не превышайте заданное количество символов для каждого класса сообщений (256 символов).

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

ПримечаниеПримечание

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

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

Bb157886.collapse_all(ru-ru,VS.110).gifПрименение атрибутов классов.

Область формы можно связать с классами сообщений 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 выполняет проверку формата имен классов сообщений при построении проекта.

ПримечаниеПримечание

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

См. также

Задачи

Пошаговое руководство. Разработка области формы Outlook

Ссылки

О классе формы имени и сообщений

В outlook форм и элементов взаимодействия

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

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

Рекомендации по созданию областей формы Outlook

Другие ресурсы

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