Especificar la ubicación de un área de formulario en un formulario personalizado

Un área del formulario es una parte de la interfaz de usuario personalizada que se agrega a un formulario. Puede escoger el área del formulario que se mostrará de una manera determinada en un formulario personalizado. Para ello, especificará los elementos formRegionType y displayAfter del esquema XML del área de formulario en el archivo XML de manifiesto del área de formulario correspondiente.

En la página predeterminada

Existen diversas maneras en las que se puede mostrar un área del formulario en la página predeterminada de un formulario estándar.

Para agregar un área de formulario a la página predeterminada

• En el archivo XML del manifiesto del área de formulario, especifique adjoining como el valor para el elemento formRegionType.

El área del formulario se agregará en la parte inferior de la página predeterminada del formulario estándar original, y se mostrará en un inspector o en el panel de lectura.

Por ejemplo, para agregar un área del formulario en la parte inferior de la página predeterminada de un formulario de mensaje estándar, puede especificar el siguiente archivo XML del manifiesto del área de formulario:

<formRegionType>adjoining</formRegionType>

Use el formulario personalizado resultante para mostrar elementos de la misma clase de mensaje que el formulario estándar original, o bien puede asignar una clase de mensaje derivada para el formulario personalizado y usar el formulario personalizado para mostrar solo los elementos de la clase de mensaje derivada.

Para agregar varias regiones de formulario a la página predeterminada

1. Para cada área del formulario, en el archivo XML del manifiesto del área de formulario correspondiente, especifique adjoining como el valor del elemento formRegionType.

2. A excepción del área del formulario que aparecerá como la primera área del formulario en la página predeterminada, para cada una de las otras áreas del formulario, en el archivo XML del manifiesto del área de formulario correspondiente, especifique el nombre interno de ella que precederá a este como el valor del elemento displayAfter.

Use el formulario personalizado resultante para mostrar elementos de la misma clase de mensaje que el formulario estándar original, o bien puede asignar una clase de mensaje derivada para el formulario personalizado y usar el formulario personalizado para mostrar solo los elementos de la clase de mensaje derivada.

El primer área del formulario se agregará a la parte inferior de la página predeterminada del formulario estándar original y se anexará por las demás regiones del formulario en el orden especificado en el elemento displayAfter correspondiente.

Por ejemplo, si desea ordenar tres regiones de formulario, A, B y C, que tengan los nombres internos FormRegionA, FormRegionB y FormRegionC que se mostrarán en el orden A, B y C, especificará lo siguiente en el archivo XML de manifiesto del área de formulario de A:

<formRegionType>adjoining</formRegionType>

Especificará lo siguiente en el archivo XML de manifiesto del área de formulario de B:

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

Especificará lo siguiente en el archivo XML de manifiesto del área de formulario de C:

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

Nota:

Use el elemento displayAfter para especificar el orden de varias regiones de formulario adyacentes en un formulario personalizado. No obstante, este orden solamente es válido en la primera ocasión en que el formulario se muestra al usuario en el equipo local. El usuario tiene la opción de cambiar el orden de las áreas del formulario adyacentes abriendo el formulario y moviendo las áreas del formulario hacia arriba o hacia abajo en la página predeterminada mediante el menú contextual del encabezado del área del formulario. Outlook copia en caché el orden actualizado y usa el orden en memoria caché cuando se vuelva a mostrar el formulario.

Para "reemplazar" toda la página predeterminada por un área de formulario

1. En el archivo XML del manifiesto del área de formulario, se especifica replace como el valor del elemento formRegionType.

2. Cuando registre el área del formulario en el Registro de Windows, en la clave del equipo local (como HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) o la clave del usuario actual (como HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions), cree una clave independiente para la clase de mensaje derivada para esta área del formulario. Agregue un valor del tipo REG_SZ, especificando el nombre interno del área del formulario como el nombre de la clave y el nombre la ruta de acceso local completa al archivo XML del manifiesto del área de formulario como dato para la clave.

Cuando se "reemplaza" la página predeterminada de un formulario estándar, en realidad se está usando un formulario estándar como plantilla y se está creando un nuevo formulario personalizado que tiene el área del formulario como página predeterminada. Si el formulario estándar original contiene otras páginas de formulario o regiones de formulario independientes, permanecerán como parte del formulario personalizado.

Debe asignar una clase de mensaje derivada al formulario personalizado resultante y usar el formulario para mostrar los elementos de esa clase de mensaje.

Por ejemplo, ha creado un área de formulario que tiene el nombre interno CustomPage y el archivo XML de manifiesto del área de formulario CustomPage.xml en c:\Form Regions. Para usar el área del formulario con el fin de reemplazar la página predeterminada del formulario de mensaje estándar, puede especificar el siguiente archivo XML del manifiesto del área de formulario de CustomPage:

<formRegionType>replace</formRegionType>

