The Message object represents a single message, item, document, or form in a folder.
| Specified in type library: | CDO.DLL |
| First available in: | CDO Library version 1.0.a |
| Parent objects: | Messages collection |
| Child objects: | Attachments collection Fields collection Recipients collection |
| Default property: | Subject |
Name |
Available since version | Type |
Access |
|---|---|---|---|
| Application | 1.0.a | String | Read-only |
| Attachments | 1.0.a | Attachment object or Attachments collection object | Read-only |
| Categories | 1.2 | String array | Read/write |
| Class | 1.0.a | Long | Read-only |
| Conversation | 1.0.a | (Obsolete. Do not use.) | Read/write |
| ConversationIndex | 1.0.a | String | Read/write |
| ConversationTopic | 1.0.a | String | Read/write |
| DeliveryReceipt | 1.0.a | Boolean | Read/write |
| Encrypted | 1.0.a | Boolean | Read/write |
| Fields | 1.0.a | Field object or Fields collection object | Read-only |
| FolderID | 1.0.a | String | Read-only |
| ID | 1.0.a | String | Read-only |
| Importance | 1.0.a | Long | Read/write |
| MAPIOBJECT | 1.0.a | IUnknown object | Read/write (Note: Not available to Visual Basic applications) |
| Parent | 1.0.a | Messages collection object | Read-only |
| ReadReceipt | 1.0.a | Boolean | Read/write |
| Recipients | 1.0.a | Recipients object or Recipients collection object | Read/write |
| Sender | 1.0.a | AddressEntry object | Read/write |
| Sensitivity | 1.2 | Long | Read/write |
| Sent | 1.0.a | Boolean | Read/write |
| Session | 1.0.a | Session object | Read-only |
| Signed | 1.0.a | Boolean | Read/write |
| Size | 1.0.a | Long | Read-only |
| StoreID | 1.0.a | String | Read-only |
| Subject | 1.0.a | String | Read/write |
| Submitted | 1.0.a | Boolean | Read/write |
| Text | 1.0.a | String | Read/write |
| TimeCreated | 1.2 | Variant (vbDate format) | Read-only |
| TimeExpired | 1.2 | Variant (vbDate format) | Read/write |
| TimeLastModified | 1.2 | Variant (vbDate format) | Read-only |
| TimeReceived | 1.0.a | Variant (vbDate format) | Read/write |
| TimeSent | 1.0.a | Variant (vbDate format) | Read/write |
| Type | 1.0.a | String | Read/write |
| Unread | 1.0.a | Boolean | Read/write |
Name |
Available since version | Parameters |
|---|---|---|
| CopyTo | 1.1 | folderID as String, (optional) storeID as String |
| Delete | 1.0.a | (none) |
| Forward | 1.2 | (none) |
| IsSameAs | 1.1 | objMessage2 as Object |
| MoveTo | 1.1 | folderID as String, (optional) storeID as String |
| Options | 1.0.a | (optional) parentWindow as Long |
| Reply | 1.2 | (none) |
| ReplyAll | 1.2 | (none) |
| Send | 1.0.a | (optional) saveCopy as Boolean, (optional) showDialog as Boolean, (optional) parentWindow as Long |
| Update | 1.0.a | (optional) makePermanent as Boolean, (optional) refreshObject as Boolean |
Microsoft® Visual Basic® programmers can create new Message objects using the Messages collection's Add method.
C/C++ programmers can create new Message objects with the OLE function CoCreateInstance.
A message can be obtained from its parent Messages collection using the collection's Item property. To get to the Messages collection in a folder, use the Folder object's Messages property. If you know a message's unique identifier, you can obtain it directly from the Session object's GetMessage method.
A Message object can be rendered into HTML hypertext using the CDO Rendering ObjectRenderer object. To specify this, set the object renderer's DataSource property to the Message object itself. The individual properties that can be rendered with the RenderProperty method are indicated in the Message object property descriptions.
A Message object can also be rendered as the parent of a Recipients collection, using the ContainerRenderer object. The individual properties that can be rendered with the RenderProperty method are indicated in the Message object property descriptions.