#include <mw/msvstd.h>
Link against: msgs_autoshutdown.lib
class TMsvEntry |
Public Attributes | |
---|---|
TInt32 | iBioType |
TTime | iDate |
TPtrC | iDescription |
TPtrC | iDetails |
TInt32 | iError |
TUid | iMtm |
TInt32 | iMtmData1 |
TInt32 | iMtmData2 |
TInt32 | iMtmData3 |
TMsvId | iRelatedId |
TMsvId | iServiceId |
TInt32 | iSize |
TUid | iType |
Protected Member Functions | |
---|---|
TUint | PersistedFlags() |
void | SetDeleted(TBool) |
void | SetId(TMsvId) |
void | SetOwner(TBool) |
void | SetParent(TMsvId) |
TUint | TemporaryFlags() |
Represents an entry in the Message Server index.
MTM implementations and message client applications use it to access and manipulate index entry values. Note that a TMsvEntry is effectively a local cache of the index entry, and changes to it are not automatically written into the index. To commit changes to the Message Server, you need to call CMsvEntry::ChangeL() (or CMsvServerEntry::ChangeEntry()).
To avoid repetition, the functions and data members are simply listed here, without detailed explanation of the fields. The public data members can be used to get and set the values of some index entry fields.
TInt32 | iMtmData1 |
MTM data 1: this can be used for any purpose by an MTM. This member must only be accessed through the predefined set and get functions. If you must write data to a bit that has no meaning in the predefined derived classes then you must derive your own class from TMsvEntry.
TInt32 | iMtmData2 |
MTM data 2: this can be used for any purpose by an MTM. This member must only be accessed through the predefined set and get functions. If you must write data to a bit that has no meaning in the predefined derived classes then you must derive your own class from TMsvEntry.
TInt32 | iMtmData3 |
MTM data 3: this can be used for any purpose by an MTM. This member must only be accessed through the predefined set and get functions. If you must write data to a bit that has no meaning in the predefined derived classes then you must derive your own class from TMsvEntry.
IMPORT_C | TMsvEntry | ( | ) |
Default constructor.
Initialises the new object to null values: 0 for integer values, KMsvNullIndexEntryId for IDs, and KUidMsvNullEntry for UIDs.
IMPORT_C | TMsvEntry | ( | const TMsvEntry & | aEntry | ) |
Copy constructor.
It creates a simple copy of the entry, so the TPtrC members iDescription and iDetails will point to the same descriptor data in the original and new objects.
Parameters | |
---|---|
aEntry | The entry to copy |
TBool | Attachment | ( | ) | const [inline] |
Gets the value of the attachment flag.
TBool | Complete | ( | ) | const [inline] |
Gets the value of the message complete flag.
Note that for email download without size limits, the complete flag will only be set to true once all the parts of the message (body text and attachments) have been downloaded.
TBool | Connected | ( | ) | const [inline] |
Gets the value of the remote server connection flag.
TBool | DeleteProtected | ( | ) | const [inline] |
TBool | Deleted | ( | ) | const [inline] |
Gets the value of the deleted flag.
IMPORT_C void | ExternalizeL | ( | RWriteStream & | aStream | ) | const |
Writes the object into the stream specified.
Parameters | |
---|---|
aStream | Stream to which to write |
TBool | Failed | ( | ) | const [inline] |
Gets the value of the message send failed flag.
TBool | Forwarded | ( | ) | const [inline] |
TMsvId | Id | ( | ) | const [inline] |
Gets the value of the entry ID.
TBool | InPreparation | ( | ) | const [inline] |
Gets the value of the in preparation flag.
IMPORT_C void | InternalizeL | ( | RReadStream & | aStream | ) |
Reads an externalised object from the specified stream.
Parameters | |
---|---|
aStream | Stream from which to read |
TBool | LocallyDeleted | ( | ) | const [inline] |
IMPORT_C TInt32 | MtmData1 | ( | ) | const |
Gets the integer value of iMtmData1
IMPORT_C TInt32 | MtmData2 | ( | ) | const |
Gets the integer value of iMtmData2
IMPORT_C TInt32 | MtmData3 | ( | ) | const |
Gets the integer value of iMtmData3
TBool | MultipleRecipients | ( | ) | const [inline] |
Gets the value of the multiple recipients flag.
TBool | New | ( | ) | const [inline] |
Gets the value of the new message flag.
TBool | Operation | ( | ) | const [inline] |
Gets the value of the disconnected operation queued flag.
TBool | Owner | ( | ) | const [inline] |
Gets the value of the owner flag.
TMsvId | Parent | ( | ) | const [inline] |
Gets the value of the parent ID.
TInt | PcSyncCount | ( | ) | const [inline] |
Gets the value of the PC synchronisation field.
IMPORT_C TBool | PendingConditions | ( | ) | const |
Gets the pending conditions flag.
TBool | PendingDelete | ( | ) | const [inline] |
Compares if the flag settings in two index entries are the same. The Connected and Pending Delete flags are not used in the comparison, as they indicate temporary conditions of the entry.
Parameters | |
---|---|
aEntry | Index entry to compare against |
TUint | PersistedFlags | ( | ) | const [protected, inline] |
IMPORT_C TMsvPriority | Priority | ( | ) | const |
Gets the value of the message priority field.
TBool | ReadOnly | ( | ) | const [inline] |
Gets the value of the read-only flag.
TBool | Scheduled | ( | ) | const [inline] |
Gets the scheduled flag.
void | SetAttachment | ( | TBool | aAttachmentFlag | ) | [inline] |
Sets the attachment flag.
Parameters | |
---|---|
aAttachmentFlag | Value for the attachment flag |
void | SetComplete | ( | TBool | aComplete | ) | [inline] |
Sets the message complete flag.
Note that for email download without size limits, the complete flag will only be set to true once all the parts of the message (body text and attachments) have been downloaded.
Parameters | |
---|---|
aComplete | Value for the message complete flag |
void | SetConnected | ( | TBool | aConnected | ) | [inline] |
Sets the remote server connection flag.
Parameters | |
---|---|
aConnected | Value for the remote server connection flag |
void | SetDeleteProtected | ( | TBool | aDeleteProtected | ) | [inline] |
This method sets bit 24 of iMtmData1, if you are using this bit elsewhere don't call this method.
void | SetDeleted | ( | TBool | aDeletedFlag | ) | [protected, inline] |
void | SetFailed | ( | TBool | aFailed | ) | [inline] |
Sets the message send failed flag.
Parameters | |
---|---|
aFailed | Value for the message send failed flag |
void | SetForwarded | ( | TBool | aForwarded | ) | [inline] |
This method sets bit 31 of iMtmData1, if you are using this bit elsewhere don't call this method.
void | SetId | ( | TMsvId | aId | ) | [protected, inline] |
void | SetInPreparation | ( | TBool | aInPreparation | ) | [inline] |
Sets the in-preparation flag.
Parameters | |
---|---|
aInPreparation | Value for the in-preparation flag |
void | SetLocallyDeleted | ( | TBool | aLocallyDeleted | ) | [inline] |
This method sets bit 32 of iMtmData1, if you are using this bit elsewhere don't call this method.
IMPORT_C void | SetMtmData1 | ( | TInt32 | aMtmData | ) |
Sets the value of iMtmData1. This API should only be called by Symbian Software Ltd.
Parameters | |
---|---|
aMtmData | Value of the data to be stored in iMtmData1 |
IMPORT_C void | SetMtmData2 | ( | TInt32 | aMtmData | ) |
Sets the value of iMtmData2. This API should only be called by Symbian Software Ltd.
Parameters | |
---|---|
aMtmData | Value of the data to be stored in iMtmData2 |
IMPORT_C void | SetMtmData3 | ( | TInt32 | aMtmData | ) |
Sets the value of iMtmData3. This API should only be called by Symbian Software Ltd.
Parameters | |
---|---|
aMtmData | Value of the data to be stored in iMtmData3 |
void | SetMultipleRecipients | ( | TBool | aMultipleRecipient | ) | [inline] |
Sets the multiple recipients flag.
Parameters | |
---|---|
aMultipleRecipient | Value for the multiple recipients flag |
void | SetNew | ( | TBool | aNew | ) | [inline] |
Sets the message new flag.
Parameters | |
---|---|
aNew | Value for the message new flag |
void | SetOffPeak | ( | TBool | aOffPeak | ) | [inline] |
Sets the off-peak flag.
Parameters | |
---|---|
aOffPeak | Value for off-peak flag. |
void | SetOperation | ( | TBool | aOperation | ) | [inline] |
Sets the disconnected operation queued flag.
Parameters | |
---|---|
aOperation | Value for the disconnected operation queued flag |
void | SetOwner | ( | TBool | aAttachment | ) | [protected, inline] |
void | SetParent | ( | TMsvId | aId | ) | [protected, inline] |
void | SetPendingDelete | ( | TBool | aPendingDelete | ) | [inline] |
IMPORT_C void | SetPriority | ( | TMsvPriority | aPriority | ) |
Sets the message priority.
Parameters | |
---|---|
aPriority | Value for the message priority |
void | SetReadOnly | ( | TBool | aReadOnly | ) | [inline] |
Sets the read-only flag.
Parameters | |
---|---|
aReadOnly | Value for the read-only flag |
void | SetScheduled | ( | TBool | aScheduled | ) | [inline] |
Sets the scheduled flag.
Parameters | |
---|---|
aScheduled | Value for the scheduled flag. |
void | SetSendingState | ( | TUint | aSendingState | ) | [inline] |
Sets the sending state.
Parameters | |
---|---|
aSendingState | The sending state. This must be a value between 0x00 and KMsvSendStateMax. |
void | SetStandardFolder | ( | TBool | aStanardFolder | ) | [inline] |
void | SetUnread | ( | TBool | aUnread | ) | [inline] |
Sets the message unread flag.
Parameters | |
---|---|
aUnread | Value for the message unread flag |
void | SetVisible | ( | TBool | aVisble | ) | [inline] |
Sets the entry visible flag.
Parameters | |
---|---|
aVisble | Value for the entry visible flag |
void | SetVisibleFolderFlag | ( | TBool | aReadOnly | ) | [inline] |
Sets the flag for the TMsvEntry's visible folder(CMsvCacheVisibleFolder), if the entry is visible while creation.
TBool | StandardFolder | ( | ) | const [inline] |
Gets the value of the standard folder flag.
TUint | TemporaryFlags | ( | ) | const [protected, inline] |
TBool | Unread | ( | ) | const [inline] |
Gets the value of the message unread flag.
TBool | Visible | ( | ) | const [inline] |
Gets the value of the entry visible flag.
Overloaded assignment operator.
This acts similarly to the copy constructor: i.e. it makes a simple copy of entry, so the TPtrC entry description and details members will point to the same descriptor data in the original and new objects.
Parameters | |
---|---|
aEntry | The entry from which to assign |
Overloaded equality operator.
This tests whether the fields of the specified entry are equal to those of this object. The contents, rather than pointer values, of the TPtrC members are compared.
Parameters | |
---|---|
aEntry | The entry with which to compare |