Spécifier l’emplacement d’une zone de formulaire dans un formulaire personnalisé

Article
04/07/2023

Une zone de formulaire est un élément d’interface utilisateur personnalisée que vous ajoutez à un formulaire. Vous pouvez désigner la zone de formulaire à afficher dans un formulaire personnalisé de plusieurs manières. Pour ce faire, vous allez spécifier les éléments formRegionType et displayAfter du schéma XML de la zone de formulaire dans le fichier XML manifeste de zone de formulaire correspondant.

Sur la page par défaut

Il existe plusieurs manières d’afficher une ou plusieurs zones de formulaire sur la page par défaut d’un formulaire standard.

Pour ajouter une zone de formulaire à la page par défaut

Dans le fichier XML du manifeste de zone de formulaire, spécifiez adjacent comme valeur de l’élément formRegionType .

La zone de formulaire sera ajoutée au bas de la page par défaut du formulaire standard d’origine et sera affichée dans un Inspecteur ou dans le Volet de lecture.

Par exemple, pour ajouter une zone de formulaire au bas de la page par défaut du formulaire Message standard, vous pouvez spécifier ce qui suit dans le fichier XML de manifeste de la zone de formulaire :

<formRegionType>adjoining</formRegionType>

Utilisez le formulaire personnalisé obtenu pour afficher les éléments de la même classe de message que le formulaire standard d’origine, ou vous pouvez affecter une classe de message dérivée pour le formulaire personnalisé et utiliser le formulaire personnalisé pour afficher uniquement les éléments de la classe de message dérivée.

Pour ajouter plusieurs zones de formulaire à la page par défaut

Pour chaque zone de formulaire, dans le fichier XML manifeste de zone de formulaire correspondant, spécifiez adjacent comme valeur de l’élément formRegionType .
À l’exception de la zone de formulaire qui apparaîtra comme première zone de formulaire sur la page par défaut, pour chaque autre zone de formulaire, dans le fichier XML de manifeste de zone de formulaire, spécifiez le nom interne de la zone de formulaire qui précédera celle-ci en tant que valeur de l’élément displayAfter.

La première zone de formulaire est ajoutée au bas de la page par défaut du formulaire standard d’origine et est ajoutée par les autres zones de formulaire dans l’ordre que vous avez spécifié dans l’élément displayAfter correspondant.

Par exemple, si vous souhaitez commander trois zones de formulaire, A, B et C, qui ont les noms internes FormRegionA, FormRegionB et FormRegionC à afficher dans l’ordre A, B et C, vous devez spécifier les éléments suivants dans le fichier XML manifeste de zone de formulaire de A :

<formRegionType>adjoining</formRegionType>

Vous allez spécifier les éléments suivants dans le fichier XML du manifeste de la zone de formulaire de B :

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

Vous allez spécifier ce qui suit dans le fichier XML du manifeste de la zone de formulaire de C :

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

Remarque

Utilisez l’élément displayAfter pour spécifier l’ordre de plusieurs zones de formulaire adjacentes dans un formulaire personnalisé. Toutefois, cet ordre est valide uniquement lors du premier affichage du formulaire pour l’utilisateur de l’ordinateur local. L’utilisateur a la possibilité de modifier l’ordre des zones de formulaires adjacentes en ouvrant le formulaire et en déplaçant les zones de formulaires vers le haut ou vers le bas sur la page par défaut par le biais du menu contextuel d’en-tête de zone de formulaire. Outlook met en mémoire cache l’ordre mis à jour et utilise l’ordre présent dans le cache lors des affichages ultérieurs du formulaire.

Pour « remplacer » toute la page par défaut par une zone de formulaire

Dans le fichier XML manifeste de zone de formulaire, spécifiez replace comme valeur de l’élément formRegionType .
Lors de l’inscription de la zone de formulaire dans le Registre de Windows, sous la clé d’ordinateur local (comme HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) ou la clé d’utilisateur actif (comme HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions), créez une clé distincte pour la classe de message dérivée pour cette zone de formulaire. Ajoutez une valeur du type REG_SZ, en spécifiant le nom interne de la zone de formulaire comme nom de la clé et le chemin d’accès local complet au fichier XML de manifeste de zone de formulaire comme données de la clé.

Lorsque vous « remplacez » la page par défaut d’un formulaire standard, en réalité vous utilisez le formulaire standard comme modèle et vous créez un nouveau formulaire personnalisé ayant votre zone de formulaire comme page par défaut. Si le formulaire standard d’origine contient d’autres pages de formulaire ou des zones de formulaire distinctes, elles restent dans le formulaire personnalisé.

Vous devez affecter une classe de message dérivée au formulaire personnalisé obtenu et utiliser le formulaire pour afficher les éléments de cette classe de message.

Par exemple, vous avez créé une zone de formulaire avec le nom interne CustomPage et le fichier XML de manifeste de zone de formulaire CustomPage.xml dans c:\Form Regions. Pour faire en sorte que la zone de formulaire remplace la page par défaut du formulaire Message standard, vous pouvez spécifier ce qui suit dans le fichier XML de manifeste de zone de formulaire de CustomPage :

<formRegionType>replace</formRegionType>

