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

Метод FormRegionStartup.GetFormRegionManifest (Outlook)

  • Статья

Получает XML-манифест для области формы.

Синтаксис

выражение. GetFormRegionManifest( _FormRegionName_ , _LCID_ )

Выражение Переменная, представляющая объект FormRegionStartup.

Параметры

Имя Обязательный или необязательный Тип данных Описание
FormRegionName Обязательный String Имя области формы, которое используется при регистрации области формы в реестре Windows.
Код языка Обязательный Long Идентификатор языкового стандарта, определяющий язык, используемый Outlook в настоящее время. Это значение используется для получения строк локализации, соответствующих этому языку для области формы.

Возвращаемое значение

Объект Variant, представляющий XML-манифест для области формы. Эта XML-строка содержит характеристики области формы, такие как отображаемое имя (как указано в элементе title), любой связанный файл макета или надстройка, все поддерживаемые действия пользователя и любые строки локализации. XML-код должен соответствовать xml-схеме области формы. Дополнительные сведения о XML-схеме области формы см. в справочнике по XML-схеме Microsoft Outlook 2010, русская версия в библиотека MSDN.

Замечания

Этот метод предназначен для реализации надстройкой и вызова Outlook. В рамках интерфейса FormRegionStartup этот метод и метод GetFormRegionIcon предоставляют механизм, с помощью которого надстройка может зарегистрировать область формы и предоставить Outlook XML-манифест и значки для области формы.

Если вы хотите, чтобы надстройка предоставляла XML-манифест для области формы, укажите ProgID надстройки при регистрации области формы в реестре Windows. Дополнительные сведения о регистрации области формы см. в разделе Указание областей формы в реестре Windows. Надстройка должна реализовывать метод GetFormRegionManifest интерфейса FormRegionStartup . Обратите внимание, что если не указать progID в реестре Windows, Outlook не будет вызывать этот метод.

Использование надстройки для предоставления XML-манифеста для области формы также означает, что вы разрешаете надстройке предоставлять любые значки для области формы. Надстройка также должна реализовывать GetFormRegionIcon интерфейса FormRegionStartup . Outlook вызовет Метод GetFormRegionIcon , чтобы получить все указанные значки надстройки для области формы. Дополнительные сведения об использовании надстройки для указания значков см. в разделе Практическое руководство. Использование надстройки для указания значков для области формы.

При запуске Outlook считывает список областей форм из реестра Windows и кэширует данные. На основе этих данных, если Outlook заметит, что надстройка была указана для предоставления XML-манифеста для области формы, Outlook будет использовать ProgID , указанный в кэшированных данных, и вызовет метод GetFormRegionManifest , реализованный этой надстройкой, чтобы получить XML-код, необходимый для отображения области формы. Если XML-манифест недопустим и не соответствует XML-схеме области формы, Outlook не сможет загрузить область формы. Кроме того, если не указать в реестре Windows никаких идентификаторов ProgID , Outlook не будет вызывать методы GetFormRegionManifest и GetFormRegionIcon .

Outlook игнорирует следующие элементы, когда надстройка предоставляет XML-манифест:

  • name : Outlook игнорирует значение, указанное для этого элемента, и будет использовать имя, указанное для области формы в реестре.

  • layoutFile : Outlook игнорирует этот элемент, так как надстройка расширяет эту область формы.

  • addin : Outlook использует значение, перед которым в реестре стоит знак равенства (=), в качестве идентификатора ProgID надстройки.

  • атрибут файлаstringOverride : Outlook игнорирует любой дополнительный файл локализации, указанный элементом stringOverride . Надстройка может реализовать GetFormRegionManifest, чтобы вернуть встроенный XML-манифест для локализации строк для указанного LCID или управлять локализацией строк другим способом, например с помощью локализации платформа .NET Framework, а затем вернуть соответствующий XML-манифест для указанного LCID.

См. также

Интерфейс FormRegionStartup

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.