//=====================================================================
/// <summary>
/// This is overridden to allow cloning of a PDI object
/// </summary>
/// <returns>A clone of the object</returns>
public override object Clone()
{
VFreeBusy o = new VFreeBusy();
o.Clone(this);
return(o);
}
/// <summary>
/// This is overridden to allow proper comparison of free/busy objects
/// </summary>
/// <param name="obj">The object to which this instance is compared</param>
/// <returns>Returns true if the object equals this instance, false if it does not</returns>
public override bool Equals(object obj)
{
VFreeBusy fb = obj as VFreeBusy;
if (fb == null)
{
return(false);
}
// The ToString() method returns a text representation of the object based on all of its settings so
// it's a reliable way to tell if two instances are the same.
return(this == fb || this.ToString() == fb.ToString());
}
//=====================================================================
/// <summary>
/// Initialize the dialog controls using the specified VFreeBusy object
/// </summary>
/// <param name="fb">The free/busy object from which to get the settings</param>
public void SetValues(VFreeBusy fb)
{
string timeZoneId = fb.StartDateTime.TimeZoneId;
txtUniqueId.Text = fb.UniqueId.Value;
txtOrganizer.Text = fb.Organizer.Value;
txtContact.Text = fb.Contact.Value;
if(fb.StartDateTime.TimeZoneDateTime == DateTime.MinValue)
dtpStartDate.Checked = false;
else
{
dtpStartDate.Value = fb.StartDateTime.TimeZoneDateTime;
dtpStartDate.Checked = true;
}
if(fb.EndDateTime.TimeZoneDateTime == DateTime.MinValue)
dtpEndDate.Checked = false;
else
{
dtpEndDate.Value = fb.EndDateTime.TimeZoneDateTime;
dtpEndDate.Checked = true;
}
if(fb.Duration.DurationValue != Duration.Zero)
txtDuration.Text = fb.Duration.DurationValue.ToString(Duration.MaxUnit.Weeks);
txtUrl.Text = fb.Url.Value;
txtComments.Text = fb.Comment.Value;
// We could bind directly to the existing collections but that would modify them. To preserve the
// original items, we'll pass a copy of the collections instead.
ucAttendees.BindingSource.DataSource = new AttendeePropertyCollection().CloneRange(fb.Attendees);
ucFreeBusy.BindingSource.DataSource = new FreeBusyPropertyCollection().CloneRange(fb.FreeBusy);
ucRequestStatus.BindingSource.DataSource = new RequestStatusPropertyCollection().CloneRange(fb.RequestStatuses);
// We use the start date's time zone ID for the combo box. It should represent the time zone used
// throughout the component.
if(timeZoneId == null)
cboTimeZone.SelectedIndex = timeZoneIdx = 0;
else
{
timeZoneIdx = cboTimeZone.Items.IndexOf(timeZoneId);
if(timeZoneIdx != -1)
cboTimeZone.SelectedIndex = timeZoneIdx;
else
cboTimeZone.SelectedIndex = timeZoneIdx = 0;
}
}
/// <summary>
/// This is overridden to allow copying of the additional properties
/// </summary>
/// <param name="p">The PDI object from which the settings are to be copied</param>
protected override void Clone(PDIObject p)
{
VFreeBusy o = (VFreeBusy)p;
this.ClearProperties();
url = (UrlProperty)o.Url.Clone();
uid = (UniqueIdProperty)o.UniqueId.Clone();
startDate = (StartDateProperty)o.StartDateTime.Clone();
endDate = (EndDateProperty)o.EndDateTime.Clone();
timeStamp = (TimeStampProperty)o.TimeStamp.Clone();
comment = (CommentProperty)o.Comment.Clone();
organizer = (OrganizerProperty)o.Organizer.Clone();
duration = (DurationProperty)o.Duration.Clone();
contact = (ContactProperty)o.Contact.Clone();
this.Attendees.CloneRange(o.Attendees);
this.RequestStatuses.CloneRange(o.RequestStatuses);
this.FreeBusy.CloneRange(o.FreeBusy);
this.CustomProperties.CloneRange(o.CustomProperties);
}
/// <summary>
/// Add a calendar item
/// </summary>
/// <param name="sender">The sender of the event</param>
/// <param name="e">The event arguments</param>
private void btnAdd_Click(object sender, EventArgs e)
{
switch(cboComponents.SelectedIndex)
{
case 0:
using(CalendarObjectDlg dlg = new CalendarObjectDlg())
{
VEvent evt = new VEvent();
evt.UniqueId.AssignNewId(true);
evt.DateCreated.TimeZoneDateTime = DateTime.Now;
evt.LastModified.TimeZoneDateTime = evt.DateCreated.TimeZoneDateTime;
dlg.SetValues(evt);
if(dlg.ShowDialog() == DialogResult.OK)
{
dlg.GetValues(evt);
// Create a unique ID for the new item
evt.UniqueId.AssignNewId(true);
vCal.Events.Add(evt);
}
}
break;
case 1:
using(CalendarObjectDlg dlg = new CalendarObjectDlg())
{
VToDo td = new VToDo();
td.DateCreated.TimeZoneDateTime = DateTime.Now;
td.LastModified.TimeZoneDateTime = td.DateCreated.TimeZoneDateTime;
dlg.SetValues(td);
if(dlg.ShowDialog() == DialogResult.OK)
{
dlg.GetValues(td);
// Create a unique ID for the new item
td.UniqueId.AssignNewId(true);
vCal.ToDos.Add(td);
}
}
break;
case 2:
using(CalendarObjectDlg dlg = new CalendarObjectDlg())
{
VJournal j = new VJournal();
j.DateCreated.TimeZoneDateTime = DateTime.Now;
j.LastModified.TimeZoneDateTime = j.DateCreated.TimeZoneDateTime;
dlg.SetValues(j);
if(dlg.ShowDialog() == DialogResult.OK)
{
dlg.GetValues(j);
// Create a unique ID for the new item
j.UniqueId.AssignNewId(true);
vCal.Journals.Add(j);
}
}
break;
case 3:
using(VFreeBusyDlg dlg = new VFreeBusyDlg())
{
if(dlg.ShowDialog() == DialogResult.OK)
{
VFreeBusy fb = new VFreeBusy();
dlg.GetValues(fb);
// Create a unique ID for the new item
fb.UniqueId.AssignNewId(true);
vCal.FreeBusys.Add(fb);
}
}
break;
}
}
//=====================================================================
/// <summary>
/// This is overridden to allow cloning of a PDI object
/// </summary>
/// <returns>A clone of the object</returns>
public override object Clone()
{
VFreeBusy o = new VFreeBusy();
o.Clone(this);
return o;
}
/// <summary>
/// This is implemented to handle properties as they are parsed from the data stream
/// </summary>
/// <param name="propertyName">The name of the property.</param>
/// <param name="parameters">A string collection containing the parameters and their values. If empty,
/// there are no parameters.</param>
/// <param name="propertyValue">The value of the property.</param>
/// <remarks><para>There may be a mixture of name/value pairs or values alone in the parameters string
/// collection. It is up to the derived class to process the parameter list based on the specification
/// to which it conforms. For entries that are parameter names, the entry immediately following it in
/// the collection is its associated parameter value. The property name, parameter names, and their
/// values may be in upper, lower, or mixed case.</para>
///
/// <para>The value may be an encoded string. The properties are responsible for any decoding that may
/// need to occur (i.e. base 64 encoded image data).</para></remarks>
/// <exception cref="PDIParserException">This is thrown if an error is encountered while parsing the data
/// stream. Refer to the and inner exceptions for information on the cause of the problem.</exception>
protected override void PropertyParser(string propertyName, StringCollection parameters, string propertyValue)
{
SpecificationVersions version = SpecificationVersions.None;
string temp;
int idx;
// Is it parsing a sub-object?
if(currentState != VCalendarParserState.VCalendar)
{
switch(currentState)
{
case VCalendarParserState.VEvent:
VEventParser(propertyName, parameters, propertyValue);
break;
case VCalendarParserState.VToDo:
VToDoParser(propertyName, parameters, propertyValue);
break;
case VCalendarParserState.VJournal:
VJournalParser(propertyName, parameters, propertyValue);
break;
case VCalendarParserState.VAlarm:
VAlarmParser(propertyName, parameters, propertyValue);
break;
case VCalendarParserState.VFreeBusy:
VFreeBusyParser(propertyName, parameters, propertyValue);
break;
case VCalendarParserState.VTimeZone:
VTimeZoneParser(propertyName, parameters, propertyValue);
break;
case VCalendarParserState.ObservanceRule:
ObservanceRuleParser(propertyName, parameters, propertyValue);
break;
case VCalendarParserState.Custom:
CustomObjectParser(propertyName, parameters, propertyValue);
break;
}
return;
}
// The last entry is always CustomProperty so scan for length minus one
for(idx = 0; idx < ntvCal.Length - 1; idx++)
if(ntvCal[idx].IsMatch(propertyName))
break;
// An opening BEGIN:VCALENDAR property must have been seen
if(vCal == null && ntvCal[idx].EnumValue != PropertyType.Begin)
throw new PDIParserException(this.LineNumber, LR.GetString("ExParseNoBeginProp", "BEGIN:VCALENDAR",
propertyName));
// Handle or create the property
switch(ntvCal[idx].EnumValue)
{
case PropertyType.Begin:
// Start a new object
temp = propertyValue.Trim();
// The last entry is always Custom so scan for length - 1
for(idx = 0; idx < ntvObjs.Length - 1; idx++)
if(ntvObjs[idx].IsMatch(temp))
break;
priorState.Push(currentState);
currentState = ntvObjs[idx].EnumValue;
switch(currentState)
{
case VCalendarParserState.VCalendar:
// NOTE: If serializing into an existing instance, this may not be null. If so, it
// is ignored. It may also exist if two calendars appear in the same file. In that
// case, they will be merged into one calendar.
if(vCal == null)
vCal = new VCalendar();
break;
case VCalendarParserState.VEvent:
vEvent = new VEvent();
vCal.Events.Add(vEvent);
break;
case VCalendarParserState.VToDo:
vToDo = new VToDo();
vCal.ToDos.Add(vToDo);
break;
case VCalendarParserState.VJournal:
vJournal = new VJournal();
vCal.Journals.Add(vJournal);
break;
case VCalendarParserState.VFreeBusy:
vFreeBusy = new VFreeBusy();
vCal.FreeBusys.Add(vFreeBusy);
break;
case VCalendarParserState.VTimeZone:
// NOTE: Unlike the other objects, time zone are not added to the collection until
// the END Tag is encountered as they are shared amongst all calendar instances.
vTimeZone = new VTimeZone();
break;
case VCalendarParserState.Custom:
CustomObjectParser(propertyName, parameters, propertyValue);
break;
}
break;
case PropertyType.End:
// The value must be VCALENDAR
if(String.Compare(propertyValue.Trim(), "VCALENDAR", StringComparison.OrdinalIgnoreCase) != 0)
throw new PDIParserException(this.LineNumber, LR.GetString("ExParseUnrecognizedTagValue",
ntvCal[idx].Name, propertyValue));
// When done, we'll propagate the version number to all objects to make it consistent
vCal.PropagateVersion();
break;
case PropertyType.Version:
// Version must be 1.0 or 2.0
temp = propertyValue.Trim();
if(temp == "1.0")
version = SpecificationVersions.vCalendar10;
else
if(temp == "2.0")
version = SpecificationVersions.iCalendar20;
else
throw new PDIParserException(this.LineNumber, LR.GetString("ExParseUnrecognizedVersion",
"vCalendar/iCalendar", temp));
vCal.Version = version;
break;
case PropertyType.ProductId:
vCal.ProductId.EncodedValue = propertyValue;
break;
case PropertyType.CalendarScale:
vCal.CalendarScale.DeserializeParameters(parameters);
vCal.CalendarScale.EncodedValue = propertyValue;
break;
case PropertyType.Method:
vCal.Method.DeserializeParameters(parameters);
vCal.Method.EncodedValue = propertyValue;
break;
case PropertyType.GeographicPosition:
vCal.VCalendarGeographicPosition.EncodedValue = propertyValue;
break;
case PropertyType.TimeZone:
vCal.VCalendarTimeZone.DeserializeParameters(parameters);
vCal.VCalendarTimeZone.EncodedValue = propertyValue;
break;
case PropertyType.Daylight:
vCal.VCalendarDaylightRule.DeserializeParameters(parameters);
vCal.VCalendarDaylightRule.EncodedValue = propertyValue;
break;
default: // Anything else is a custom property
CustomProperty c = new CustomProperty(propertyName);
c.DeserializeParameters(parameters);
c.EncodedValue = propertyValue;
vCal.CustomProperties.Add(c);
break;
}
}
//=====================================================================
/// <summary>
/// This is overridden to handle the additional state maintained by the calendar parser
/// </summary>
/// <param name="fullReset">If true, a full reset is done (i.e. this is the start of a brand new session.
/// If false only the line state is reset (it's done parsing a property name or value).</param>
protected override void ResetState(bool fullReset)
{
if(fullReset)
{
currentState = VCalendarParserState.VCalendar;
vEvent = null;
vToDo = null;
vJournal = null;
vAlarm = null;
vFreeBusy = null;
vTimeZone = null;
obsRule = null;
priorState.Clear();
beginValue.Clear();
}
base.ResetState(fullReset);
}
/// <summary>
/// This is implemented to handle properties related to VFreeBusy items
/// </summary>
/// <param name="propertyName">The name of the property.</param>
/// <param name="parameters">A string collection containing the parameters and their values. If empty,
/// there are no parameters.</param>
/// <param name="propertyValue">The value of the property.</param>
protected virtual void VFreeBusyParser(string propertyName, StringCollection parameters, string propertyValue)
{
StringCollection sc;
string[] parts, parms;
int idx;
// The last entry is always CustomProperty so scan for length minus one
for(idx = 0; idx < ntvFreeBusy.Length - 1; idx++)
if(ntvFreeBusy[idx].IsMatch(propertyName))
break;
// An opening BEGIN:VFREEBUSY property must have been seen
if(vFreeBusy == null)
throw new PDIParserException(this.LineNumber, LR.GetString("ExParseNoBeginProp", "BEGIN:VFREEBUSY",
propertyName));
// Handle or create the property
switch(ntvFreeBusy[idx].EnumValue)
{
case PropertyType.Begin: // Handle unknown nested objects
priorState.Push(currentState);
currentState = VCalendarParserState.Custom;
CustomObjectParser(propertyName, parameters, propertyValue);
break;
case PropertyType.End:
// For this, the value must be VFREEBUSY
if(String.Compare(propertyValue.Trim(), "VFREEBUSY", StringComparison.OrdinalIgnoreCase) != 0)
throw new PDIParserException(this.LineNumber, LR.GetString("ExParseUnrecognizedTagValue",
ntvFreeBusy[idx].Name, propertyValue));
// The free/busy item is added to the collection when created so we don't have to rely on an
// END tag to add it.
vFreeBusy = null;
currentState = priorState.Pop();
break;
case PropertyType.Url:
vFreeBusy.Url.DeserializeParameters(parameters);
vFreeBusy.Url.EncodedValue = propertyValue;
break;
case PropertyType.UniqueId:
vFreeBusy.UniqueId.EncodedValue = propertyValue;
break;
case PropertyType.StartDateTime:
vFreeBusy.StartDateTime.DeserializeParameters(parameters);
vFreeBusy.StartDateTime.EncodedValue = propertyValue;
break;
case PropertyType.EndDateTime:
vFreeBusy.EndDateTime.DeserializeParameters(parameters);
vFreeBusy.EndDateTime.EncodedValue = propertyValue;
break;
case PropertyType.Duration:
vFreeBusy.Duration.DeserializeParameters(parameters);
vFreeBusy.Duration.EncodedValue = propertyValue;
break;
case PropertyType.TimeStamp:
vFreeBusy.TimeStamp.DeserializeParameters(parameters);
vFreeBusy.TimeStamp.EncodedValue = propertyValue;
break;
case PropertyType.Comment:
// If this is seen more than once, just add the new stuff to the existing property
if(vFreeBusy.Comment.Value != null)
{
vFreeBusy.Comment.EncodedValue += "\r\n";
vFreeBusy.Comment.EncodedValue += propertyValue;
}
else
{
vFreeBusy.Comment.DeserializeParameters(parameters);
vFreeBusy.Comment.EncodedValue = propertyValue;
}
break;
case PropertyType.Contact:
vFreeBusy.Contact.DeserializeParameters(parameters);
vFreeBusy.Contact.EncodedValue = propertyValue;
break;
case PropertyType.Organizer:
vFreeBusy.Organizer.DeserializeParameters(parameters);
vFreeBusy.Organizer.EncodedValue = propertyValue;
break;
case PropertyType.Attendee:
AttendeeProperty ap = new AttendeeProperty();
ap.DeserializeParameters(parameters);
ap.EncodedValue = propertyValue;
vFreeBusy.Attendees.Add(ap);
break;
case PropertyType.RequestStatus:
RequestStatusProperty rs = new RequestStatusProperty();
rs.DeserializeParameters(parameters);
rs.EncodedValue = propertyValue;
vFreeBusy.RequestStatuses.Add(rs);
break;
case PropertyType.FreeBusy:
// There may be more than one period in the value. If so, split them into separate ones.
// This makes it easier to manage. They'll get written back out as individual properties but
// that's okay.
parts = propertyValue.Split(',', ';');
// It's important that we retain the same parameters for each one
parms = new string[parameters.Count];
parameters.CopyTo(parms, 0);
foreach(string s in parts)
{
sc = new StringCollection();
sc.AddRange(parms);
FreeBusyProperty fb = new FreeBusyProperty();
fb.DeserializeParameters(sc);
fb.EncodedValue = s;
vFreeBusy.FreeBusy.Add(fb);
}
break;
default: // Anything else is a custom property
CustomProperty cust = new CustomProperty(propertyName);
cust.DeserializeParameters(parameters);
cust.EncodedValue = propertyValue;
vFreeBusy.CustomProperties.Add(cust);
break;
}
}
/// <summary>
/// Update the free/busy object with the dialog control values
/// </summary>
/// <param name="fb">The free/busy object in which the settings are updated</param>
public void GetValues(VFreeBusy fb)
{
// The unique ID is not changed
fb.Organizer.Value = txtOrganizer.Text;
fb.Contact.Value = txtContact.Text;
// We'll use the TimeZoneDateTime property on all date/time values so that they are set literally
// rather than being converted to the time zone as would happen with the DateTimeValue property.
if(!dtpStartDate.Checked)
fb.StartDateTime.TimeZoneDateTime = DateTime.MinValue;
else
{
fb.StartDateTime.TimeZoneDateTime = dtpStartDate.Value;
fb.StartDateTime.ValueLocation = ValLocValue.DateTime;
}
if(!dtpEndDate.Checked)
fb.EndDateTime.TimeZoneDateTime = DateTime.MinValue;
else
{
fb.EndDateTime.TimeZoneDateTime = dtpEndDate.Value;
fb.StartDateTime.ValueLocation = ValLocValue.DateTime;
}
fb.Duration.DurationValue = new Duration(txtDuration.Text);
fb.Url.Value = txtUrl.Text;
fb.Comment.Value = txtComments.Text;
// For the collections, we'll clear the existing items and copy the modified items from the browse
// control binding sources.
fb.Attendees.Clear();
fb.Attendees.CloneRange((AttendeePropertyCollection)ucAttendees.BindingSource.DataSource);
fb.FreeBusy.Clear();
fb.FreeBusy.CloneRange((FreeBusyPropertyCollection)ucFreeBusy.BindingSource.DataSource);
fb.RequestStatuses.Clear();
fb.RequestStatuses.CloneRange((RequestStatusPropertyCollection)ucRequestStatus.BindingSource.DataSource);
// Set the time zone in the object after getting all the data. The "Set" method will not modify the
// date/times like the "Apply" method does.
if(cboTimeZone.Enabled && cboTimeZone.SelectedIndex != 0)
fb.SetTimeZone(VCalendar.TimeZones[cboTimeZone.SelectedIndex - 1]);
else
fb.SetTimeZone(null);
}
