Directives pour la création de zones de formulaire OutlookGuidelines for Creating Outlook Form Regions

Les informations suivantes peuvent vous aider à optimiser vos zones de formulaire et à éviter d’éventuels problèmes :The following information can help you optimize your form regions and avoid potential problems:

Using Form Region NamesUsing Form Region Names

Plusieurs noms décrivent la zone de formulaire.There are several names used to describe the form region. Il est important de comprendre la différence entre ces noms et leur impact sur la zone de formulaire.It is important to understand the difference between these names and how they affect the form region. Le tableau suivant décrit chaque nom.The following table describes each name.

Nom de zone de formulaireForm region name DescriptionDescription
Nom d’élément de zone de formulaireForm region item name Nom que vous spécifiez pour l’élément Zone de formulaire Outlook dans la boîte de dialogue Ajouter un nouvel élément .The name that you specify for the Outlook Form Region item in the Add New Item dialog box. Il s’agit du nom du fichier de code de zone de formulaire affiché dans l’ Explorateur de solutions.This is the name of the form region code file that appears in Solution Explorer.
PropriétéFormRegionName FormRegionName property Vous spécifiez ce nom dans la page Fournissez un texte descriptif et sélectionnez vos préférences d’affichage de l’Assistant Nouvelle zone de formulaire Outlook .You specify this name in the Supply descriptive text and select your display preferences page of the New Outlook Form Region wizard. Ce nom apparaît comme propriété FormRegionName dans la fenêtre Propriétés .This name appears as the FormRegionName property in the Properties window.

Utilisez la propriété FormRegionName pour spécifier l’étiquette qui identifie la zone de formulaire dans l’interface utilisateur d’Outlook.Use the FormRegionName property to specify the label that identifies the form region in the Outlook user interface (UI). Pour les zones de formulaire distinctes, ce nom s’affiche sous forme de bouton dans le ruban de l’élément Outlook.For separate form regions, this name appears as a button on the Ribbon of the Outlook item.

Pour les zones de formulaire adjacentes, ce nom s’affiche sous forme de texte d’en-tête au-dessus de la zone de formulaire.For adjoining form regions, this name appears as header text above the form region.
Attribut Microsoft.Office.Tools.Outlook.FormRegionNameMicrosoft.Office.Tools.Outlook.FormRegionName attribute Quand 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.When you add an Outlook Form Region item to the project, Visual Studio sets this property to the fully qualified name of the form region. Le nom qualifié complet par défaut est le nom du complément VSTO associé au nom de la zone de formulaire par un point, par exemple OutlookAddIn1.FormRegion1.The default fully qualified name is the name of the VSTO Add-in connected to the name of the form region by a dot—for example, OutlookAddIn1.FormRegion1.

Ce nom qualifié complet apparaît également en tant qu’attribut en haut de la classe de fabrique de zones de formulaire.This fully qualified name also appears as an attribute at the top of the form region factory class.

Utilisez l’attribut Microsoft.Office.Tools.Outlook.FormRegionName pour identifier de façon unique la zone de formulaire dans tous les composants logiciels Compléments VSTO 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 le FormRegionName propriété.Use the Microsoft.Office.Tools.Outlook.FormRegionName attribute to uniquely identify the form region across all Outlook VSTO Add-ins. You cannot change the value of the Microsoft.Office.Tools.Outlook.FormRegionName attribute by renaming the form region item or by changing the FormRegionName property. Pour modifier ce nom, vous devez modifier l’attribut Microsoft.Office.Tools.Outlook.FormRegionName dans le fichier de code de zone de formulaire.To change this name, you must modify the Microsoft.Office.Tools.Outlook.FormRegionName attribute in the form region code file.

Disabling Form Region InheritanceDisabling Form Region Inheritance

Par défaut, une classe de message personnalisée hérite de toutes les associations de zones de formulaire de la classe de message de base.By default, a custom message class inherits all the form region associations of the base message class. Par exemple, une classe de message nommée IPM.Task.Contoso dérive de gestion intégrée. Tâche.For example, a message class named IPM.Task.Contoso derives from IPM.Task. Par conséquent, IPM.Task.Contoso hérite des associations de zones de formulaire de gestion intégrée. Tâche.Therefore, IPM.Task.Contoso inherits the form region associations of IPM.Task.

Si vous ne souhaitez pas que la zone de formulaire soit associée aux classes de messages dérivées, affectez la valeur ExactMessageClass à la propriété P:Microsoft.Office.Tools.Outlook.FormRegionManifest.ExactMessageClass.If you do not want the form region to be associated with any derived message classes, set the ExactMessageClass property of the form region to true. Par exemple, si vous associez une zone de formulaire adjacente à gestion intégrée. La tâche et définir le ExactMessageClass propriété true, la zone de formulaire est ajoutée uniquement au bas d’un formulaire de tâche standard.For example, if you associate an adjoining form region with IPM.Task and set the ExactMessageClass property to true, the form region will only be appended to the bottom of a standard task form. Elle n’est pas ajoutée à la fin des versions personnalisées d’un formulaire de tâche standard.The form region will not be appended to the bottom of any customized versions of a standard task form.

Présentation des types et des noms de classes de messagesUnderstanding Types and Message Class Names

