Grouping and Filtering
When an appointment is added to the Appointments collection it will be displayed in the calendar if the period (start and end date/time) of the appointment falls within the start and end dates of the calendar. In addition to date filtering it is possible to further filter appointments in the Appointments collection to only view those appointments that match a set of Task, Contact, and/or Location criteria.
Each appointment item contains a field for a Contact, Location, and Task ID. The calendar control also contains properties for the corresponding ID’s.
Filtering
The Appointments collection can be filtered by entering a value for one of the ID values. For example, if a value of “C1” is entered into the ContactID field of the calendar, then only appointments with a matching Contact ID will show up in the control. If a second filter criteria is required, for example Location, entering a Location ID value into the LocationID property of the calendar would require an appointment to have the corresponding ContactID and LocationID values in order to be rendered in the calendar.
Grouping
Grouping occurs when the GroupType property is set to a value of a Contact, Location, or Task. The number of entries in the Contacts, Locations, or Tasks collection will determine the number of calendars rendered in the control (one for each value in the appropriately selected collection). When a GroupType is defined only appointments that contain an ID value will be displayed in their corresponding calendar.
For example; if the GroupType is set to Contacts and the Contacts collection contains three entries with an EntryID value of “C1”, “C2”, and “C3” respectively … the control will display three different calendars, one for each Contact in the Contacts collection. Each calendar will only contain those appointments with a corresponding ContactID value (i.e. C1, C2, or C3).
NOTE : The GroupType property value and the Entry ID of the defined group will override the corresponding Entry ID of the calendar. In other words, if the GroupType is defined as Contacts, the ContactID property of the calendar will be ignored.