Cuando registre esta área del formulario en el Registro de Windows, no debe especificar la clase de mensaje del formulario estándar original, IPM.Note, sino una derivada, como por ejemplo IPM.Note.CustomPage. En este ejemplo, registrará el área de formulario en la clave de usuario actual, HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, mediante la creación de una clave IPM. Note.CustomPage. A continuación, agregará un valor del tipo REG_SZ, especificando el nombre interno, CustomPage, del área del formulario como nombre de la clave, y el nombre completo de la ruta de acceso del archivo local al archivo XML de manifiesto del área de formulario, c:\Form Regions\CustomPage.xml, como datos de la clave.

Para "reemplazar" todo el formulario estándar por un área del formulario

1. En el archivo XML del manifiesto del área de formulario, especifique replaceall como el valor del elemento formRegionType.

2. Cuando registre el área del formulario en el Registro de Windows, en la clave del equipo local (como HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) o la clave del usuario actual (como HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions), cree una clave independiente para la clase de mensaje derivada para esta área del formulario. Agregue un valor del tipo REG_SZ, especificando el nombre interno del área del formulario como el nombre de la clave y el nombre la ruta de acceso local completa al archivo XML del manifiesto del área de formulario como dato para la clave.

Cuando se "reemplaza" un formulario estándar completo con un área del formulario, en realidad se está usando un formulario estándar como plantilla y se está creando un nuevo formulario personalizado que tiene el área del formulario como página predeterminada. Si el formulario estándar original contiene otras páginas de formulario o áreas de formulario independientes, no permanecerán como parte del formulario personalizado.

Debe asignar una clase de mensaje derivada al formulario personalizado resultante y usar el formulario para mostrar los elementos de esa clase de mensaje.

Por ejemplo, ha creado un área de formulario que tiene el nombre interno CustomMessage y el archivo XML de manifiesto del área de formulario CustomMessage.xml en c:\Form Regions. Para usar el formulario de mensaje estándar como plantilla para un nuevo formulario personalizado que contenga CustomMessage como la página predeterminada, puede especificar lo siguiente en el archivo XML del manifiesto del área de formulario de CustomMessage:

<formRegionType>replaceall</formRegionType>

Al registrar este área de formulario en el Registro de Windows, especificará una clase de mensaje derivada, como IPM. Note.CustomMessage. En este ejemplo, registrará el área de formulario en la clave de usuario actual, HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, mediante la creación de una clave IPM. Note.CustomMessage. A continuación, agregará un valor del tipo REG_SZ, especificando el nombre interno, CustomMessage, del área del formulario como nombre de la clave, y el nombre completo de la ruta de acceso del archivo local al archivo XML de manifiesto del área de formulario, c:\Form Regions\CustomMessage.xml, como datos de la clave.

En páginas distintas de la página predeterminada

Puede agregar una o más áreas del formulario como páginas independientes a un formulario estándar.

Para agregar un área de formulario como una página independiente

• En el archivo XML del manifiesto del área de formulario, especifique separate como el valor del elemento formRegionType.

El área del formulario se agregará como una página separada detrás de todas las páginas existentes en el formulario estándar original, y se mostrará como una página independiente en el inspector.

Por ejemplo, para agregar un área del formulario como página separada a un formulario de contacto estándar, puede especificar lo siguiente en el archivo XML del manifiesto del área de formulario:

<formRegionType>separate</formRegionType>

El área del formulario se mostrará como una página separada después de las páginas de Todos los campos del formulario de contacto estándar.

Use el formulario personalizado resultante para mostrar elementos de la misma clase de mensaje que el formulario estándar original, o bien puede asignar una clase de mensaje derivada para el formulario personalizado y usar el formulario personalizado para mostrar solo los elementos de la clase de mensaje derivada.

Para agregar varias regiones de formulario como páginas independientes

1. Para cada área del formulario, en el archivo XML del manifiesto del área de formulario correspondiente, especifique separate como el valor del elemento formRegionType.

2. A excepción del área del formulario que aparecerá como la primera área del formulario en el formulario personalizado, para cada una de las otras áreas del formulario, en el archivo XML del manifiesto del área de formulario correspondiente, especifique el nombre interno de ella que precederá a este como el valor del elemento displayAfter.

Use el formulario personalizado resultante para mostrar elementos de la misma clase de mensaje que el formulario estándar original, o bien puede asignar una clase de mensaje derivada para el formulario personalizado y usar el formulario personalizado para mostrar solo los elementos de la clase de mensaje derivada.

El primer área del formulario se agregará como una página independiente del formulario estándar original y se anexará por las demás regiones del formulario en el orden especificado en el elemento displayAfter correspondiente.

Por ejemplo, si desea ordenar tres regiones de formulario independientes, A, B y C, que tienen los nombres internos FormRegionA, FormRegionB y FormRegionC para que se muestren como páginas independientes en el orden A, B y C, especificará lo siguiente en el archivo XML de manifiesto del área de formulario de A:

<formRegionType>separate</formRegionType>

Especificará lo siguiente en el archivo XML de manifiesto del área de formulario de B:

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

Especificará lo siguiente en el archivo XML de manifiesto del área de formulario de C:

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

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.