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

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 isso, especifique os elementos formRegionType e displayAfter do esquema da área de formulário XML do arquivo de manifesto de área de formulário XML 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>

Você pode usar o formulário personalizado resultante para exibir itens da mesma classe de mensagens como o formulário padrão original, ou pode atribuir uma classe derivada de mensagem para o formulário personalizado e usar o formulário personalizado para exibir somente os itens da classe de mensagens derivado.

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

  1. For each form region, in the corresponding form region manifest XML file, specify adjoining as the value of the formRegionType element.

  2. 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.

You can use the resulting custom form to display items of the same message class as the original standard form, or you can assign a derived message class for the custom form and use the custom form to display only items of the derived message class.

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 ordenar três áreas de formulário A, B e C com os nomes internos FormRegionA, FormRegionB e FormRegionC a serem exibidos na ordem A, B e C, você especificará o seguinte no arquivo de manifesto da área de formulário XML de A:

<formRegionType>adjoining</formRegionType>

Você especificará o seguinte no arquivo de manifesto de área de formulário XML de B:

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

You will specify the following in C's form region manifest XML file:

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

Observação Você pode usar 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

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

  2. 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 área de formulário com um nome interno CustomPage e um arquivo de manifesto de área de formulário XML CustomPage.xml em c:\Form Regions. 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. For this example, you will register the form region under the current user key, HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, by creating a key IPM.Note.CustomPage. You will then add a value of the type REG_SZ, specifying the internal name, CustomPage, of the form region as the name of the key, and the full local file path name to the form region manifest XML file, c:\Form Regions\CustomPage.xml, as the data of the key.

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

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

  2. 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 área de formulário com um nome interno CustomMessage e um arquivo de manifesto de área de formulário XML CustomMessage.xml em c:\Form Regions. 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>

When you register this form region in the Windows registry, you will specify a derived message class, such as IPM.Note.CustomMessage. For this example, you will register the form region under the current user key, HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, by creating a key IPM.Note.CustomMessage. You will then add a value of the type REG_SZ, specifying the internal name, CustomMessage, of the form region as the name of the key, and the full local file path name to the form region manifest XML file, c:\Form Regions\CustomMessage.xml, as the data of the key.

Em páginas que não são 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.

Você pode usar o formulário personalizado resultante para exibir itens da mesma classe de mensagem como o formulário padrão original, ou pode atribuir uma classe derivada de mensagem ao formulário personalizado e usar o formulário personalizado para exibir somente os itens da classe de mensagem derivada.

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

  1. For each form region, in the corresponding form region manifest XML file, specify separate as the value of the formRegionType element.

  2. 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.

You can use the resulting custom form to display items of the same message class as the original standard form, or you can assign a derived message class for the custom form and use the custom form to display only items of the derived message class.

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 quiser ordenar três áreas de formulário separadas, A, B e C, com os nomes internos FormRegionA, FormRegionB e FormRegionC a serem exibidas como páginas separadas na ordem A, B e C, você especificará o seguinte no arquivo de manifesto de área de formulário XML de A:

<formRegionType>separate</formRegionType>

Você especificará o seguinte no arquivo de manifesto de área de formulário XML de B:

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

You will specify the following in C's form region manifest XML file:

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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.