Le nom de type d’un élément Outlook diffère du nom de classe de message d’un élément Outlook.The type name of an Outlook item differs from the message class name of an Outlook item. Par exemple, le nom de type d’un élément RSS est Microsoft.Office.Interop.Outlook.PostItem.For example, the type name of an RSS item is Microsoft.Office.Interop.Outlook.PostItem. Le nom de classe de message d’un élément RSS est gestion intégrée. Post.RSS.The message class name of an RSS item is IPM.Post.RSS.

Utilisez le nom de type pour faire référence à un élément Outlook dans le code.Use the type name to reference an Outlook item in code. Pour obtenir la liste des noms de types, consultez Association d'une zone de formulaire à une classe de message Outlook.For a list of type names, see Associating a Form Region with an Outlook Message Class.

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.Use the message class name of Outlook items in the New Outlook Form Region wizard to associate the item with the form region. Pour obtenir la liste des noms de classes de messages valides, consultez Association d'une zone de formulaire à une classe de message Outlook.For a list of valid message class names, see Associating a Form Region with an Outlook Message Class.

Designing Adjoining Form Regions for the Reading PaneDesigning Adjoining Form Regions for the Reading Pane

Vous pouvez utiliser le volet de lecture Outlook pour afficher un aperçu d’un élément Outlook sans l’ouvrir.You can use the Outlook Reading Pane to preview an Outlook item without opening the item. Le volet de lecture est conçu uniquement pour la lecture.The Reading Pane is designed for reading only. Ainsi, les contrôles d’entrée que vous ajoutez à une zone de formulaire adjacente, tels qu’une zone de texte, peuvent ne pas se comporter comme prévu quand l’élément et la zone de formulaire sont ouverts dans le volet de lecture.Therefore, input controls that you add to an adjoining form region, such as a text box, might not behave as expected when the item and form region are open in the Reading Pane.

Par exemple, si un élément qui possède une zone de formulaire adjacente est ouvert dans le volet de lecture, la situation suivante est possible :For example, if an item that has an adjoining form region is open in the Reading Pane, the following situation is possible:

  1. Sélectionnez du texte dans une zone de texte qui se trouve dans la zone de formulaire.Select some text in a textbox that is on the form region.

  2. Appuyez sur la touche Suppr.Press DELETE.

  3. L’élément de messagerie entier est supprimé, plutôt que le texte de la zone de texte.The entire mail item is deleted instead of the text in the textbox.

    Si vous créez une zone de formulaire adjacente qui contient des contrôles d’entrée, testez les contrôles dans le volet de lecture pour vous assurer qu’ils fonctionnent correctement.If you are designing an adjoining form region that contains input controls, test the controls in the Reading Pane to ensure they work properly. Vous pouvez ajouter du code personnalisé qui désactive les contrôles qui ne se comportent pas comme prévu,Consider adding custom code that disables controls that do not behave as expected.

    ou encore affecter la valeur ShowInspectorRead à la propriété P:Microsoft.Office.Tools.Outlook.FormRegionManifest.ShowInspectorRead.Alternatively, you can set the ShowInspectorRead property of the form region to False. Ainsi, la zone de formulaire ne peut pas être utilisée dans le volet de lecture.This way the form region cannot be used in the Reading Pane.

Using Optimal Icon SizesUsing Optimal Icon Sizes

Vous pouvez spécifier les icônes que la zone de formulaire doit afficher en définissant des propriétés d’icônes dans le groupe de propriétés Icônes de la fenêtre Propriétés .You can specify which icons you want the form region to display by setting icon properties in the Icons property group of the Properties window. Utilisez les instructions suivantes pour obtenir la meilleure qualité visuelle :Use the following guidelines to achieve the best visual quality:

  • Pour l’icône Page , utilisez un fichier PNG (Portable Network Graphics).For the Page icon, use a Portable Network Graphics (PNG) file.

  • Les icônes deFenêtre doivent avoir une taille de 32x32 pixels.Window icons should be 32 pixels by 32 pixels.

  • Toutes les autres icônes doivent avoir une taille de 16x16 pixels.All other icons should be 16 pixels by 16 pixels.

    L’icône Page apparaît dans le ruban d’un inspecteur pour les éléments qui ont des zones de formulaire distinctes, de substitution et de remplacement global.The Page icon appears on the Ribbon of an Inspector for items that have separate, replacement, or replace-all form regions.

    L’icône Fenêtre est affichée dans la zone de notification et dans la boîte de dialogue Alt+Tab pour les éléments ouverts qui affichent des zones de substitution ou de remplacement global.The Window icon appears in the notification area and in the ALT+TAB dialog box for open items that display replacement or replace-all form regions.

Voir aussiSee Also

L’accès à une zone de formulaire au moment de l’exécution Accessing a Form Region at Run Time
Création de zones de formulaire Outlook Creating Outlook Form Regions
Procédure pas à pas : Conception d’une zone de formulaire Outlook Walkthrough: Designing an Outlook Form Region
Comment : ajouter une zone de formulaire à un projet de complément Outlook How to: Add a Form Region to an Outlook Add-in Project
Association d’une zone de formulaire à une classe de message OutlookAssociating a Form Region with an Outlook Message Class