MessageItem object

 

This object is obsolete. Use RDOMail object instead.

 

Returned by:

MAPIUtils.GetItemFromID,

MAPIUtils.GetMessageFromMsgFile

Attachment.EmbeddedMsg

 

Properties

Methods

 


Derived from: IDispatch


Properties


Application Returns Outlook.Application object
 
Attachments Returns Attachments collection representing the message attachments.
 
BCC

Returns a String representing the display list of blind carbon copy (BCC) names for a message. This property contains the display names only. The Recipients collection should be used to modify the BCC recipients. Read/write.

 

 
Body

Returns or sets a String representing the clear-text body of the message. Read/write.

 

 
BodyFormat

Returns or sets an OlBodyFormat constant indicating the format of the body text. The body text format determines the standard used to display the text of the message. Microsoft Outlook provides three body text format options: Plain Text, Rich Text (RTF), and HTML. Read/write.

 
CC

Returns a String representing the display list of carbon copy (CC) names for a message. This property contains the display names only. The Recipients collection should be used to modify the CC recipients. Read/write.

 

 
Class: Always returns 43 (olMailItem).
 
CreationTime

Returns a Date indicating the creation time for the message. This property corresponds to the MAPI property PR_CREATION_TIME. Read-only.

 

 
DeferredDeliveryTime

Returns or sets a Date indicating the date and time the mail message is to be delivered. This property corresponds to the MAPI property PR_DEFERRED_DELIVERY_TIME. Read/write

 

 
DeleteAfterSubmit

True if a copy of the mail message is not saved upon being sent. False if a copy is saved. Read/write Boolean.

 

 
EntryID Returns a hex String representing the unique entry ID of the object. This property corresponds to the MAPI property PR_ENTRYID. Read-only.
 
Fields[PropTag]

Returns or sets an Extended MAPI property

PropTag -  integer Extended MAPI property tag (e.g. 0x0037001E for PR_SUBJECT_A)

Note that RDO family of objects also supports accessing MAPI properties by a DASL property name.

 

You can use one of the MAPITags enumeration elements, e.g. MAPITags.PR_SUBJECT.

Scalar properties are returned as variants of the corresponding type (e.g. PT_STRING8 and PT_UNICODE properties are returned as strings, PT_LONG as integers, etc).

For the object properties (PT_OBJECT, such as PR_CONTAINER_CONTENTS, PR_ACL_TABLE, etc) Redemption tries to open them as IMAPITable Extended MAPI object and, if successful, returns an instance of the Redemption.MAPITable object

 

 
HTMLBody

Returns or sets a String representing the HTML body of the specified item. The HTMLBody property should be an HTML syntax string. Read/write.

 

 
Importance

Returns or sets an OlImportance constant indicating the relative importance level for the message. This property corresponds to the MAPI property PR_IMPORTANCE. Read/write.

 
LastModificationTime

Returns a Date specifying the date and time that the message was last modified. This property corresponds to the MAPI property PR_LAST_MODIFICATION_TIME. Read-only.

 

 
MAPIOBJECT

IUnknown, read-only.

Returns the Extended MAPI object used internally by the object (IMessage)

 

 
MessageClass

Returns or sets a String representing the message class for the Microsoft Outlook item or Action. This property corresponds to the MAPI property PR_MESSAGE_CLASS. Read-write.

 

 
Parent

Message parent. Read-only.

 

 
ReceivedTime

Returns or sets a Date indicating the date and time at which the mail message, meeting item, or post was received. Read-write.

 

 
Recipients

Returns an Recipients collection that represents all the recipients for the message. Read-write.

 

 
ReplyRecipients

Returns or sets an Recipients collection that represents all the reply recipient objects for the mail message.

 

 
RTFBody

Returns or sets a String representing the RTF body of the specified item. The RTFBody property should be an RTF syntax string. Read/write.

 

 
Sender

Returns or sets an AddressEntry object representing the message sender.

Read/write.

 

 
SenderName

Returns or sets a String indicating the display name of the sender for the e-mail message, meeting item, or post. This property corresponds to the MAPI property PR_SENDER_NAME. Read-write

 

 
Sent

Returns or sets a Boolean value that indicates if a message has been sent. True if sent, False if not sent. Read-write. Corresponds to the MSGFLAG_UNSENT bit in the PR_MESSAGE_FLAGS MAPI property.

.Note that most MAPI providers allow to set this property before the message is saved for the very first time.

 

 
SentOn

Returns or sets a Date indicating the date and time on which the mail message, meeting item, or post was sent. This property corresponds to the MAPI property PR_CLIENT_SUBMIT_TIME. Read-write.

 

 
Session Returns Outlook.Namespace object.
 
Size

Returns a Long indicating the size (in bytes) of the message. Read-only.

 

 
Subject

Returns or sets a String indicating the subject for the message. This property corresponds to the MAPI property PR_SUBJECT. Read/write.

 

 
Submitted

Returns a Boolean value that indicates if the item has been submitted. True if the item has been submitted. Read-only.

 

 
To

Returns or sets a semicolon-delimited String list of display names for the To recipients for the message. This property contains the display names only. The Recipients collection should be used to modify the TO recipients. Read/write.

 

 
UnRead

True if the message has not been opened (read). Read/write Boolean.

 

 
Version String, Read-only. Returns Redemption library version, e.g. "5.2.0.2486"
 

Methods


GetIDsFromNames(GUID, ID)

Returns an id suitable for use in the Fields() collection given the GUID (as string) and ID (can be either integer or a string).

For the discussion of the named properties, see the Extended
MAPI properties
section, especially the section on named properties.

 

 
CopyTo(DestObj)

Copies the object to the target object.

 

 
Delete
Deletes the message.
 

Import(Path, Type)

 

Imports the contents of an external file into the message.

Path - string. Fully qualified path to the file to be imported.

Type - optional. One of rdoSaveAsType enum values. If the type is not specified, the MSG format (MSG) is used.

 

 
Save
Saves the message.
 

SaveAs(Path, Type)

Saves the message to the specified path and in the format of the specified file type.

Path - string. Fully qualified path.

Type - optional. One of rdoSaveAsType enum values. If the file type is not specified, the MSG format (.msg) is used.

Supported formats:

olMSG (3)

olMsgUnicode (9)

olRTF (1)

olTemplate (2)

olTxt (0)

olVCard (6)

olRFC822 (1024)

olTNEF (1025)

olHTML (5)

olRTFNoHeaders (1026)

olMHTML (1027)

olVCal (7)

olICal (8)

 

 
Send
Sends the message