EPOC   SDK Home Glossary Indexes Previous   Up

CAgnEntry class


CAgnEntry class — Agenda entry

CAgnEntry is the abstract base class for the concrete Agenda entry types, defined in agmentry.h. In EPOC Release 5 it has been extended to include attendee details and a location field, by the addition of the functions described below. Applications that call these member functions will not work correctly on a version of EPOC earlier than ER5

The location field is a text field which has been added in order to support synchronization. To set and retrieve the contents of an entry's location field, use the following new CAgnEntry functions:

    void SetLocationL(const TDesC& aLocation);
    TPtrC Location();

The following functions have been added for adding and retrieving attendee information:

TBool HasAttendees();

TInt AttendeeCount();

CAgnAttendee* FetchAttendee(TInt aIndex);

void AddAttendeeL(CAgnAttendee* aAttendee);

void DeleteAttendee(TInt aIndex);

Any number of attendees can be specified for an entry. Attendee details may be set and retrieved using the new CAgnAttendee class (defined in agmxentr.h) which has the following fields:

Address — Either a contact id, or a message address (e.g. email address). May be assigned a descriptor of any length.

Role — one of EAttendee, EOrganizer, EOwner or EDelegate. Defaults to EAttendee.

Status — one of EAccepted, ENeedsAction, ESent, ETentative, EConfirmed, EDeclined, ECompleted or EDelegated. Defaults to ENeedsAction.

Rsvp — ETrue or EFalse. Defaults to EFalse.

Expect — a priority indication. One of EFyi, ERequire, ERequest, EImmediate. Defaults to EFyi.

EPOC       SDK Home Glossary Indexes Previous   Up