Utiliser un complément pour spécifier des icônes pour une zone de formulaire

Utilisez un complément pour spécifier les icônes personnalisées que vous souhaitez utiliser pour identifier l’état d’un élément dans l’explorateur, l’inspecteur et le ruban. Par le biais du fichier XML manifeste de zone de formulaire que vous utilisez pour inscrire la zone de formulaire, vous pouvez spécifier le complément qui étend la zone de formulaire et les circonstances dans lesquelles l’icône personnalisée est prévue. Lorsque les cirsumstances spécifiées se produisent, Outlook obtient l’icône appropriée à partir du complément.

Pour utiliser un complément permettant de spécifier une icône pour une zone de formulaire

1. Implémentez l’interface FormRegionStartup .

   Tous les compléments qui étendent les zones de formulaire doivent implémenter l’interface FormRegionStartup . Outlook appelle cette interface afin d’obtenir les données de stockage de disposition pour une zone de formulaire. Pour plus d’informations sur les compléments pour les zones de formulaire, consultez Extension d’une zone de formulaire avec un complément.

   En particulier, pour spécifier des icônes personnalisées, le complément implémente les méthodes GetFormRegionManifest et GetFormRegionIcon de l’interface FormRegionStartup , en spécifiant un fichier XML manifeste de zone de formulaire et les circonstances dans lesquelles Outlook doit afficher des icônes personnalisées dans l’explorateur, l’inspecteur ou le ruban. Par exemple, vous pouvez créer une zone de formulaire pour afficher un type de tâche qui se produit uniquement dans le ménage, et ces tâches ménagères appartiennent à une classe de message, IPM. Task.Household, qui est dérivé d’IPM. Tâche. Vous pouvez étendre la zone de formulaire avec un complément qui spécifie dans la méthode GetFormRegionIcon une icône périodique spéciale qu’Outlook doit afficher en regard des tâches domestiques récurrentes dans l’explorateur.

2. Dans le fichier XML du manifeste de zone de formulaire, spécifiez sous l’élément icons la valeur addin de chacun des éléments enfants où vous souhaitez utiliser une icône personnalisée.

   Quand Outlook affiche des éléments dans l’explorateur ou l’inspecteur, Outlook recherche dans le cache les manifestes de zone de formulaire associés à des éléments de classes de message spécifiques. Lorsqu’un élément enfant de l’élément icons a la valeur addin, Outlook appelle GetFormRegionIcon pour obtenir l’icône correspondante et l’affiche en conséquence pour les éléments de cette classe de message.

   En tant qu’extension du dernier exemple, dans le fichier XML manifeste de zone de formulaire pour la zone de formulaire associée à IPM. Task.Household, vous pouvez spécifier sous l’élément icons , la valeur addin de l’élément enfant récurrent . Lorsqu’Outlook affiche toutes les tâches dans l’explorateur, il recherche dans le manifeste de zone de formulaire mis en cache les éléments appartenant à IPM.Task.Household. Quand Outlook se rend compte que l’élément périodique a la valeur addin, Outlook appelle GetFormRegionIcon pour obtenir l’icône des tâches domestiques récurrentes et affiche dans l’explorateur l’icône récurrente spéciale adjacente à ce type de tâche. Pour plus d’informations sur les éléments enfants de l’élément icons, voir Procédure : spécification d’icônes à afficher pour une zone de formulaire.

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.