OL98: Working with the Message or Body of an Outlook Item

ID: Q183209

The information in this article applies to:

SUMMARY

This article describes how Microsoft Outlook 98 implements the Message or Notes field and answers some common questions regarding its use when customizing Outlook forms.

MORE INFORMATION

This article discusses using fields and controls with Outlook forms and it is important to understand the difference between the two. For more information on the differences between fields and controls, please see the following article in the Microsoft Knowledge Base:

   Article-ID: Q182362
   Title     : OL98: How to Use Fields and Controls with VBScript

Working with the Message or Notes Field

The Message field is most commonly associated with a mail message form and is the main portion or "body" of the message. This is a unique field because it supports text in multiple formats, such as Rich Text Formatting (RTF), HTML, and WordMail. You can also embed objects such as shortcuts or files into the message field.

This field also exists on other Outlook forms. On a Post form, it is called the Message field, but on all other forms, it is referred to as the Notes field. When accessing this field through the Outlook object model, it is always referred to as the Body property of the appropriate item (ContactItem, PostItem, and such).

The following table summarizes the naming conventions:

   Item Type          Field Name    Property Name
   ---------          ----------    -------------
   Mail message       Message       Body
   Post               Message       Body
   Contact            Notes         Body
   Appointment        Notes         Body
   Meeting Request    Notes         Body
   Task               Notes         Body
   Task Request       Notes         Body
   Journal            Notes         Body
   Note*              N/A           Body

   * You cannot customize "Note" items.

NOTE: The remainder of this article will use the term "Message field" to refer to both Message and Notes.

Each Outlook item contains one Message field and it is not possible to add an additional field of the same type as the Message field.

Working with the Message or Notes Control

When designing an Outlook form, you can use the Message control more than once on a form. However, when you insert a second Message control on a form, Outlook displays the following warning:

   This form has more than one Message or Notes control. If more than
   one control is visible at run time, only one control works.

This warning may also appear when you use the form, such as when you switch to a form page that contains a second Message control.

Outlook controls are typically bound to MAPI fields to store the actual data and each Outlook form or item has only one field that supports "rich text". Therefore, when you drag the Message field from the Field Chooser onto the form, it is automatically bound to the appropriate Outlook field. You cannot change this behavior. If there is more than one Message field on a form, they will all display the same data since there is only one field of this type permitted for each Outlook form. If you change data in one of the Message fields it does not automatically replicate to the other Message field unless you refresh the field by saving and reopening the form or setting the Body property via code.

The control used to display the Message field is built into the Outlook program and is not designed for use on non-Outlook forms. However, you can add the control to the Control Toolbox since it is a registered control on the system. Use your right mouse button to click a blank area of the Control Toolbox and from the context-sensitive menu, click Custom Controls. "Outlook DocSite OLE Control" should appear in the list of available controls. This is the control used to display the Message field.

Working with the Body Property with All Types of Message Formats

The Outlook user interface allows you to apply various formatting to mail messages, but when you use the Body property from Microsoft Visual Basic Scripting Edition (VBScript) or Microsoft Visual Basic for Applications automation code, all of the text formatting is lost. This is because the data type of the Body field is text, so it behaves no differently than other types of controls, such as a label or text box.

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft Support professionals can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

   http://www.microsoft.com/support/supportnet/refguide/default.asp

When you use VBScript, you cannot programmatically insert information into the body of an Outlook item without completely replacing the body. The Body property enables you to programmatically create and delete the body text, but it does not enable you to insert or modify information that is within the body.

For example, you may have a mail item with the following text in the Message field:

   -------------------------------
   Thank you for using:

   We appreciate your business.
   -------------------------------

If you want to programmatically insert a product name in between the lines, there is no method or property available that will not completely replace all of the body, as shown in the following examples.

   Item.Body = "This is new text"    This example would completely replace
                                     the existing text with the new text.

   Item.Body = ""                    This example would completely delete
                                     the text.

The following VBScript example enables you to insert text within the Body property of the example in the "Cause" section. It does so by parsing the existing text and re-inserting new body text.

   Sub Item_Open()
   ' Dimension X1, X2 to hold the return of the InStr function.
   Dim X1, X2
   ' Get the location of the first carriage return.
   X1 = Instr(1, Item.Body, Chr(13), 1)
   ' Get the location of the second carriage return.
   X2 = Instr(X1 + 1, Item.Body, Chr(13), 1)
   ' Get the text from the beginning of the body to the second carriage
   ' return.
   TempA = Left(Item.Body, X2)
   ' Get the rest of the text.
   TempB = Mid(Item.Body, X2 + 1, Len(Item.Body))
   ' Create new text.
   NewText = "Gadget Company" + Chr(13)
   ' Insert new Body which includes new text.
   Item.Body = TempA + NewText + TempB
   End Sub

HTMLEditor

If you are using an HTML mail message, you can use the Outlook 98 object model to access the HTML Document Object Model and use that object model to manipulate the embedded HTML. For more information, see the HTMLEditor property in the Microsoft Outlook Visual Basic Reference (Vbaoutl.hlp).

NOTE: For security reasons, you cannot use scripting code from within an HTML-based mail message to access the Outlook 98 object model .

WordEditor

If you are using a WordMail mail message, you can use the WordEditor property to return the Microsoft Word object model and then use the object model to change the embedded Word document object. For more information, see the WordEditor property in the Microsoft Outlook Visual Basic Reference (Vbaoutl.hlp).

REFERENCES

For more information about creating solutions with Microsoft Outlook 98, please see the following articles in the Microsoft Knowledge Base:

   Article-ID: Q180826
   Title     : OL98: Resources for Custom Forms and Programming

   Article-ID: Q182349
   Title     : OL98: Questions About Custom Forms and Outlook Solutions

Additional query words: OutSol OutSol98

Keywords          : kbdta OffVBS OffVBA 
Version           : WINDOWS:
Platform          : WINDOWS
Issue type        : kbhowto

Last Reviewed: May 17, 1999