_FormRegionStartup.GetFormRegionManifest(String, Int32) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Obtient le manifeste XML pour une zone de formulaire.

public:
 System::Object ^ GetFormRegionManifest(System::String ^ FormRegionName, int LCID);

public object GetFormRegionManifest (string FormRegionName, int LCID);

Public Function GetFormRegionManifest (FormRegionName As String, LCID As Integer) As Object

Paramètres

FormRegionName

String

Nom de la zone de formulaire qui correspond au nom utilisé lors de l’inscription de la zone de formulaire dans le Registre Windows.

LCID

Int32

ID de paramètres régionaux qui identifie la langue utilisée par Outlook. Cette valeur permet d’obtenir les chaînes de traduction correspondant à cette langue pour la zone de formulaire.

Retours

Object

Objet qui représente le manifeste XML d’une zone de formulaire. Cette chaîne XML inclut des caractéristiques de la zone de formulaire, telles que le nom d’affichage (tel que spécifié par l’élément title), tout fichier de disposition ou complément associé, toutes les actions utilisateur prises en charge et toutes les chaînes de localisation. Le code XML doit suivre le schéma XML de zone de formulaire. Pour plus d’informations sur le schéma XML de zone de formulaire, consultez la référence du schéma XML Microsoft Outlook 2010 dans MSDN Library.

Remarques

Cette méthode est destinée à être implémentée par un complément et appelée par Outlook. Dans le cadre de l’interface FormRegionStartup , cette méthode et la GetFormRegionIcon(String, Int32, OlFormRegionIcon) méthode fournissent un mécanisme par lequel un complément peut inscrire une zone de formulaire et fournir à Outlook le manifeste XML et les icônes de la zone de formulaire.

Si vous voulez qu’un complément fournisse le manifeste XML pour une zone de formulaire, spécifiez l’identificateur de programme (ProgID) du complément au moment d’inscrire la zone de formulaire dans le Registre Windows. Pour plus d’informations sur l’inscription d’une zone de formulaire, voir Specifying Form Regions in the Windows RegistryGetFormRegionManifest method of the FormRegionStartup interface. Notez que si vous ne spécifiez pas d’identificateur de programme dans le Registre Windows, Outlook n’appelle pas cette méthode.

En ayant recours à un complément afin de fournir le manifeste XML pour une zone de formulaire, vous autorisez également le complément à fournir des icônes pour la zone de formulaire. Le complément doit également implémenter la méthode GetFormRegionIcon de l’interface FormRegionStartup. Outlook appellera GetFormRegionIcon pour obtenir les icônes spécifiées par le complément pour la zone de formulaire. Pour plus d’informations sur l’utilisation d’un complément pour spécifier des icônes, consultez Guide pratique : utiliser un complément pour spécifier des icônes pour une zone de formulaire

Au moment de démarrer, Outlook lit la liste des zones de formulaire dans le Registre Windows et met en cache les données. Sur la base de ces données, si Outlook remarque qu’un complément a été spécifié pour fournir le manifeste XML d’une zone de formulaire, Outlook utilise le ProgID fourni dans les données mises en cache et appelle la méthode GetFormRegionManifest implémentée par ce complément pour obtenir le code XML dont il a besoin pour afficher la zone de formulaire. Si le manifeste XML n’est pas valide et n’est pas conforme au schéma XML de zone de formulaire, Outlook ne peut pas charger la zone de formulaire. En outre, si vous ne spécifiez aucun ProgID dans le Registre Windows, Outlook n’appellera pas les méthodes GetFormRegionManifest et GetFormRegionIcon .

Lorsque le complément fournit le manifeste XML, Outlook ignore les éléments suivants :