Указание расположения области формы в пользовательской форме

  • Статья

Область формы — это часть пользовательского интерфейса, добавляемая в форму. Область формы, отображаемую в пользовательской форме, можно назначить одним из нескольких способов. Для этого необходимо указать элементы formRegionType и displayAfter xml-схемы области формы в XML-файле манифеста соответствующей области формы.

На странице по умолчанию

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

Добавление области формы на страницу по умолчанию

  • В XML-файле манифеста области формы укажите смежную в качестве значения элемента formRegionType .

Область формы будет добавлена в нижнюю часть страницы по умолчанию исходной стандартной формы и будет отображаться в инспекторе или области чтения.

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

<formRegionType>adjoining</formRegionType>

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

Добавление нескольких областей формы на страницу по умолчанию

  1. Для каждой области формы в соответствующем XML-файле манифеста области формы укажите смежную в качестве значения элемента formRegionType .

  2. За исключением области формы, которая будет отображаться в качестве первой области формы на странице по умолчанию, для каждой из других областей формы в XML-файле манифеста соответствующей области формы укажите внутреннее имя области формы, которая будет предшествовать этой, в качестве значения элемента displayAfter .

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

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

Например, если вы хотите упорядочить три области формы: A, B и C, которые имеют внутренние имена FormRegionA, FormRegionB и FormRegionC , которые должны отображаться в порядке A, B и C, в XML-файле манифеста области формы A укажите следующее:

<formRegionType>adjoining</formRegionType>

В XML-файле манифеста области формы B укажите следующее:

<formRegionType>adjoining</formRegionType>
<displayAfter>FormRegionA</displayAfter>

В XML-файле манифеста области формы C укажите следующее:

<formRegionType>adjoining</formRegionType>
<displayAfter>FormRegionB</displayAfter>

Примечание.

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

Замена всей страницы по умолчанию областью формы

  1. В XML-файле манифеста области формы укажите replace в качестве значения элемента formRegionType .

  2. При регистрации области формы в реестре Windows в разделе локального компьютера ( какHKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) или текущем пользовательском ключе ( какHKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions) создайте отдельный ключ для производного класса сообщений для этой области формы. Добавьте значение типа REG_SZ, указав внутреннее имя области формы в качестве имени ключа и полный локальный путь к XML-файлу манифеста области формы в качестве данных ключа.

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

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

Например, вы создали область формы с внутренним именем CustomPage и XML-файл манифеста области формы, CustomPage.xml в c:\Form Regions. Чтобы использовать область формы для замены страницы по умолчанию стандартной формы сообщения, в XML-файле манифеста области формы customPage можно указать следующее:

<formRegionType>replace</formRegionType>

При регистрации этой области формы в реестре Windows не следует указывать класс сообщений исходной стандартной формы IPM. Обратите внимание, но укажите производный класс сообщений, например IPM. Примечание.CustomPage. В этом примере вы зарегистрируете область формы в текущем ключе пользователя ,HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, создав IPM ключа. Примечание.CustomPage. Затем вы добавите значение типа REG_SZ, указав внутреннее имя , CustomPage, области формы в качестве имени ключа, и полный путь к локальному файлу в XML-файл манифеста области формы , c:\Form Regions\CustomPage.xml, в качестве данных ключа.

"Замена" всей стандартной формы областью формы

  1. В XML-файле манифеста области формы укажите replaceall в качестве значения элемента formRegionType .

  2. При регистрации области формы в реестре Windows в разделе локального компьютера ( какHKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) или текущем пользовательском ключе ( какHKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions) создайте отдельный ключ для производного класса сообщений для этой области формы. Добавьте значение типа REG_SZ, указав внутреннее имя области формы в качестве имени ключа и полный локальный путь к XML-файлу манифеста области формы в качестве данных ключа.

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

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

Например, вы создали область формы с внутренним именем CustomMessage и XML-файл манифеста области формы CustomMessage.xml в c:\Form Regions. Чтобы использовать стандартную форму Сообщения в качестве шаблона для новой настраиваемой формы, которая будет содержать CustomMessage в качестве страницы по умолчанию, в XML-файле манифеста области формы CustomMessage можно указать следующее:

<formRegionType>replaceall</formRegionType>

При регистрации этой области формы в реестре Windows необходимо указать производный класс сообщений, например IPM. Примечание.CustomMessage. В этом примере вы зарегистрируете область формы в текущем ключе пользователя ,HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, создав IPM ключа. Примечание.CustomMessage. Затем вы добавите значение типа REG_SZ, указав внутреннее имя, CustomMessage, области формы в качестве имени ключа, и полный путь к локальному файлу в XML-файл манифеста области формы, c:\Form Regions\CustomMessage.xml, в качестве данных ключа.

На страницах, отличных от страницы по умолчанию

В стандартную форму можно добавить одну или несколько областей формы в виде отдельных страниц.

Добавление области формы в качестве отдельной страницы

  • В XML-файле манифеста области формы укажите отдельное значение элемента formRegionType .

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

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

<formRegionType>separate</formRegionType>

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

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

Добавление нескольких областей формы в качестве отдельных страниц

  1. Для каждой области формы в соответствующем XML-файле манифеста области формы укажите отдельное значение элемента formRegionType .

  2. За исключением области формы, которая будет отображаться в качестве первой области формы в пользовательской форме, для каждой из других областей формы в XML-файле манифеста соответствующей области формы укажите внутреннее имя области формы, которая будет предшествовать этой, в качестве значения элемента displayAfter .

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

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

Например, если вы хотите упорядочить три отдельные области форм: A, B и C, имеющие внутренние имена FormRegionA, FormRegionB и FormRegionC , которые будут отображаться в виде отдельных страниц в порядке A, B и C, в XML-файле манифеста области формы A укажите следующее:

<formRegionType>separate</formRegionType>

В XML-файле манифеста области формы B укажите следующее:

<formRegionType>separate</formRegionType>
<displayAfter>FormRegionA</displayAfter>

В XML-файле манифеста области формы C укажите следующее:

<formRegionType>separate</formRegionType>
<displayAfter>FormRegionB</displayAfter>

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

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