Méthode FormRegionStartup.GetFormRegionManifest (Outlook)
Obtient le manifeste XML pour une zone de formulaire.
Syntaxe
expression. GetFormRegionManifest( _FormRegionName_ , _LCID_ )
Expression Variable qui représente un objet « FormRegionStartup ».
Parameters
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| FormRegionName | Requis | 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 | Obligatoire | Long | 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. |
Valeur renvoyée
Variant 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 Microsoft Outlook 2010 informations de référence sur le schéma XML 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 méthode GetFormRegionIcon 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 souhaitez qu’un complément fournisse le manifeste XML pour une zone de formulaire, spécifiez le ProgID du complément lorsque vous inscrivez la zone de formulaire dans le Registre Windows. Pour plus d’informations sur l’inscription d’une zone de formulaire, voir Spécification de régions de formulaire dans le Registre Windows. Le complément doit implémenter la méthode GetFormRegionManifest de l’interface FormRegionStartup . Notez que si vous ne spécifiez aucun ProgID dans le Registre Windows, Outlook n’appellera 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, voir Procédure : utilisation d’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 :
name : Outlook ignore la valeur spécifiée pour cet élément et utilise le nom spécifié pour la zone de formulaire dans le Registre.
layoutFile : Outlook ignore cet élément, car un complément étend cette zone de formulaire.
addin : Outlook utilise la valeur précédée d’un signe égal (=) dans le Registre comme ProgID du complément.
attribut de fichier de stringOverride : Outlook ignore tout fichier de localisation secondaire spécifié par l’élément stringOverride . Le complément peut implémenter GetFormRegionManifest pour retourner inline le manifeste XML pour la localisation de chaîne pour le LCID spécifié, ou gérer la localisation des chaînes d’une autre manière, par exemple, à l’aide de la localisation .NET Framework, puis retourner le manifeste XML approprié pour le LCID spécifié.
Voir aussi
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.