Ajout de champs à un affichage
Cet exemple montre comment personnaliser une vue à l’aide de la méthode Add(String) de la collection ViewFields pour ajouter des champs à une vue.
Exemple
Remarque
L’exemple de code suivant est un extrait de la programmation d’Applications pour Microsoft Office Outlook 2007.
Vous pouvez spécifier quelles propriétés des éléments d'Outlook sont affichées dans un affichage en ajoutant une ou plusieurs propriétés à la collection ViewFields seulement pour les objets CardView et TableView . Pour d’autres objets View dérivés tels que les objets BusinessCardView, CalendarView, IconView et TimelineView, utilisez d’autres méthodes pour déterminer les propriétés d’élément d’Outlook qui sont affichées dans la vue. Par exemple, les champs affichés pour l’objet BusinessCardView sont déterminés par la disposition de la carte de visite électronique associée à chaque élément d’Outlook affiché.
Pour obtenir la collection ViewFields pour un affichage, utilisez la propriété ViewFields de l'objet View associé (par exemple les objets CardView ou TableView). La méthode Add de la collection ViewFields est utilisée pour créer un objet ViewField qui représente la propriété d'élément Outlook à afficher dans l'affichage. Un objet ViewField non seulement identifie une propriété d'élément Outlook à afficher dans l'affichage, mais il décrit aussi comment les valeurs de cette propriété doivent être affichées. Vous pouvez changer la façon dont les propriétés des colonnes individuelles sont affichées dans un affichage en modifiant la propriété ColumnFormat de l'objet ViewField.
Dans l’exemple de code suivant, ModifyMeetingRequestsView obtient l’objet TableView qui représente tous les affichages de la Boîte de réception (Inbox) de l’utilisateur qui sont des affichages « Meeting Requests » (Demandes de réunion). L’exemple utilise ensuite la méthode Add pour ajouter les champs « Start » (Début) et « End » (Fin) à l’objet ViewFields qui correspond à l’objet TableView. Il change aussi le libellé du champ « From » (De) en « Organized By » (Organisé par). ModifyMeetingRequestsView enregistre ensuite l’objet TableView modifié.
Si vous utilisez Visual Studio pour tester cet exemple de code, vous devez d’abord ajouter une référence au composant Bibliothèque d’objets Microsoft Outlook 15.0 et spécifier la variable lorsque vous importez l’espace de noms Microsoft.Office.Interop.Outlook. L’instruction using ne doit pas se produire juste avant les fonctions de l’exemple de code, mais doit être ajoutée avant la déclaration publique. La ligne de code suivante montre comment effectuer l’importation et l’affectation dans C#.
using Outlook = Microsoft.Office.Interop.Outlook;
private void ModifyMeetingRequestsView()
{
Outlook.TableView tableView = null;
Outlook.ViewField startField = null;
Outlook.ViewField endField = null;
Outlook.ViewField fromField = null;
try
{
tableView =
Application.Session.GetDefaultFolder(
Outlook.OlDefaultFolders.olFolderInbox)
.Views["Meeting Requests"] as Outlook.TableView;
}
catch { }
if (tableView != null)
{
try
{
startField = tableView.ViewFields["Start"];
}
catch{}
if (startField == null)
{
startField = tableView.ViewFields.Add("Start");
}
try
{
endField = tableView.ViewFields["End"];
}
catch{}
if (endField == null)
{
endField = tableView.ViewFields.Add("End");
}
try
{
fromField = tableView.ViewFields["From"];
}
catch{}
if (fromField != null)
{
fromField.ColumnFormat.Label = "Organized By";
}
try
{
tableView.Save();
}
catch (Exception ex)
{
Debug.WriteLine(ex.Message);
}
}
}