This example demonstrates how to create recurring appointments, i.e. appointments, which occur multiple times. Recurring appointments are created in the same way as ordinary appointments with the only difference that they have a recurrence rule assigned to their RecurrenceRule property and can be easily recognized by the circular arrows symbol at their top left corner.
This examples also shows how to change the properties or delete an occurrence of a recurring appointment. By default occurrences of recurring appointments inherit the property values of the recurring appointment, but you can easily change any of these properties for a specific occurrence. All changes to such occurrences are remembered, so even if you move to the previous or the next range of the schedule, when you get back to the current range, you'll be able to see all these changes again.

| Language: C# |
using Nevron.Nov;
using Nevron.Nov.Dom;
using Nevron.Nov.Graphics;
using Nevron.Nov.Layout;
using Nevron.Nov.Schedule;
using Nevron.Nov.UI;
using Nevron.Nov.Windows.Forms;
using System;
using System.Windows.Forms;
namespace NovWinFormsProject
{
public partial class Form1 : Form
{
#region Constructors
public Form1()
{
InitializeComponent();
// Set form title
Text = "NOV WinForms - NOccurrencesModificationExample";
// Create the NOV example and its controls
NWidget exampleContent = CreateExampleContent();
NWidget exampleControls = CreateExampleControls();
if (exampleControls != null)
{
exampleControls.PreferredWidth = 300;
}
// Place the example and its controls in a pair box
NPairBox pairBox = new NPairBox(exampleContent, exampleControls);
pairBox.FillMode = ENStackFillMode.First;
pairBox.FitMode = ENStackFitMode.First;
pairBox.Margins = new NMargins(NDesign.HorizontalSpacing, NDesign.VerticalSpacing);
// Host the example in the form
NNovWidgetHost host = new NNovWidgetHost(pairBox);
host.Dock = DockStyle.Fill;
Controls.Add(host);
}
#endregion
#region Example
public NWidget CreateExampleContent()
{
// Create a simple schedule
NScheduleViewWithRibbon scheduleViewWithRibbon = new NScheduleViewWithRibbon();
m_ScheduleView = scheduleViewWithRibbon.View;
m_ScheduleView.Document.PauseHistoryService();
try
{
InitSchedule(m_ScheduleView.Content);
}
finally
{
m_ScheduleView.Document.ResumeHistoryService();
}
// Return the commanding widget
return scheduleViewWithRibbon;
}
public NWidget CreateExampleControls()
{
return null;
}
public string GetExampleDescription()
{
return @"
This example demonstrates how to create recurring appointments, i.e. appointments, which occur multiple
times. Recurring appointments are created in the same way as ordinary appointments with the only difference
that they have a recurrence rule assigned to their RecurrenceRule property and can be easily
recognized by the circular arrows symbol at their top left corner.
This examples also shows how to change the properties or delete an occurrence of a recurring appointment.
By default occurrences of recurring appointments inherit the property values of the recurring appointment,
but you can easily change any of these properties for a specific occurrence. All changes to such occurrences
are remembered, so even if you move to the previous or the next range of the schedule, when you get back
to the current range, you'll be able to see all these changes again.
";
}
///
/// Gets the relevant documentation links for the example
///
///
public (string Name, string Url)[] GetDocumentationUrls()
{
return new[]
{
("Schedule Recurring Appointments", "https://www.nevron.com/docs/openvision/schedule-recurring-appointments.html"),
("Schedule Appointments", "https://www.nevron.com/docs/openvision/schedule-appointments.html"),
("Schedule", "https://www.nevron.com/docs/openvision/schedule.html"),
("Schedule View", "https://www.nevron.com/docs/openvision/schedule-view.html"),
};
}
#endregion
#region Implementation
private void InitSchedule(NSchedule schedule)
{
DateTime today = DateTime.Today;
// Create a recurring appointment, which occurs every day
NAppointment appointment = new NAppointment("Appointment", today.AddHours(12), today.AddHours(14));
NRecurrenceDailyRule rule = new NRecurrenceDailyRule();
rule.StartDate = new DateTime(2015, 1, 1);
appointment.RecurrenceRule = rule;
// Add the recurring appointment to the schedule
schedule.Appointments.Add(appointment);
// Change the time of the first appointment in the current week
NAppointmentBase appChild = appointment.Occurrences[0];
appChild.Start = appChild.Start.AddHours(-2);
appChild.End = appChild.End.AddHours(-2);
// Change the subject of the second appointment
appChild = appointment.Occurrences[1];
appChild.Subject = "Custom Subject";
// Change the category of the third appointment
appChild = appointment.Occurrences[2];
appChild.Category = NCategory.Color.Red;
// Delete the fourth appointment
appointment.Occurrences.RemoveAt(3);
}
#endregion
#region Event Handlers
#endregion
#region Fields
private NScheduleView m_ScheduleView;
#endregion
#region Static Methods
#endregion
#region Constants
#endregion
#region Nested Types
#endregion
}
}