//===================================================================== /// <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); }