/** * Description: A "VEVENT" calendar component is a grouping of component * properties, and possibly including "VALARM" calendar components, that * represents a scheduled amount of time on a calendar. For example, it * can be an activity; such as a one-hour long, department meeting from * 8:00 AM to 9:00 AM, tomorrow. Generally, an event will take up time * on an individual calendar. Hence, the event will appear as an opaque * interval in a search for busy time. Alternately, the event can have * its Time Transparency set to "TRANSPARENT" in order to prevent * blocking of the event in searches for busy time. * * Example: The following is an example of the "VEVENT" calendar * component used to represent a meeting that will also be opaque to * searches for busy time: * * BEGIN:VEVENT * UID:19970901T130000Z-123401@host.com * DTSTAMP:19970901T1300Z * DTSTART:19970903T163000Z * DTEND:19970903T190000Z * SUMMARY:Annual Employee Review * CLASS:PRIVATE * CATEGORIES:BUSINESS,HUMAN RESOURCES * END:VEVENT * * The following is an example of the "VEVENT" calendar component used * to represent a reminder that will not be opaque, but rather * transparent, to searches for busy time: * * BEGIN:VEVENT * UID:19970901T130000Z-123402@host.com * DTSTAMP:19970901T1300Z * DTSTART:19970401T163000Z * DTEND:19970402T010000Z * SUMMARY:Laurel is in sensitivity awareness class. * CLASS:PUBLIC * CATEGORIES:BUSINESS,HUMAN RESOURCES * TRANSP:TRANSPARENT * END:VEVENT * * The following is an example of the "VEVENT" calendar component used * to represent an anniversary that will occur annually. Since it takes * up no time, it will not appear as opaque in a search for busy time; * no matter what the value of the "TRANSP" property indicates: * * BEGIN:VEVENT * UID:19970901T130000Z-123403@host.com * DTSTAMP:19970901T1300Z * DTSTART:19971102 * SUMMARY:Our Blissful Anniversary * CLASS:CONFIDENTIAL * CATEGORIES:ANNIVERSARY,PERSONAL,SPECIAL OCCASION * RRULE:FREQ=YEARLY * END:VEVENT * */ public function zzztestMeetingThatWillBeOpaqueToSearchesForBusyTime() { $event = new qCal_Component_Vevent(array('uid' => '*****@*****.**', 'dtstamp' => '19970901T1300Z', 'dtstart' => '19970903T163000Z', 'dtend' => '19970903T190000Z', 'summary' => 'Annual Employee Review', 'class' => 'PRIVATE', 'categories' => array('BUSINESS', 'HUMAN RESOURCES', 'SOMETHING, COOL'))); $cal = new qCal(); $cal->attach($event); $freebusytime = $cal->getFreeBusyTime(); }