Lors de l’inscription de cette zone de formulaire dans le Registre de Windows, vous ne devez pas spécifier la classe de message du formulaire standard d’origine, IPM.Note, mais une classe de message dérivée telle que IPM.Note.CustomPage. Pour cet exemple, vous allez inscrire la zone de formulaire sous la clé utilisateur actuelle, HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, en créant une clé IPM. Remarque.CustomPage. Vous allez ensuite ajouter une valeur du type REG_SZ, en spécifiant le nom interne, CustomPage, de la zone de formulaire comme nom de la clé, et le nom complet du chemin d’accès local au fichier XML du manifeste de zone de formulaire, c:\Form Regions\CustomPage.xml, comme données de la clé.

Pour « remplacer » l’intégralité du formulaire standard par une zone de formulaire

Dans le fichier XML du manifeste de zone de formulaire, spécifiez replaceall comme valeur de l’élément formRegionType .
Lors de l’inscription de la zone de formulaire dans le Registre de Windows, sous la clé d’ordinateur local (comme HKEY_LOCAL_MACHINE\Software\Microsoft\Office\Outlook\FormRegions) ou la clé d’utilisateur actif (comme HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions), créez une clé distincte pour la classe de message dérivée pour cette zone de formulaire. Ajoutez une valeur du type REG_SZ, en spécifiant le nom interne de la zone de formulaire comme nom de la clé et le chemin d’accès local complet au fichier XML de manifeste de zone de formulaire comme données de la clé.

Lorsque vous « remplacez » l’intégralité du formulaire standard par une zone de formulaire, en réalité vous utilisez le formulaire standard comme modèle et vous créez un nouveau formulaire personnalisé ayant la zone de formulaire comme page par défaut. Si le formulaire standard d’origine contient d’autres pages de formulaire ou des zones de formulaire distinctes, elles ne sont pas conservées dans le formulaire personnalisé.

Vous devez affecter une classe de message dérivée au formulaire personnalisé obtenu et utiliser le formulaire pour afficher les éléments de cette classe de message.

Par exemple, vous avez créé une zone de formulaire avec le nom interne CustomMessage et le fichier XML de manifeste de zone de formulaire CustomMessage.xml dans c:\Form Regions. Pour utiliser le formulaire message standard comme modèle pour un nouveau formulaire personnalisé qui contiendra CustomMessage comme page par défaut, vous pouvez spécifier ce qui suit dans le fichier XML manifeste de zone de formulaire de CustomMessage :

<formRegionType>replaceall</formRegionType>

Lorsque vous inscrivez cette zone de formulaire dans le Registre Windows, vous spécifiez une classe de message dérivée, telle qu’IPM. Remarque.CustomMessage. Pour cet exemple, vous allez inscrire la zone de formulaire sous la clé utilisateur actuelle, HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions, en créant une clé IPM. Remarque.CustomMessage. Vous allez ensuite ajouter une valeur du type REG_SZ, en spécifiant le nom interne, CustomMessage, de la zone de formulaire comme nom de la clé, et le nom complet du chemin d’accès local au fichier XML manifeste de zone de formulaire, c:\Form Regions\CustomMessage.xml, comme données de la clé.

Sur les pages autres que la page par défaut

Vous pouvez ajouter une ou plusieurs zones de formulaires à un formulaire standard en tant que pages distinctes.

Pour ajouter une zone de formulaire en tant que page distincte

Dans le fichier XML du manifeste de zone de formulaire, spécifiez distinct comme valeur de l’élément formRegionType .

La zone de formulaire sera ajoutée en tant que page distincte à la suite de toutes les pages existantes du formulaire standard d’origine et sera affichée en tant que page autonome dans un Inspecteur.

Par exemple, pour ajouter une zone de formulaire en tant que page distincte du formulaire Contact standard, vous pouvez spécifier ce qui suit dans le fichier XML de manifeste de la zone de formulaire :

<formRegionType>separate</formRegionType>

La zone de formulaire sera affichée en tant que page distincte après la page Tous les champs du formulaire Contact standard.

Pour ajouter plusieurs zones de formulaire sous forme de pages distinctes

Pour chaque zone de formulaire, dans le fichier XML manifeste de zone de formulaire correspondant, spécifiez distinct comme valeur de l’élément formRegionType .
À l’exception de la zone de formulaire qui apparaîtra comme première zone de formulaire dans le formulaire personnalisé, pour chaque autre zone de formulaire, dans le fichier XML de manifeste de zone de formulaire, spécifiez le nom interne de la zone de formulaire qui précédera celle-ci en tant que valeur de l’élément displayAfter.

La première zone de formulaire est ajoutée en tant que page distincte du formulaire standard d’origine et est ajoutée par les autres zones de formulaire dans l’ordre que vous avez spécifié dans l’élément displayAfter correspondant.

Par exemple, si vous souhaitez commander trois zones de formulaire distinctes, A, B et C, qui ont les noms internes FormRegionA, FormRegionB et FormRegionC à afficher sous forme de pages distinctes dans l’ordre A, B et C, vous devez spécifier les éléments suivants dans le fichier XML du manifeste de zone de formulaire de A :

<formRegionType>separate</formRegionType>