Directives pour la création de zones de formulaire Outlook
Les informations suivantes peuvent vous aider à optimiser vos zones de formulaire et éviter d'éventuels problèmes :
Utilisation des noms de zone de formulaire.
Désactivation de l'héritage de zone de formulaire.
Fonctionnement des noms de type et des noms de classe de message.
Conception de zones de formulaire adjacentes pour le volet de lecture.
Utilisation de tailles d'icône optimales.
Pour plus d'informations sur les zones de formulaire, consultez Création de zones de formulaire Outlook.
S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau application pour Outlook 2013 et Outlook 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.
Utilisation des noms de zone de formulaire
Plusieurs noms sont utilisés pour décrire la zone de formulaire.Il est important de comprendre la différence entre ces noms et leur impact sur la zone de formulaire.Le tableau suivant décrit chaque nom.
Nom de la zone de formulaire |
Description |
|---|---|
Nom de l'élément Zone de formulaire |
Nom spécifié pour l'élément Zone de formulaire Outlook dans la boîte de dialogue Ajouter un nouvel élément.Il s'agit du nom du fichier de code de la zone de formulaire qui apparaît dans l'Explorateur de solutions. |
Propriété FormRegionName |
Vous spécifiez ce nom sur la page Fournissez un texte descriptif et sélectionnez vos préférences d'affichage de l'Assistant Nouvelle zone de formulaire Outlook.Ce nom apparaît en tant que propriété FormRegionName dans la fenêtre Propriétés. Utilisez la propriété FormRegionName pour spécifier l'étiquette qui identifie la zone de formulaire dans l'interface utilisateur d'Outlook.Pour les zones de formulaire distinctes, ce nom apparaît en tant que bouton sur le ruban de l'élément Outlook. Pour des zones de formulaire adjacentes, ce nom apparaît en tant que texte d'en-tête au-dessus de la zone de formulaire. |
Attribut Microsoft.Office.Tools.Outlook.FormRegionName |
Lorsque vous ajoutez un élément Zone de formulaire Outlook au projet, Visual Studio affecte à cette propriété le nom qualifié complet de la zone de formulaire.Le nom qualifié complet par défaut est le nom du complément associé au nom de la zone de formulaire par un point (par exemple, OutlookAddIn1.FormRegion1). Ce nom qualifié complet apparaît également en tant qu'attribut en haut de la classe de fabrique de zones de formulaire. Utilisez l'attribut Microsoft.Office.Tools.Outlook.FormRegionName pour identifier la zone de formulaire de manière unique dans tous les compléments Outlook.Vous ne pouvez pas modifier la valeur de l'attribut Microsoft.Office.Tools.Outlook.FormRegionName en renommant l'élément de zone de formulaire ou en modifiant la propriété FormRegionName.Pour modifier ce nom, vous devez modifier l'attribut Microsoft.Office.Tools.Outlook.FormRegionName dans le fichier de code de la zone de formulaire. |
Désactivation de l'héritage de zone de formulaire
Par défaut, une nouvelle classe de message personnalisée hérite de toutes les associations de zones de formulaire de la classe de message de base.Par exemple, une classe de message nommée IPM.Task.Contoso dérive d'IPM.Task.Par conséquent, IPM.Task.Contoso hérite des associations de zones de formulaire d'IPM.Task.
Si vous ne souhaitez pas que la zone de formulaire soit associée à toutes les classes de message dérivées, affectez à la propriété ExactMessageClass de la zone de formulaire la valeur true.Par exemple, si vous associez une zone de formulaire adjacente à IPM.Task et affectez la valeur true à la propriété ExactMessageClass, la zone de formulaire sera ajoutée uniquement au bas d'un formulaire de tâche standard.La zone de formulaire ne sera pas ajoutée au bas de toutes les versions personnalisées d'un formulaire de tâche standard.
Fonctionnement des noms de type et des noms de classe de message
Le nom de type d'un élément Outlook diffère du nom de classe de message d'un élément Outlook.Par exemple, le nom de type d'un élément RSS est Microsoft.Office.Interop.Outlook.PostItem.Le nom de classe de message d'un élément RSS est IPM.Post.RSS.
Utilisez le nom de type pour référencer un élément Outlook dans le code.Pour obtenir la liste des noms de type, consultez Association d'une zone de formulaire à une classe de message Outlook.
Utilisez le nom de classe de message des éléments Outlook dans l'Assistant Nouvelle zone de formulaire Outlook pour associer l'élément à la zone de formulaire.Pour obtenir la liste des noms de classe de message valides, consultez Association d'une zone de formulaire à une classe de message Outlook.
Conception de zones de formulaire adjacentes pour le volet de lecture
Vous pouvez utiliser le volet de lecture Outlook pour afficher un aperçu d'un élément Outlook sans l'ouvrir.Le volet de lecture est conçu uniquement pour la lecture.Les contrôles d'entrée que vous ajoutez à une zone de formulaire adjacente, tels qu'une zone de texte, ne se comportent donc pas forcément comme prévu lorsque l'élément et la zone de formulaire sont ouverts dans le volet de lecture.
Par exemple, si un élément qui possède une zone de formulaire adjacente est ouvert dans le volet de lecture, la situation suivante peut se produire :
Sélectionnez le texte d'une zone de texte qui se trouve dans la zone de formulaire.
Appuyez sur la touche SUPPR.
Cette opération supprime tout l'élément de messagerie au lieu du texte de la zone de texte.
Si vous concevez une zone de formulaire adjacente contenant des contrôles d'entrée, testez les contrôles dans le volet de lecture pour vous assurer qu'ils fonctionnent correctement.Envisagez l'ajout de code personnalisé désactivant les contrôles qui ne se comportent pas comme prévu.
Vous pouvez également affecter la valeur False à la propriété ShowInspectorRead de la zone de formulaire.Ainsi, la zone de formulaire ne peut pas être utilisée dans le volet de lecture.
Utilisation de tailles d'icône optimales
Vous pouvez spécifier les icônes que la zone de formulaire doit afficher en définissant des propriétés d'icône dans le groupe de propriétés Icônes de la fenêtre Propriétés.Conformez-vous aux directives suivantes pour obtenir une qualité d'affichage optimale :
Pour l'icône Page, utilisez un fichier PNG (Portable Network Graphics).
La taille des icônes Fenêtre doit être de 32 x32 pixels.
La taille de toutes les autres icônes doit être de 16 x16 pixels.
L'icône Page apparaît sur le ruban d'un Inspecteur pour les éléments qui possèdent des zones de formulaire distinctes, de remplacement ou de remplacement global.
L'icône Fenêtre apparaît dans la zone de notification et dans la boîte de dialogue ALT+Tab pour les éléments ouverts qui affichent des zones de formulaire de remplacement ou de remplacement global.
Voir aussi
Tâches
Procédure pas à pas : conception d'une zone de formulaire Outlook
Comment : ajouter une zone de formulaire à un projet de complément Outlook
Concepts
Accès à une zone de formulaire au moment de l'exécution
Association d'une zone de formulaire à une classe de message Outlook