Message

Definition:
Allows you to send and receive messages.

Specialized Features:
The following table lists and describes the properties and methods added by Message. There are no added events.

Properties Use to...

DateReceived Reflect the date the message was received, for mail that was read.

FileCount Reflect the number of files contained by the message.

FileFlags Describe the status of the file or object.

FIleIndex Index into the file array.

FileName Provide a pointer to the filename seen by the recipient.

FilePath Read or set the full path name of the attached file. The file should be closed before this call is made.

FilePosition Read or set an integer describing where the attachment should be placed in the message body.

MessageIdentifier Reflect the string that identifies the message to the mail system. This is needed by the Delete and Read methods.

MessageFlags Reflect the state of the message. Possible flags are UNREAD, SENT, RECIEPT_REQUESTED.

MessageText Read or set body of the message.

MessageThread Identify the conversation thread ID to which this message belongs.

MessageType Identify the type of message. It must be begin with IPM:or IPC:

Originator Read the name of person who sent message, for mail that was read.

OriginatorAddress Reflect the address of Originator, for mail that was read.

Recipient Reflect the name of the recipient at position RecipientIndex in the Recipient array.

RecipientAddress Reflect the address of the recipient at position RecipientIndex in the Recipient array.

RecipientClass Reflect the class of the recipient at position RecipientIndex in the Recipient array.

RecipientCount Reflect the number of recipients for this particular message.

RecipientIndex Reflect the Index into the Recipient array.

Subject Read or set the Subject for the message.

Methods Use to...

AttachFile Add a filename at the specified character position and replace the existing character.

AttachRecipient Add a recipient to the recipient list.

Clear Clear the properties of this message without deleting them from the mail queue.

Delete Delete the current message (which is identified by the MessageIndentifier) from the mail queue and clear the properties.

EditRecipients Display the standard mail dialog to modify the recipient list.

EndSession End the current mail session.

NewSession Create a new mail session, allowing a new user to be logged in.

Read Read the message identified by the MessageIdentifier property. If the MessageIdentifier is empty, then the first message is read.

ReadNext Read the next message in the mail queue. If a mail session has not been established, the user will be asked to establish one.

RemoveFileIndex Remove the file at the position indicated by Index.

RemoveRecipientsIndex Remove the Recipient at position Index in the Recipient list. The indices are zero-based.

ResolveRecipients Ensure all Recipients can be located and find addresses for them.

ResolveRecipientsIndex Ensure that Recipient at position Index in the Recipient list can be located, then find addresses for the Recipient.

Save Save the message.

Send Send the contents of current message to recipients.

Copied Features:
None

this is a top-level object.