#include <calentry.h>
Link against:
calinterimapi.lib
class CCalEntry : public CBase;
Description
Class representing a calendar entry. This can be an appointment, to-do item, reminder, event or anniversary.
CCalEntry contains information about a calendar entry, including a repeat definition, synchronisation information, and group
scheduling data.
A repeating calendar entry has more than one occurrence. Instances are represented by the CCalInstance
class.
Synchronisation information includes a record of the date/time the entry was last modified. This can be found by calling the
CCalEntry::LastModifiedDateL()const
function.
Derivation
CBase
-
Base class for all classes to be instantiated on the heap.
CCalEntry
- Class representing a calendar entry. This can be an appointment, to-do item, rem...
Members
Defined in CCalEntry
:
AddAttendeeL(CCalAttendee *)
Adds an attendee for this entry.
AddAttendeeL(CCalAttendee *)
AddCategoryL(CCalCategory *)
Appends a category to the entry's list of categories.
AddCategoryL(CCalCategory *)
AlarmL()const
Creates an alarm class containing data for this entry's alarm.
AlarmL()const
AttendeesL()const
Gets the attendees for this entry.
AttendeesL()const
CategoryListL()
Gets a list of the entry's categories.
CategoryListL()
ClearRepeatingPropertiesL()
Clears the repeat details including exceptions and unsets the entry's 'is repeat...
ClearRepeatingPropertiesL()
CompareL(const CCalEntry &)const
Compares another entry for equality with this one.
CompareL(const CCalEntry &)const
CompletedTimeL()const
Gets a to-do entry's completed date.
CompletedTimeL()const
CopyFromL(const CCalEntry &)
Copies the contents of another entry to this one. All entry fields will be overw...
CopyFromL(const CCalEntry &)
CopyFromL(const CCalEntry &,TCopyType)
Copies the contents of another entry to this one. The entry fields that are copi...
CopyFromL(const CCalEntry &,TCopyType)
DTStampL()const
Gets the entry's DTSTAMP.
DTStampL()const
DeleteAttendeeL(TInt)
Deletes an attendee from this entry.
DeleteAttendeeL(TInt)
DeleteCategoryL(TInt)
Deletes a category from the entry's list of categories.
DeleteCategoryL(TInt)
DescriptionL()const
Gets the description text for the entry.
DescriptionL()const
EAnniv
An anniversary, which has a start time and end time.
EAnniv
An anniversary, which has a start time and end time.
EAppt
An appointment, which has a start time and end time.
EAppt
An appointment, which has a start time and end time.
ECancelled
The entry has been cancelled.
ECancelled
The entry has been cancelled.
EConfirmed
The entry has been confirmed.
EConfirmed
The entry has been confirmed.
ECopyAll
Copy the ID of the entry
ECopyAll
Copy the ID of the entry
EDontCopyId
Dont copy ID of the entry
EDontCopyId
Dont copy ID of the entry
EEvent
An event, which has a start time and end time.
EEvent
An event, which has a start time and end time.
EMethodAdd
The RFC2445-defined method value 'Add'.
EMethodAdd
The RFC2445-defined method value 'Add'.
EMethodCancel
The RFC2445-defined method value 'Cancel'.
EMethodCancel
The RFC2445-defined method value 'Cancel'.
EMethodCounter
The RFC2445-defined method value 'Counter'.
EMethodCounter
The RFC2445-defined method value 'Counter'.
EMethodDeclineCounter
The RFC2445-defined method value 'DeclineCounter'.
EMethodDeclineCounter
The RFC2445-defined method value 'DeclineCounter'.
EMethodNone
The RFC2445-defined method value 'None'.
EMethodNone
The RFC2445-defined method value 'None'.
EMethodPublish
The RFC2445-defined method value 'Publish'.
EMethodPublish
The RFC2445-defined method value 'Publish'.
EMethodRefresh
The RFC2445-defined method value 'Refresh'.
EMethodRefresh
The RFC2445-defined method value 'Refresh'.
EMethodReply
The RFC2445-defined method value 'Reply'.
EMethodReply
The RFC2445-defined method value 'Reply'.
EMethodRequest
The RFC2445-defined method value 'Request'.
EMethodRequest
The RFC2445-defined method value 'Request'.
ENullStatus
No Status is Set
ENullStatus
No Status is Set
EOpen
No restriction on access.
EOpen
No restriction on access.
EPrivate
Data is private (no access).
EPrivate
Data is private (no access).
EReminder
A reminder, which has a start time only.
EReminder
A reminder, which has a start time only.
ERestricted
Data is confidential (restricted access).
ERestricted
Data is confidential (restricted access).
ETentative
The entry is tentative.
ETentative
The entry is tentative.
ETodo
A to-do, which can have a start time and end time (the end time is the due date)...
ETodo
A to-do, which can have a start time and end time (the end time is the due date)...
ETodoCompleted
The to-do entry has been completed.
ETodoCompleted
The to-do entry has been completed.
ETodoInProcess
The to-do entry is in progress.
ETodoInProcess
The to-do entry is in progress.
ETodoNeedsAction
The to-do entry needs action.
ETodoNeedsAction
The to-do entry needs action.
EVCalAccepted
Used to support vCalendar 1.0. The entry has been accepted.
EVCalDeclined
Used to support vCalendar 1.0. The entry has been declined.
EVCalDelegated
Used to support vCalendar 1.0. The entry has been delegated.
EVCalNeedsAction
Used to support vCalendar 1.0. The entry needs action.
EVCalSent
Used to support vCalendar 1.0. The entry has been sent.
EndTimeL()const
Gets the entry's end date/time.
EndTimeL()const
EntryTypeL()const
Gets the type of entry.
EntryTypeL()const
GetExceptionDatesL(RArray< TCalTime > &)const
Gets a list of all exception dates on this group scheduling entry.
GetExceptionDatesL(RArray< TCalTime > &)const
GetRDatesL(RArray< TCalTime > &)const
Gets a list of all RDATEs in this group scheduling entry.
GetRDatesL(RArray< TCalTime > &)const
GetRRuleL(TCalRRule &)const
Get the entry's repeat rule.
GetRRuleL(TCalRRule &)const
LastModifiedDateL()const
Gets the entry's last changed date/time.
LastModifiedDateL()const
LocalUidL()const
Gets the calendar local id of this entry. Note that this is the unique (for each...
LocalUidL()const
LocationL()const
Gets the contents of the entry's location field.
LocationL()const
MethodL()const
Returns the entry's method property for group scheduling.
MethodL()const
NewL(TType,HBufC8 *,TMethod,TUint)
Allocates and constructs a new entry of the specified type, Global UID and seque...
NewL(TType,HBufC8 *,TMethod,TUint)
OrganizerL()const
Gets the organizer for this entry. This function creates a new CCalUser object c...
OrganizerL()const
PhoneOwnerL()const
Gets the phone owner for this entry. This function creates a new CCalUser object...
PhoneOwnerL()const
PriorityL()const
Gets the priority of the entry.
PriorityL()const
RecurrenceIdL()const
Returns the entry's recurrence ID for group scheduling.
RecurrenceIdL()const
RecurrenceRangeL()const
Returns the recurrence range for the entry's recurrence ID.
RecurrenceRangeL()const
ReplicationStatusL()const
Gets the entry replication status.
ReplicationStatusL()const
SequenceNumberL()const
Returns the entry's sequence number for group scheduling.
SequenceNumberL()const
SetAlarmL(CCalAlarm *)
Set the alarm for the entry.
SetAlarmL(CCalAlarm *)
SetCompletedL(TBool,const TCalTime &)
Sets the crossed out date for a to-do entry. This is the date on which the requi...
SetCompletedL(TBool,const TCalTime &)
SetDTStampL(const TCalTime &)
Sets the entry's DTSTAMP to the time specified.
SetDTStampL(const TCalTime &)
SetDescriptionL(const TDesC &)
Sets the description text for this entry.
SetDescriptionL(const TDesC &)
SetExceptionDatesL(const RArray< TCalTime > &)
Adds the given exception dates to this group scheduling entry.
SetExceptionDatesL(const RArray< TCalTime > &)
SetLastModifiedDateL()
Sets the entry's last modified date to the current time.
SetLastModifiedDateL()
SetLastModifiedDateL(const TCalTime &)
Sets the entry's last modified date to the time provided.
SetLocalUidL(TCalLocalUid)
Sets the calendar local id for this entry. This should be only used to set the s...
SetLocalUidL(TCalLocalUid)
SetLocationL(const TDesC &)
Sets the contents of the entry's location field.
SetLocationL(const TDesC &)
SetMethodL(TMethod)
Sets the entry's method property for group scheduling.
SetMethodL(TMethod)
SetOrganizerL(CCalUser *)
Sets the organizer for this entry.
SetOrganizerL(CCalUser *)
SetPhoneOwnerL(const CCalUser *)
Sets the phone owner for this entry.
SetPhoneOwnerL(const CCalUser *)
SetPriorityL(TUint)
Sets the priority for the entry.
SetPriorityL(TUint)
SetRDatesL(const RArray< TCalTime > &)
Replaces this group scheduling entry's list of RDATEs.
SetRDatesL(const RArray< TCalTime > &)
SetRRuleL(const TCalRRule &)
Sets the entry's repeat definition.
SetRRuleL(const TCalRRule &)
SetReplicationStatusL(TReplicationStatus)
Sets the entry replication status.
SetReplicationStatusL(TReplicationStatus)
SetSequenceNumberL(TInt)
Sets the entry's sequence number for group scheduling.
SetSequenceNumberL(TInt)
SetStartAndEndTimeL(const TCalTime &,const TCalTime &)
Sets the start and end date/times for an entry.
SetStartAndEndTimeL(const TCalTime &,const TCalTime &)
SetStatusL(TStatus)
Sets the entry status.
SetStatusL(TStatus)
SetSummaryL(const TDesC &)
Sets the summary text for this entry.
SetSummaryL(const TDesC &)
SetTzRulesL()
Creates the timezone rules for this entry's repeat rule from the local time zone...
SetTzRulesL()
SetTzRulesL(const CTzRules &)
Sets the timezone rules for this entry's repeat rule.
SetTzRulesL(const CTzRules &)
StartTimeL()const
Gets the start date/time for an entry.
StartTimeL()const
StatusL()const
Gets the entry status.
StatusL()const
SummaryL()const
Gets the summary for the entry.
SummaryL()const
TCopyType
Specify which entry details are to be copied in CCalEntry::CopyFromL(const CCalE...
TCopyType
Specify which entry details are to be copied in CCalEntry::CopyFromL(const CCalE...
TMethod
The method property of a Group Scheduling entry.
TMethod
The method property of a Group Scheduling entry.
TReplicationStatus
Replication status.
TReplicationStatus
Replication status.
TStatus
Defines the possible status values of the entry.
TStatus
Defines the possible status values of the entry. There are values here to suppor...
TType
Defines the type of the calendar entry.
TType
Defines the type of the calendar entry.
TzRulesL()const
Gets the timezone rules for this entry's repeat rule.
TzRulesL()const
UidL()const
Returns the entry's Global UID for group scheduling.
UidL()const
~CCalEntry()
The destructor frees all resources owned by the entry, prior to its destruction.
~CCalEntry()
Inherited from CBase
:
Related Topics
»
Symbian OS v9.4 »
Examples »
Application Engines example code »
CalinterimAPI: Using Calendar API
Construction and destruction
NewL(TType,HBufC8 *,TMethod,TUint)
IMPORT_C static CCalEntry* NewL(TType aType, HBufC8 *aUid, TMethod aMethod, TUint aSeqNum);
Description
Allocates and constructs a new entry of the specified type, Global UID and sequence number.
The entry's data is all initialised to default values, e.g. the start and end dates are reset to null.
The entry takes ownership of the Uid descriptor.
Note that this function will not work unless a CCalSession
has been created by calling CCalSession::NewL()
.
Parameters
CCalEntry::TType aType |
One of: EAppt, ETodo, EEvent, EReminder, EAnniv to create an appointment, a todo, an event, a reminder or an anniversary entry.
|
HBufC8 *aUid |
The Global UID of the entry. This field is mandatory.
|
CCalEntry::TMethod aMethod |
The Method value describing the entry. Default value is EGSMethodNone.
|
TUint aSeqNum |
The sequence number of the entry. Default value is 0.
|
|
Return value
NewL(TType,HBufC8 *,TMethod,TUint,const TCalTime &,CalCommon::TRecurrenceRange)
IMPORT_C static CCalEntry* NewL(TType aType, HBufC8 *aUid, TMethod aMethod, TUint aSeqNum, const TCalTime &aRecurrenceId,
CalCommon::TRecurrenceRange aRange);
Description
Allocates and constructs a new entry of the specified type, Global UID, sequence number and recurrence ID.
The entry takes ownership of the Uid descriptor.
Parameters
CCalEntry::TType aType |
One of: EAppt, ETodo, EEvent, EReminder, EAnniv to create an appointment, a todo, an event, a reminder or an anniversary entry.
|
HBufC8 *aUid |
The Global UID of the entry.
|
CCalEntry::TMethod aMethod |
The Method value describing the entry.
|
TUint aSeqNum |
The sequence number of the entry.
|
const TCalTime &aRecurrenceId |
The recurrence ID of the entry.
|
CalCommon::TRecurrenceRange aRange |
The recurrence ID range of the entry.
|
|
Return value
Leave codes
KErrArgument |
If the UID passed is invalid
|
|
Panic codes
CalInterimAPI |
8 If the entry type passed is invalid
|
|
IMPORT_C ~CCalEntry();
Description
The destructor frees all resources owned by the entry, prior to its destruction.
NewL(TType,HBufC8 *,TMethod,TUint)
IMPORT_C static CCalEntry* NewL(TType aType, HBufC8 *aUid, TMethod aMethod, TUint aSeqNum);
Description
Parameters
Return value
NewL(TType,HBufC8 *,TMethod,TUint,const TCalTime &,CalCommon::TRecurrenceRange)
IMPORT_C static CCalEntry* NewL(TType aType, HBufC8 *aUid, TMethod aMethod, TUint aSeqNum, const TCalTime &aRecurrenceId,
CalCommon::TRecurrenceRange aRange);
Description
Parameters
Return value
IMPORT_C ~CCalEntry();
Description
IMPORT_C TCalTime StartTimeL() const;
Description
Gets the start date/time for an entry.
Return value
IMPORT_C TCalTime EndTimeL() const;
Description
Gets the entry's end date/time.
Return value
SetStartAndEndTimeL(const TCalTime &,const TCalTime &)
IMPORT_C void SetStartAndEndTimeL(const TCalTime &aStartTime, const TCalTime &aEndTime);
Description
Sets the start and end date/times for an entry.
For an appointment, event or anniversary, the start time must be earlier than or equal to the end time. For a reminder, the
end time will be ignored. For a to-do entry, the end time is the 'due date'. The time portion of the start date will not be
stored for todos, only the number of days until the due date. Only Undated Todo's can have both start and end date as NullTime.
This function adjusts the start time of the repeat rule to the first instance. For EAppt, EEvent, EReminder, EAnniv this function
also aligns the start time of the entry with that of the repeat rule. For ETodo, the due date (i.e. the end time) is aligned
to the repeat rule start date.
Parameters
const TCalTime &aStartTime |
The entry's new start date/time.
|
const TCalTime &aEndTime |
The entry's new end date/time.
|
|
Leave codes
KErrArgument |
If the start and end times are invalid.
|
|
IMPORT_C void SetLastModifiedDateL();
Description
Sets the entry's last modified date to the current time.
IMPORT_C TCalTime LastModifiedDateL() const;
Description
Gets the entry's last changed date/time.
Return value
TCalTime
|
The time at which the entry was last modified.
|
|
SetDTStampL(const TCalTime &)
IMPORT_C void SetDTStampL(const TCalTime &aTime);
Description
Sets the entry's DTSTAMP to the time specified.
This method may be called by clients to record the date/time that the entry was prepared for sending to a recipient as a scheduling
object, as specified in RFC 2445, the Internet Calendaring and Scheduling Core Object Specification iCalendar). This value
will be Time::NullTTime()
by default unless the client sets it otherwise.
Parameters
const TCalTime &aTime |
The time that the DTSTAMP will be set to
|
|
IMPORT_C TCalTime DTStampL() const;
Description
Gets the entry's DTSTAMP.
Return value
IMPORT_C TCalTime CompletedTimeL() const;
Description
Gets a to-do entry's completed date.
This is the date on which the required action was carried out. If the entry has not been crossed out, or if this is not a
to-do entry, then this function returns a null value.
Return value
TCalTime
|
The to-do entry's crossed out date.
|
|
SetCompletedL(TBool,const TCalTime &)
IMPORT_C void SetCompletedL(TBool aCompleted, const TCalTime &aTime);
Description
Sets the crossed out date for a to-do entry. This is the date on which the required action was carried out.
If this function is called on an entry which is not a to-do, it will leave with KErrNotSupported.
Parameters
TBool aCompleted |
ETrue if the to-do entry is complete - the entry's status is set to ETodoCompleted; EFalse if the to-do entry is not complete
- the entry's status is set to ETodoNeedsAction
|
const TCalTime &aTime |
The to-do entry's crossed out date. The time mode should not be floating, it will leave with KErrArgument if it is.
|
|
SetRRuleL(const TCalRRule &)
IMPORT_C void SetRRuleL(const TCalRRule &aRule);
Description
Sets the entry's repeat definition.
The repeat definition includes daily, weekly, monthly and yearly repeat details, and start and end details.
The start time of the repeat rule and the start and end time of the entry will be adjusted to match the first instance of
the repeat rule.
This does not take ownership of the parameter.
Parameters
const TCalRRule &aRule |
The new repeat definition.
|
|
Leave codes
KErrNotSupported |
If the repeat rule passed is not one that is currently supported
|
KErrArgument |
if this is a todo entry and its end date has not been set or this is a non-todo entry and its start date has not been set
|
|
GetRRuleL(TCalRRule &)const
IMPORT_C TBool GetRRuleL(TCalRRule &aRule) const;
Description
Get the entry's repeat rule.
In the returned TCalRRule
, both the Count and the Until values can be accessed. However, in the case of a repeat rule which repeats forever, the Count
will always be returned as 0.
Parameters
TCalRRule &aRule |
On return contains the entry's repeat rule data, if present.
|
|
Return value
TBool
|
ETrue if the entry has a repeat rule, EFalse if not.
|
|
SetRDatesL(const RArray< TCalTime > &)
IMPORT_C void SetRDatesL(const RArray< TCalTime > &aRDateList);
Description
Replaces this group scheduling entry's list of RDATEs.
Parameters
const RArray < TCalTime > &aRDateList |
List of RDATEs to replace current RDATEs.
|
|
Leave codes
KErrArgument |
If the time mode of the RDATEs don't match the time mode of the entry
|
|
GetRDatesL(RArray< TCalTime > &)const
IMPORT_C void GetRDatesL(RArray< TCalTime > &aRDateList) const;
Description
Gets a list of all RDATEs in this group scheduling entry.
Parameters
RArray < TCalTime > &aRDateList |
On return, an array of RDATEs for this entry.
|
|
SetExceptionDatesL(const RArray< TCalTime > &)
IMPORT_C void SetExceptionDatesL(const RArray< TCalTime > &aExDateList);
Description
Adds the given exception dates to this group scheduling entry.
Parameters
const RArray < TCalTime > &aExDateList |
The exception dates to be added.
|
|
Leave codes
KErrArgument |
If the time mode of the exception dates don't match the time mode of the entry
|
|
GetExceptionDatesL(RArray< TCalTime > &)const
IMPORT_C void GetExceptionDatesL(RArray< TCalTime > &aExDateList) const;
Description
Gets a list of all exception dates on this group scheduling entry.
Parameters
RArray < TCalTime > &aExDateList |
On return, an array of exception dates for this entry.
|
|
ClearRepeatingPropertiesL()
IMPORT_C void ClearRepeatingPropertiesL();
Description
Clears the repeat details including exceptions and unsets the entry's 'is repeating' property.
IMPORT_C void SetAlarmL(CCalAlarm *aAlarm);
Description
Set the alarm for the entry.
This doesn't take ownership of the parameter. This function will leave with KErrNotSupported if the alarm is not on same day.
Parameters
CCalAlarm *aAlarm |
Pointer to the alarm, or NULL if the alarm is to be cleared.
|
|
IMPORT_C CCalAlarm* AlarmL() const;
Description
Creates an alarm class containing data for this entry's alarm.
Return value
CCalAlarm *
|
Pointer to a new alarm object, or NULL if this entry doesn't have one.
|
|
CompareL(const CCalEntry &)const
IMPORT_C TBool CompareL(const CCalEntry &aEntry) const;
Description
Compares another entry for equality with this one.
Parameters
Return value
TBool
|
ETrue if aEntry is the same as this entry, EFalse if not.
|
|
CopyFromL(const CCalEntry &)
IMPORT_C void CopyFromL(const CCalEntry &aOther);
Description
Copies the contents of another entry to this one. All entry fields will be overwritten, including the UID and the local UID.
This is identical to calling CopyFromL(aOther, ECopyAll).
Parameters
const CCalEntry &aOther |
Reference to source entry.
|
|
Panic codes
CalInterimAPI |
7 If the entry type is invalid
|
|
CopyFromL(const CCalEntry &,TCopyType)
IMPORT_C void CopyFromL(const CCalEntry &aOther, TCopyType aCopyType);
Description
Copies the contents of another entry to this one. The entry fields that are copied can be specified using the TCopyType parameter.
Parameters
const CCalEntry &aOther |
Reference to source entry.
|
CCalEntry::TCopyType aCopyType |
Which entry details are to be copied. ECopyAll if original entry and new entry should be identical. This is identical to calling
CopyFromL(aOther). EDontCopyId if UID and local UID should not be copied, this should be used when creating a modifying entry.
|
|
Panic codes
CalInterimAPI |
7 If the entry type is invalid
|
|
SetSummaryL(const TDesC &)
IMPORT_C void SetSummaryL(const TDesC &aSummary);
Description
Sets the summary text for this entry.
Parameters
const TDesC16 &aSummary |
The summary text.
|
|
Leave codes
KErrNotFound |
If a handle to the entry's summary could not be obtained
|
|
IMPORT_C const TDesC& SummaryL() const;
Description
Gets the summary for the entry.
Return value
const TDesC16 & |
Descriptor pointer to the summary text.
|
|
Leave codes
KErrNotFound |
If a handle to the entry's summary could not be obtained
|
|
SetDescriptionL(const TDesC &)
IMPORT_C void SetDescriptionL(const TDesC &aDescription);
Description
Sets the description text for this entry.
Parameters
const TDesC16 &aDescription |
The summary text.
|
|
IMPORT_C TCalTime StartTimeL() const;
Description
Return value
IMPORT_C const TDesC& DescriptionL() const;
Description
Gets the description text for the entry.
Return value
const TDesC16 & |
Descriptor pointer to the description text.
|
|
IMPORT_C TCalTime EndTimeL() const;
Description
Return value
SetLocationL(const TDesC &)
IMPORT_C void SetLocationL(const TDesC &aLocation);
Description
Sets the contents of the entry's location field.
Parameters
const TDesC16 &aLocation |
Descriptor containing a location, e.g. for a meeting.
|
|
SetStartAndEndTimeL(const TCalTime &,const TCalTime &)
IMPORT_C void SetStartAndEndTimeL(const TCalTime &aStartTime, const TCalTime &aEndTime);
Description
Parameters
IMPORT_C const TDesC& LocationL() const;
Description
Gets the contents of the entry's location field.
Return value
const TDesC16 & |
The location field.
|
|
IMPORT_C void SetLastModifiedDateL();
Description
SetLastModifiedDateL(const TCalTime &)
IMPORT_C void SetLastModifiedDateL(const TCalTime &aModifiedTime);
Description
Sets the entry's last modified date to the time provided.
Parameters
const TCalTime &aModifiedTime |
The time used to set the last modified date.
|
|
AddCategoryL(CCalCategory *)
IMPORT_C void AddCategoryL(CCalCategory *aCategory);
Description
Appends a category to the entry's list of categories.
The entry takes ownership of the category specified.
Parameters
IMPORT_C TCalTime LastModifiedDateL() const;
Description
Return value
IMPORT_C void DeleteCategoryL(TInt aIndex);
Description
Deletes a category from the entry's list of categories.
Parameters
TInt aIndex |
The category to be deleted.
|
|
IMPORT_C const RPointerArray< CCalCategory >& CategoryListL();
Description
Gets a list of the entry's categories.
Return value
SetDTStampL(const TCalTime &)
IMPORT_C void SetDTStampL(const TCalTime &aTime);
Description
Parameters
IMPORT_C TCalTime DTStampL() const;
Description
Return value
AddAttendeeL(CCalAttendee *)
IMPORT_C void AddAttendeeL(CCalAttendee *aAttendee);
Description
Adds an attendee for this entry.
Parameters
IMPORT_C TCalTime CompletedTimeL() const;
Description
Return value
IMPORT_C void DeleteAttendeeL(TInt aIndex);
Description
Deletes an attendee from this entry.
Parameters
TInt aIndex |
The index of the attendee (found in FetchAttendeesL) to be removed.
|
|
Leave codes
KErrArgument |
If the Index passed in is out of bounds
|
|
SetCompletedL(TBool,const TCalTime &)
IMPORT_C void SetCompletedL(TBool aCompleted, const TCalTime &aTime);
Description
Parameters
IMPORT_C RPointerArray< CCalAttendee >& AttendeesL() const;
Description
Gets the attendees for this entry.
Return value
SetOrganizerL(CCalUser *)
IMPORT_C void SetOrganizerL(CCalUser *aUser);
Description
Sets the organizer for this entry.
Parameters
CCalUser *aUser |
The organizer (Entry takes ownership).
|
|
IMPORT_C CCalUser* OrganizerL() const;
Description
Gets the organizer for this entry. This function creates a new CCalUser
object containing the organizer data.
Return value
CCalUser *
|
The organizer if present, NULL if not.
|
|
SetRRuleL(const TCalRRule &)
IMPORT_C void SetRRuleL(const TCalRRule &aRule);
Description
Parameters
SetPhoneOwnerL(const CCalUser *)
IMPORT_C void SetPhoneOwnerL(const CCalUser *aOwner);
Description
Sets the phone owner for this entry.
Parameters
const CCalUser *aOwner |
The phone owner (entry takes ownership).
|
|
GetRRuleL(TCalRRule &)const
IMPORT_C TBool GetRRuleL(TCalRRule &aRule) const;
Description
Parameters
Return value
IMPORT_C CCalUser* PhoneOwnerL() const;
Description
Gets the phone owner for this entry. This function creates a new CCalUser
object containing the phone owner data.
Return value
CCalUser *
|
The phone owner if present, NULL if not.
|
|
SetRDatesL(const RArray< TCalTime > &)
IMPORT_C void SetRDatesL(const RArray< TCalTime > &aRDateList);
Description
Parameters
GetRDatesL(RArray< TCalTime > &)const
IMPORT_C void GetRDatesL(RArray< TCalTime > &aRDateList) const;
Description
Parameters
IMPORT_C TType EntryTypeL() const;
Description
Gets the type of entry.
Return value
CCalEntry::TType
|
The entry type. One of: EAppt, ETodo, EEvent, EReminder, EAnniv.
|
|
IMPORT_C void SetStatusL(TStatus aStatus);
Description
Sets the entry status.
For a to-do entry, this is one of: ECancelled, ETodoNeedsAction, ETodoCompleted, ETodoInProgress.
For any other entry types, this is one of: ECancelled, ETentative, EConfirmed.
Passing a value in which does not match the entry type will result in a panic.
Parameters
Leave codes
KErrArgument |
If the status passed in is invalid
|
|
SetExceptionDatesL(const RArray< TCalTime > &)
IMPORT_C void SetExceptionDatesL(const RArray< TCalTime > &aExDateList);
Description
Parameters
IMPORT_C TStatus StatusL() const;
Description
Gets the entry status.
For a to-do entry, this is one of: ECancelled, ETodoNeedsAction, ETodoCompleted, ETodoInProgress.
For any other entry types, this is one of: ECancelled, ETentative, EConfirmed.
Return value
Panic codes
CalInterimAPI |
4 The status of the entry is invalid
|
|
GetExceptionDatesL(RArray< TCalTime > &)const
IMPORT_C void GetExceptionDatesL(RArray< TCalTime > &aExDateList) const;
Description
Parameters
SetReplicationStatusL(TReplicationStatus)
IMPORT_C void SetReplicationStatusL(TReplicationStatus aReplicationStatus);
Description
Sets the entry replication status.
Parameters
ClearRepeatingPropertiesL()
IMPORT_C void ClearRepeatingPropertiesL();
Description
ReplicationStatusL()const
IMPORT_C TReplicationStatus ReplicationStatusL() const;
Description
Gets the entry replication status.
This is defined by TReplicationStatus. Default is TReplicationStatus::EOpen
Return value
IMPORT_C void SetPriorityL(TUint aPriority);
Description
Sets the priority for the entry.
The default value is zero.
Parameters
TUint aPriority |
Priority value between 0 and 255. The behaviour is undefined if the priority is greater than 255.
|
|
IMPORT_C void SetAlarmL(CCalAlarm *aAlarm);
Description
Parameters
IMPORT_C TUint PriorityL() const;
Description
Gets the priority of the entry.
Return value
TUint
|
Priority value between 0 and 255.
|
|
IMPORT_C CCalAlarm* AlarmL() const;
Description
Return value
IMPORT_C void SetMethodL(TMethod aMethod);
Description
Sets the entry's method property for group scheduling.
Parameters
CCalEntry::TMethod aMethod |
The method, this is one of: EMethodNone, EMethodPublish, EMethodRequest, EMethodReply, EMethodAdd, EMethodCancel, EMethodRefresh,
EMethodCounter, EMethodDeclineCounter.
|
|
IMPORT_C TMethod MethodL() const;
Description
Returns the entry's method property for group scheduling.
Return value
CCalEntry::TMethod
|
The method, this is one of: EMethodNone, EMethodPublish, EMethodRequest, EMethodReply, EMethodAdd, EMethodCancel, EMethodRefresh,
EMethodCounter, EMethodDeclineCounter.
|
|
CompareL(const CCalEntry &)const
IMPORT_C TBool CompareL(const CCalEntry &aEntry) const;
Description
Parameters
Return value
IMPORT_C void SetSequenceNumberL(TInt aSeq);
Description
Sets the entry's sequence number for group scheduling.
Parameters
TInt aSeq |
The sequence number.
|
|
IMPORT_C TInt SequenceNumberL() const;
Description
Returns the entry's sequence number for group scheduling.
Return value
TInt
|
The sequence number.
|
|
IMPORT_C const TDesC8& UidL() const;
Description
Returns the entry's Global UID for group scheduling.
Return value
const TDesC8 & |
The Global UID.
|
|
CopyFromL(const CCalEntry &)
IMPORT_C void CopyFromL(const CCalEntry &aOther);
Description
Parameters
IMPORT_C TCalTime RecurrenceIdL() const;
Description
Returns the entry's recurrence ID for group scheduling.
Return value
CopyFromL(const CCalEntry &,TCopyType)
IMPORT_C void CopyFromL(const CCalEntry &aOther, TCopyType aCopyType);
Description
Parameters
IMPORT_C CalCommon::TRecurrenceRange RecurrenceRangeL() const;
Description
Returns the recurrence range for the entry's recurrence ID.
Return value
IMPORT_C CTzRules* TzRulesL() const;
Description
Gets the timezone rules for this entry's repeat rule.
Return value
CTzRules *
|
A copy of the entry's timezone rules.
|
|
SetSummaryL(const TDesC &)
IMPORT_C void SetSummaryL(const TDesC &aSummary);
Description
Parameters
SetTzRulesL(const CTzRules &)
IMPORT_C void SetTzRulesL(const CTzRules &aTzRule);
Description
Sets the timezone rules for this entry's repeat rule.
Parameters
const CTzRules &aTzRule |
The entry's timezone rules. This function does not take ownership.
|
|
Leave codes
KErrNotFound |
If there is not a repeat definition in the entry
|
KErrArgument |
If the entry uses floating time mode
|
|
IMPORT_C const TDesC& SummaryL() const;
Description
Return value
IMPORT_C void SetTzRulesL();
Description
Creates the timezone rules for this entry's repeat rule from the local time zone settings.
Leave codes
KErrNotFound |
If there is not a repeat definition in the entry
|
KErrArgument |
If the entry uses floating time mode
|
|
SetDescriptionL(const TDesC &)
IMPORT_C void SetDescriptionL(const TDesC &aDescription);
Description
Parameters
IMPORT_C const TDesC& DescriptionL() const;
Description
Return value
SetLocalUidL(TCalLocalUid)
IMPORT_C void SetLocalUidL(TCalLocalUid aLocalId);
Description
Sets the calendar local id for this entry. This should be only used to set the same unique id on a new entry which is the
replacement of an existing one in the Calendar store.
Parameters
SetLocationL(const TDesC &)
IMPORT_C void SetLocationL(const TDesC &aLocation);
Description
Parameters
IMPORT_C TCalLocalUid LocalUidL() const;
Description
Gets the calendar local id of this entry. Note that this is the unique (for each Calendar file) Id of the entry allocated
by the Calendar server internally and will remain unchanged for lifetime of the entry.
Return value
TCalLocalUid
|
The calendar local id.
|
|
IMPORT_C const TDesC& LocationL() const;
Description
Return value
AddCategoryL(CCalCategory *)
IMPORT_C void AddCategoryL(CCalCategory *aCategory);
Description
Parameters
IMPORT_C void DeleteCategoryL(TInt aIndex);
Description
Parameters
IMPORT_C const RPointerArray< CCalCategory >& CategoryListL();
Description
Return value
AddAttendeeL(CCalAttendee *)
IMPORT_C void AddAttendeeL(CCalAttendee *aAttendee);
Description
Parameters
IMPORT_C void DeleteAttendeeL(TInt aIndex);
Description
Parameters
IMPORT_C RPointerArray< CCalAttendee >& AttendeesL() const;
Description
Return value
SetOrganizerL(CCalUser *)
IMPORT_C void SetOrganizerL(CCalUser *aUser);
Description
Parameters
IMPORT_C CCalUser* OrganizerL() const;
Description
Return value
SetPhoneOwnerL(const CCalUser *)
IMPORT_C void SetPhoneOwnerL(const CCalUser *aOwner);
Description
Parameters
IMPORT_C CCalUser* PhoneOwnerL() const;
Description
Return value
IMPORT_C TType EntryTypeL() const;
Description
Return value
IMPORT_C void SetStatusL(TStatus aStatus);
Description
Parameters
IMPORT_C TStatus StatusL() const;
Description
Return value
SetReplicationStatusL(TReplicationStatus)
IMPORT_C void SetReplicationStatusL(TReplicationStatus aReplicationStatus);
Description
Parameters
ReplicationStatusL()const
IMPORT_C TReplicationStatus ReplicationStatusL() const;
Description
Return value
IMPORT_C void SetPriorityL(TUint aPriority);
Description
Parameters
IMPORT_C TUint PriorityL() const;
Description
Return value
IMPORT_C void SetMethodL(TMethod aMethod);
Description
Parameters
IMPORT_C TMethod MethodL() const;
Description
Return value
IMPORT_C void SetSequenceNumberL(TInt aSeq);
Description
Parameters
IMPORT_C TInt SequenceNumberL() const;
Description
Return value
IMPORT_C const TDesC8& UidL() const;
Description
Return value
IMPORT_C TCalTime RecurrenceIdL() const;
Description
Return value
IMPORT_C CalCommon::TRecurrenceRange RecurrenceRangeL() const;
Description
Return value
IMPORT_C CTzRules* TzRulesL() const;
Description
Return value
SetTzRulesL(const CTzRules &)
IMPORT_C void SetTzRulesL(const CTzRules &aTzRule);
Description
Parameters
IMPORT_C void SetTzRulesL();
Description
SetLocalUidL(TCalLocalUid)
IMPORT_C void SetLocalUidL(TCalLocalUid aLocalId);
Description
Parameters
IMPORT_C TCalLocalUid LocalUidL() const;
Description
Return value
TType
Description
Defines the type of the calendar entry.
EAppt |
An appointment, which has a start time and end time.
|
ETodo |
A to-do, which can have a start time and end time (the end time is the due date), or can be undated.
|
EEvent |
An event, which has a start time and end time.
|
EReminder |
A reminder, which has a start time only.
|
EAnniv |
An anniversary, which has a start time and end time.
|
|
TType
Description
Defines the type of the calendar entry.
EAppt |
An appointment, which has a start time and end time.
|
ETodo |
A to-do, which can have a start time and end time (the end time is the due date), or can be undated.
|
EEvent |
An event, which has a start time and end time.
|
EReminder |
A reminder, which has a start time only.
|
EAnniv |
An anniversary, which has a start time and end time.
|
|
TStatus
Description
Defines the possible status values of the entry.
TStatus
Description
Defines the possible status values of the entry. There are values here to support both iCalendar (RFC 2445) and vCalendar
v1.0 STATUS properties. Enumerated values for vCalendar v1.0 contain the prefix 'EVCal'.
TReplicationStatus
Description
Replication status.
EOpen |
No restriction on access.
|
EPrivate |
Data is private (no access).
|
ERestricted |
Data is confidential (restricted access).
|
|
TMethod
Description
The method property of a Group Scheduling entry.
TReplicationStatus
Description
Replication status.
EOpen |
No restriction on access.
|
EPrivate |
Data is private (no access).
|
ERestricted |
Data is confidential (restricted access).
|
|
TMethod
Description
The method property of a Group Scheduling entry.
TCopyType
Description
Specify which entry details are to be copied in CCalEntry::CopyFromL(const CCalEntry &)
functions.
TCopyType
Description
Specify which entry details are to be copied in CCalEntry::CopyFromL(const CCalEntry &)
functions.