Метод 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.
См. также
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.