Collapse all Symbian^3 Application Developer Library

Calendar User

CCalUser represents a calendar user, such as a meeting participant. The class provides attributes and methods that are common to all the calendar users, including the user’s email address, sent-by and common name fields.

You can construct a new calendar user with a specified email address, and optionally a sender, using the factory function CCalUser::NewL() .

Attendee

An attendee is a specialised calendar user used for attendees of an event. It is used only in group scheduled entries, and not for a single calendar user. The CCalAttendee class, derived from CCalUser , provides additional methods to store and retrieve an attendee's ROLE, PART-STAT, and RSVP fields.

       
        
       
       //Create an attendee
_LIT(KAttendee1Address, "tom.smith@org.com");
CCalAttendee* attendee1 = CCalAttendee::NewL(KAttendee1Address);
_LIT(KAttendee1CommonName, "Tom");
attendee1->SetCommonNameL(KAttendee1CommonName);//set common name to Tom
attendee1->SetRoleL(CCalAttendee::EReqParticipant);// set the role of the attendee, other roles Chair and Optional participant
attendee1->SetStatusL(CCalAttendee::EAccepted);// set the status value

       
        
       
       // setup the entry
entry->CCalEntry::NewL(CCalEntry::EAppt, guid, CCalEntry::EMethodNone, 0);
entry->AddAttendeeL(attendee1);//add the attendee to the entry

You can get a list of attendees using CCalEntry::AttendeesL() , and delete a specified attendee using CCalEntry::DeleteAttendeeL() .

Organizer and phone owner

An entry can optionally have one phone owner and one organizer, both of which are of class CCalUser . The organizer may or may not be an attendee of that entry, but the phone owner must be an attendee. An organizer is a required property for a group scheduled entry.

       
        
       
       //Set up the Organizer 
_LIT(KOrganizerAddress1, "harry.smith@org.com"); 
CCalUser* organiser1 = CCalUser::NewL(KOrganizerAddress1, KOrganizerSentByA); 
entry->SetOrganizerL(organiser1); //set the organizer for the event
_LIT(KOrganiserCommonName, "Harry"); 
organiser1->SetCommonNameL(KOrganizerCommonName); //set the  common name to Harry

       
        
       
       //Set up the Phone owner for the calendar entry 
_LIT(KPhoneOwnerAddress1, "dick.smith@org.com"); 
CCalUser* phOwner1 = CCalUser::NewL(KPhoneOwnerAddress1, KOrganizerSentByB); 
entry->SetPhoneOwnerL(phOwner1); 
_LIT(KPhOwnerCommonName, "Dick"); 
organiser1->SetCommonNameL(KPhOwnerCommonName);//set the common name to Dick

Parent topic: Concepts