All chapters on a single page

You don't need to install anything to start using the DayPilot component. Just reference the assembly in your project. It's also possible to add the DayPilot to your Visual Studio Toolbox so you drag the component onto your web form and set the properties visually.

Adding the component to the Visual Studio Toolbox:

1. Right-click the toolbox and select "Choose Items...".

2. In the "Choose Toolbox Items" dialog click "Browse...".

2. Find the DayPilot assembly and click OK.

3. Close the "Choose Toolbox Items" dialog by clicking "OK" and you will see the DayPilot icon in the toolbox:

4. Now you can drag the icon to your WebForm and you will see the DayPilot object:

5. You can set the DayPilot properties in the "Properties" window:

Here are the data-related properties of DayPilotCalendar:

For switching the date you can use the standard .NET Framework control System.Web.UI.WebControls.Calendar. You can use the PostBack event to change the DayPilot StartDate and Days properties.

In our sample we will use the DayRender event to improve the calendar:

• the days will become links to a specific day (i.e. no PostBack)
• the days that contain an event will be bold

private void Calendar1_DayRender(object sender, System.Web.UI.WebControls.DayRenderEventArgs e)
{
	string fontWeight = "normal";
	if (isThereEvent(e.Day.Date))
		fontWeight = "bold";

	string color = "black";
	if (e.Day.IsOtherMonth)
		color = this.Calendar1.OtherMonthDayStyle.ForeColor.Name;

	e.Cell.Text = String.Format("<a href='Default.aspx?day={0:d}' style='color: "
		+ color + ";text-decoration:none; font-weight:" 
		+ fontWeight + "'>{1}</a>", e.Day.Date, e.Day.Date.Day);		
}

The method isThereEvent() returns true if a specific day contains any event. This method will be specific to your application. You can go through the data returned from the database (and supplied to DayPilotCalendar.DataSource) to avoid another database request.  We are not using the database in our sample so it is hard-coded:

private bool isThereEvent(DateTime date)
{
	DateTime today = DateTime.Now;
	DateTime tomorrow = today.AddDays(1);
	DateTime anotherDay = today.AddDays(3);

	// there are events today
	if ((date.DayOfYear == today.DayOfYear) && (date.Year == today.Year))
		return true;

	// there are events tomorrow
	if ((date.DayOfYear == tomorrow.DayOfYear) && (date.Year == tomorrow.Year))
		return true;

	// there are events on another day
	if ((date.DayOfYear == anotherDay.DayOfYear) && (date.Year == anotherDay.Year))
		return true;

	return false;
}

DayPilot Lite supports two user actions:

• clicking a free time cell (you will typically use this action to create a new event)
• clicking an event (you will typically use this action to show event details)

The actions can be handled on the client (by custom JavaScript code) or on the server (by handling the server event).

Your server-side event handling methods will get the important data:

EventClick knows the event value (PK column)

The e argument of EventClick handler (EventClickEventArgs) holds is the value of the clicked event (DataValueField) in e.Value.

protected void DayPilotCalendar1_EventClick(object sender, EventClickEventArgs e)
{
  Label1.Text = "Selected event: " + e.Value;
}

TimeRangeSelected knows the time clicked

protected void DayPilotCalendar1_TimeRangeSelected(object sender, TimeRangeSelectedEventArgs e)
{
  Label1.Text = "Selected time: " + e.Start;
}

8. Choosing DayFormat - DateTime.ToString() parameters

Custom format examples