Création d’un rendez-vous sur toute la journée
Cet exemple montre comment utiliser la propriété AllDayEvent pour créer un rendez-vous qui est un événement planifié sur une journée entière.
Exemple
Remarque
L’exemple de code suivant est un extrait de la programmation d’Applications pour Microsoft Office Outlook 2007.
Un événement est différent d’un rendez-vous normal, car il s’agit d’une activité qui dure 24 heures ou plus. Les expositions commerciales, les séminaires ou les vacances sont des exemples d’événements. Les événements et les événements annuels n’apparaissent pas comme des blocs de temps occupés dans le calendrier de l’utilisateur. Au lieu de cela, ils apparaissent sous forme de bannières. Vous pouvez voir les bannières en haut d’un affichage jour ou semaine calendrier. Pour un rendez-vous d’une journée entière, par défaut, l’heure de l’utilisateur est affichée comme occupée lorsqu’elle est affichée par d’autres personnes, mais l’heure de l’utilisateur est affichée comme gratuite pour un événement ou un événement annuel.
Pour créer par programme un événement d’une journée entière, définissez la propriété AllDayEvent de l’objet AppointmentItem sur True. Définissez ensuite les propriétés Start et End de l’objet AppointmentItem. Si vous définissez la propriété AllDayEvent sur true et ne définissez pas les propriétés Start et End, l'événement se produira aujourd'hui et sera un rendez-vous avec le statut occupé sur votre calendrier. Vous devez définir les propriétés Start et End si vous souhaitez que l’événement se produise à une date ultérieure.
Remarque
Pour convertir le rendez-vous en événement d’une journée entière, vous devez définir la propriété Start sur 00h00 (minuit) le jour où l’événement doit démarrer et définir la propriété End sur 00h00 le jour suivant où l’événement doit s’arrêter. Si vous définissez l’heure de début ou de fin sur une valeur autre que 00:00:00, le rendez-vous deviendra un rendez-vous planifié sur plusieurs jours plutôt qu’un événement planifié sur une journée entière.
Par exemple, si la durée de l’événement est d’un jour seulement, définissez la propriété Start sur 00h00 le jour où l’événement doit commencer et définissez la propriété End sur 00h00 le jour suivant. Vous devez toujours définir la propriété End sur 00h00 à la date correspondant à un jour de plus que la date de début.
Dans l’exemple de code suivant, AllDayEventExample crée un événement d’une journée entière qui commence le 11 juin 2007 et se termine le 15 juin 2007. Notez que la propriété End du rendez-vous est définie sur 00h00, le 16 juin 2007.
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 AllDayEventExample()
{
Outlook.AppointmentItem appt = Application.CreateItem(
Outlook.OlItemType.olAppointmentItem)
as Outlook.AppointmentItem;
appt.Subject = "Developer's Conference";
appt.AllDayEvent = true;
appt.Start = DateTime.Parse("6/11/2007 12:00 AM");
appt.End = DateTime.Parse("6/16/2007 12:00 AM");
appt.Display(false);
}