# MTEmailMessage

Provides properties to get/set the following portions of an e-mail message: To, From, CC, BCC, Subject, Priority, Message Format (MIME, text), Message Body, Format (HTML, plain), Message Body.

Used as an argument for the Init method of the MTEmail object. The properties of the EmailMessage can be modified at any time, but may be overwritten when the MTEmail object loads a template using the LoadTemplate() method.

Note: The properties prefixed by Message are input properties, that is, they can be written. Those not prefixed by Message are output properties; they are read-only.

## Program ID

EmailMessage.MTEmailMessage.1

## MTEmail Properties

Bcc | Blind Carbon Copy. A copy of the message is sent to the recipient(s), and the recipient's name does not appear to other recipients.
Body | The text of the message.
BodyFormat | The format of the message text.
CC | A copy of the message is sent to the recipient(s).
From | Name of the sender of the e-mail message.
Importance | Corresponds to the normal Microsoft™ Outlook® importance levels.
MailFormat | Format of the mail message.
MessageBcc | Blind Carbon Copy. A copy of the message is sent to the recipient(s), and the recipient's name does not appear to other recipients.
MessageBody | The text of the message.
MessageBodyFormat | The format of the message text.
MessageCC | A copy of the message is sent to the recipient(s).
MessageFrom | Name of the sender of the e-mail message.
MessageImportance | Corresponds to the normal Microsoft™ Outlook® importance levels.
MessageMailFormat | Format of the mail message.
MessageSubject | The topic of the message.
MessageTo | Names of the recipient(s) of the message.
Subject | The topic of the message.
To | Names of the recipient(s) of the message.

## Example

Example to be provided in a future release of this online help system.

# Property Detail

## Bcc

Blind Carbon Copy. A copy of the message is sent to the recipient(s), and the recipient's name does not appear to other recipients.

This is a read-only property.

### Visual Basic Syntax

Property Bcc As String

### C++ Syntax

HRESULT Bcc([out, retval] BSTR newVal);

### Return Value

newVal

A string containing the names in the Bcc list.

## Body

The text of the message

This is a read-only property.

### Visual Basic Syntax

Property Body As String

### C++ Syntax

HRESULT Body([out, retval] BSTR newVal);

### Return Value

newVal

A string containing the text of the e-mail message.

## BodyFormat

The format of the message text. 0 for HTML or 1 for plain text.

This is a read-only property.

### Visual Basic Syntax

Property BodyFormat As Long

### C++ Syntax

HRESULT BodyFormat([out, retval] Long newVal);

### Return Value

newVal

0 if the text is HTML, or
1 if the text is ASCII

## CC

A carbon copy of the message is sent to the recipient(s).

This is a read only property.

### Visual Basic Syntax

Property CC As String

### C++ Syntax

HRESULT CC([out, retval] BSTR newVal);

### Arguments

newVal

A string containing the names in the CC list.

## From

Name of the sender of the e-mail message.

This is a read-only property.

### Visual Basic Syntax

Property From As String

### C++ Syntax

HRESULT From([out, retval] BSTR newVal);

### Arguments

newVal

A string containing the name of the sender of the message.

## Importance

Corresponds to the normal Microsoft™ Outlook® importance levels; 0 for Low, 1 for Normal, 2 for High

This is a read-only property.

### Visual Basic Syntax

Property Importance As Long

### C++ Syntax

HRESULT Importance([out, retval] Long newVal);

### Return Value

newVal

0 if the importance level is Low,
1 if the importance level is Normal, or
2 if the importance level is High

## MailFormat

Format of the mail message; 0 for MIME format, 1 for plain text.

This is a read-only property.

### Visual Basic Syntax

Property MailFormat As Long

### C++ Syntax

HRESULT MailFormat([out, retval] Long newVal);

### Return Value

newVal

0 if the message is formatted in MIME, or
1 if the message is formatted as plain text

## MessageBcc

Blind Carbon Copy. A copy of the message is sent to the recipient(s), and the recipient's name does not appear to other recipients.

### Visual Basic Syntax

Property MessageBcc As String

### C++ Syntax

HRESULT MessageBcc([in] BSTR newVal);

### Arguments

newVal

A string containing the names in the Bcc list.

## MessageBody

The text of the message

### Visual Basic Syntax

Property MessageBody As String

### C++ Syntax

HRESULT MessageBody([in] BSTR newVal);

### Arguments

newVal

A string containing the text of the e-mail message.

## MessageBodyFormat

The format of the message text. 0 for HTML or 1 for plain text.

### Visual Basic Syntax

Property MessageBodyFormat As Long

### C++ Syntax

HRESULT MessageBodyFormat([in] long newVal);

### Arguments

newVal

0 if the text is HTML, or
1 if the text is ASCII

## MessageCC

A copy of the message is sent to the recipient(s).

### Visual Basic Syntax

Property MessageCC As String

### C++ Syntax

HRESULT MessageCC([in] BSTR newVal);

### Arguments

newVal

A string containing the names in the CC list.

## MessageFrom

Name of the sender of the e-mail message.

### Visual Basic Syntax

Property MessageFrom As String

### C++ Syntax

HRESULT MessageFrom([in] BSTR newVal);

### Arguments

newVal

A string containing the name of the sender of the message.

## MessageImportance

Corresponds to the normal Microsoft™ Outlook® importance levels; 0 for Low, 1 for Normal, 2 for High

### Visual Basic Syntax

Property MessageImportance As Long

### C++ Syntax

HRESULT MessageImportance([in] long newVal);

### Arguments

newVal

0 if the importance level is Low,
1 if the importance level is Normal, or
2 if the importance level is High.

## MessageMailFormat

Format of the mail message; 0 for MIME format, 1 for plain text.

### Visual Basic Syntax

Property MailFormat As Long

### C++ Syntax

HRESULT MailFormat([in] long newVal);

### Arguments

newVal

0 if the message is formatted in MIME, or
1 if the message is formatted as plain text.

## MessageSubject

The topic of the message.

### Visual Basic Syntax

Property Subject As String

### C++ Syntax

HRESULT Subject([in] BSTR newVal);

### Arguments

newVal

A string containing the subject of the message.

## MessageTo

Names of the recipient(s) of the message.

### Visual Basic Syntax

Property MessageTo As String

### C++ Syntax

HRESULT MessageTo([in] BSTR newVal);

### Arguments

newVal

A string containing the name(s) of the message recipient(s).

## Subject

The topic of the message.

This is a read-only property.

### Visual Basic Syntax

Property Subject As String

### C++ Syntax

HRESULT Subject([out, retval] BSTR newVal);

### Return Value

newVal

A string containing the subject of the message.

## To

Name(s) of the recipient(s) of the message.

This is a read-only property.

### Visual Basic Syntax

Property To As String

### C++ Syntax

HRESULT To([out, retval] BSTR newVal);

### Return Value

newVal

A string containing the name(s) of the message recipient(s).

###