Especifique o local de uma região de formulário em um formulário personalizado

Artigo
04/07/2023

A form region is a piece of custom user interface that you add to a form. You can designate the form region to be displayed in one of several ways in a custom form. Para fazer isso, você especificará os elementos formRegionType e displayAfter do esquema XML da região do formulário no arquivo XML do manifesto XML da região do formulário correspondente.

Na página padrão

Há várias maneiras de exibir uma área de formulário ou áreas de formulário na página padrão de um formulário padrão.

Para adicionar uma região de formulário à página padrão

In the form region manifest XML file, specify adjoining as the value of the formRegionType element.

A área de formulário será adicionada à parte inferior da página padrão do formulário padrão original e será exibida em um Inspetor ou no Painel de Leitura.

Por exemplo, para adicionar uma área de formulário à parte inferior da página padrão do formulário de mensagem padrão, você pode especificar o seguinte no arquivo de manifesto de área de formulário XML da área de formulário:

<formRegionType>adjoining</formRegionType>

Use o formulário personalizado resultante para exibir itens da mesma classe de mensagem que o formulário padrão original ou você pode atribuir uma classe de mensagem derivada para o formulário personalizado e usar o formulário personalizado para exibir apenas itens da classe de mensagem derivada.

Para adicionar várias regiões de formulário à página padrão

For each form region, in the corresponding form region manifest XML file, specify adjoining as the value of the formRegionType element.
Except for the form region that will appear as the first form region on the default page, for each of the other form regions, in the corresponding form region manifest XML file, specify the internal name of the form region that will precede this one as the value of the displayAfter element.

A primeira região de formulário será adicionada à parte inferior da página padrão do formulário padrão original e será acrescentada pelas outras regiões de formulário na ordem especificada no elemento displayAfter correspondente.

Por exemplo, se você quiser solicitar três regiões de formulário, A, B e C, que tenham os nomes internos FormRegionA, FormRegionB e FormRegionC a serem exibidos na ordem A, B e C, você especificará o seguinte no arquivo XML do manifesto da região de formulário:

<formRegionType>adjoining</formRegionType>

Você especificará o seguinte no arquivo XML do manifesto da região de formulário do B:

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

Você especificará o seguinte no arquivo XML do manifesto da região de formulário do C:

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

Observação

Use o elemento displayAfter para especificar a ordem de várias regiões de formulário adjacentes em um formulário personalizado. However, this order is only valid the first time that the form is displayed for the user on the local computer. The user has the option to change the order of adjoining form regions by opening the form and moving the form regions up or down on the default page through the form region header context menu. Outlook caches the updated order and uses the cached order on subsequent displays of the form.

Para "substituir" toda a página padrão por uma região de formulário

In the form region manifest XML file, specify replace as the value of the formRegionType element.
When you register the form region in the Windows registry, under the local machine key (as HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) or the current user key (as HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions), create a separate key for the derived message class for this form region. Add a value of the type REG_SZ, specifying the internal name of the form region as the name of the key, and the full local file path name to the form region manifest XML file as the data of the key.

When you are "replacing" the default page of a standard form, you are in reality using the standard form as a template and creating a new custom form that has your form region as the default page. Se o formulário padrão original contiver outras páginas de formulário ou regiões de formulário separadas, elas permanecerão como parte do formulário personalizado.

Você deve atribuir uma classe de mensagem derivada ao formulário personalizado resultante e usar o formulário para exibir itens dessa classe de mensagem.

Por exemplo, você criou uma região de formulário que tem o nome interno CustomPage e o arquivo XML do manifesto da região do formulário CustomPage.xml em c:\Regiões de Formulário. To use the form region to replace the default page of the standard Message form, you can specify the following in the form region manifest XML file of CustomPage:

<formRegionType>replace</formRegionType>

When you register this form region in the Windows registry, you must not specify the message class of the original standard form, IPM.Note, but specify a derived message class, such as IPM.Note.CustomPage. Para este exemplo, você registrará a região do formulário na chave de usuário atual, HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, criando um IPM de chave. Note.CustomPage. Em seguida, você adicionará um valor do tipo REG_SZ, especificando o nome interno, CustomPage, da região do formulário como o nome da chave e o nome completo do caminho do arquivo local para o arquivo XML do manifesto da região do formulário, c:\Form Regions\CustomPage.xml, como os dados da chave.

Para "substituir" todo o formulário padrão por uma região de formulário

In the form region manifest XML file, specify replaceall as the value of the formRegionType element.
When you register the form region in the Windows registry, under the local machine key (as HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) or the current user key (as HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions), create a separate key for the derived message class for this form region. Add a value of the type REG_SZ, specifying the internal name of the form region as the name of the key, and the full local file path name to the form region manifest XML file as the data of the key.

When you are "replacing" the entire standard form with a form region, you are in reality using the standard form as a template and creating a new custom form that has the form region as the default page. Se o formulário padrão original contiver outras páginas de formulário ou regiões de formulário separadas, elas não permanecerão como parte do formulário personalizado.

Você deve atribuir uma classe de mensagem derivada ao formulário personalizado resultante e usar o formulário para exibir itens dessa classe de mensagem.

Por exemplo, você criou uma região de formulário que tem o nome interno CustomMessage e o arquivo XML do manifesto da região do formulário CustomMessage.xml em regiões c:\Form. To use the standard Message form as the template for a new custom form that will contain CustomMessage as the default page, you can specify the following in the form region manifest XML file of CustomMessage:

<formRegionType>replaceall</formRegionType>

Ao registrar essa região de formulário no registro do Windows, você especificará uma classe de mensagem derivada, como o IPM. Note.CustomMessage. Para este exemplo, você registrará a região do formulário na chave de usuário atual, HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, criando um IPM de chave. Note.CustomMessage. Em seguida, você adicionará um valor do tipo REG_SZ, especificando o nome interno, CustomMessage, da região do formulário como o nome da chave e o nome completo do caminho de arquivo local para o arquivo XML do manifesto da região do formulário, c:\Form Regions\CustomMessage.xml, como os dados da chave.

Em Páginas Diferentes da Página Padrão

You can add one or more form regions as separate pages to a standard form.

Para adicionar uma região de formulário como uma página separada

In the form region manifest XML file, specify separate as the value of the formRegionType element.

A área de formulário será adicionada como uma página separada após todas as páginas existentes do formulário padrão original e será exibida como uma página autônoma em um Inspetor.

Por exemplo, para adicionar uma área de formulário como uma página separada a um formulário Contato padrão, você pode especificar o seguinte no arquivo de manifesto de área de formulário XML da área de formulário:

<formRegionType>separate</formRegionType>

A área de formulário será exibida como uma página separada depois da página Todos os Campos do formulário Contato padrão.

Para adicionar várias regiões de formulário como páginas separadas

For each form region, in the corresponding form region manifest XML file, specify separate as the value of the formRegionType element.
Except for the form region that will appear as the first form region in the custom form, for each of the other form regions, in the corresponding form region manifest XML file, specify the internal name of the form region that will precede this one as the value of the displayAfter element.

A primeira região de formulário será adicionada como uma página separada do formulário padrão original e será acrescentada pelas outras regiões de formulário na ordem especificada no elemento displayAfter correspondente.

Por exemplo, se você quiser solicitar três regiões de formulário separadas, A, B e C, que tenham os nomes internos FormRegionA, FormRegionB e FormRegionC a serem exibidos como páginas separadas na ordem A, B e C, você especificará o seguinte no arquivo XML do manifesto da região de formulário do A:

<formRegionType>separate</formRegionType>