|
|
Create a new message part in a multipart message.
Syntax
object.CreatePart( [MessageText],
[CharacterSet], [EncodingType] )
Remarks
The CreatePart method creates a new message part. If the
current message is a simple RFC822 formatted message, then this
method converts it to a MIME multipart message. The current message
part will be set to the new part that was just created.
- MessageText
- An optional string argument which specifies the body of the new
message part. Each line of text contained in the string should be
terminated with a carriage-return/linefeed (CRLF) pair, which is
recognized as the end-of-line. If the argument is not specified,
then the message part will have an empty body.
- CharacterSet
- An optional integer value which specifies the character set for
the message part. The default is for the message to be composed
using the standard US-ASCII character set. One of the following
values may be used:
-
| Value |
Constant |
Description |
| 1 |
mimeCharsetUSASCII |
The default character set using
US-ASCII which defines 7-bit printable characters with values
ranging from 20h to 7Eh. |
| 2 |
mimeCharsetISO8859_1 |
An 8-bit character set for most
western European languages such as English, French, Spanish and
German. This character set is also commonly referred to as
Latin1. |
| 3 |
mimeCharsetISO8859_2 |
An 8-bit character set for most
central and eastern European languages such as Czech, Hungarian,
Polish and Romanian. This character set is also commonly referred
to as Latin2. |
| 4 |
mimeCharsetISO8859_5 |
An 8-bit character set for
Cyrillic languages such as Russian, Bulgarian and Serbian. |
| 5 |
mimeCharsetISO8859_6 |
An 8-bit character set for Arabic
languages. Note that the application is responsible for displaying
text that uses this character set. In particular, any display
engine needs to be able to handle the reverse writing direction and
analyze the context of the message to correctly combine the
glyphs. |
| 6 |
mimeCharsetISO8859_7 |
An 8-bit character set for the
Greek language. |
| 7 |
mimeCharsetISO8859_8 |
An 8-bit character set for the
Hebrew language. Note that similar to Arabic, Hebrew uses a reverse
writing direction. An application which displays this character
should be capable of processing bi-directional text where a single
message may include both right-to-left and left-to-right languages,
such as Hebrew and English. |
| 8 |
mimeCharsetISO8859_9 |
An 8-bit character set for the
Turkish language. This character set is also commonly referred to
as Latin5. |
- EncodingType
- An optional integer value which specifies the content encoding
to use for the message part. The default is for the control to use
7-bit encoding. If an 8-bit character set is specified for the
CharacterSet argument, the default encoding type will be set
to quoted-printable. One of the following values may be used:
| Value |
Constant |
Description |
| 1 |
mimeEncoding7Bit |
Each character is encoded in one
or more bytes, with each byte being 8 bits long, with the first bit
cleared. This encoding is most commonly used with plain text using
the US-ASCII character set, where each character is represented by
a single byte in the range of 20h to 7Eh. Most e-mail messages are
composed using 7-bit ASCII. |
| 2 |
mimeEncoding8Bit |
Each character is encoded in one
or more bytes, with each byte being 8 bits long and all bits are
used. 8-bit encoding may be used with multi-byte character sets,
although this encoding type is uncommon in e-mail messages. It is
recommended that quoted-printable encoding be used for 8-bit
character sets. |
| 4 |
mimeEncodingQuoted |
Quoted-printable encoding is
designed for textual messages where most of the characters are
represented by the ASCII character set and is generally
human-readable. Non-printable characters or 8-bit characters with
the high bit set are encoded as hexadecimal values and represented
as 7-bit text. Quoted-printable encoding is typically used for
messages which use character sets such as ISO-8859-1, as well as
those which use HTML. |
Return Value
A value of zero is returned if the method was successful.
Otherwise, a non-zero error code is returned which indicates the
cause of the failure.
See Also
Bcc Property, Cc Property, Encoding Property, From Property, Subject Property, Text Property, To Property
|
|