Crear una cita que sea un evento de todo el día
En este ejemplo se muestra cómo usar la propiedad AllDayEvent para crear una cita que sea un evento de día completo.
Ejemplo
Nota:
El siguiente ejemplo de código es un fragmento de Programming Applications for Microsoft Office Outlook 2007 (Programación de aplicaciones para Microsoft Office Outlook 2007).
Un evento es diferente de una cita regular porque es una actividad que dura 24 horas o más. Algunos ejemplos de eventos son ferias comerciales, seminarios o vacaciones. Los eventos y eventos anuales no aparecen como bloques de tiempo ocupados en el calendario del usuario. En su lugar, aparecen como banners. Puede ver los banners en la parte superior de una vista de día natural o semana. Para una cita de todo el día, de forma predeterminada, la hora del usuario se muestra como ocupada cuando la ven otras personas, pero la hora del usuario se muestra como gratuita para un evento o evento anual.
Para crear un evento de todo el día mediante programación, establezca la propiedad AllDayEvent del objeto AppointmentItem en true. Después, establezca las propiedades Starr y End del objeto AppointmentItem. Si establece la propiedad AllDayEvent en true y no establece las propiedades Start y End, el evento se producirá en el día de hoy, y será una cita que mostrará el estado Ocupado en el calendario. Debe establecer las propiedades Start y End si quiere que el evento se produzca en una fecha futura.
Nota:
Para que la cita sea un evento de día completo, debe establecer la propiedad Start en 12:00 a.m. del día que desea que comience el evento y la propiedad End en 12:00 a.m. del día siguiente cuando desea que termine. Si establece la hora de inicio o finalización en un valor de fecha y hora que no sea las 12:00 A. M., la cita se convertirá en una cita de varios días en lugar de un evento de todo el día.
Por ejemplo, si la duración del evento es de día completo, establezca la propiedad Start en 12:00 a.m. del día que desee que comience el evento y la propiedad End en 12:00 a.m. del día siguiente. Siempre debe establecer la propiedad End en 12:00 a.m. en una fecha que sea un día posterior a la fecha de inicio.
En el siguiente ejemplo de código, AllDayEventExample crea un evento de día completo que comienza el 11 de junio de 2007 y finaliza el 15 de junio de 2007. Observe que la propiedad End de la cita está ajustada en 12:00 a.m. del día 16 de junio de 2007.
Si usa Visual Studio para probar este ejemplo de código, primero debe agregar una referencia al componente de la biblioteca de objetos de Microsoft Outlook 15.0 y especificar la variable de Outlook al importar el espacio de nombres Microsoft.Office.Interop.Outlook. La instrucción using no debe producirse directamente antes de las funciones en el ejemplo de código, pero debe agregarse antes de la declaración de clase pública. La siguiente línea de código muestra cómo realizar la importación y la asignación en 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);
}