MailEnvelopeObject interface

Office 2013 and later

Represents a custom e-mail message in an InfoPath form.

Namespace:  Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly:  Microsoft.Office.Interop.InfoPath.SemiTrust (in Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

<GuidAttribute("096cd588-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface MailEnvelopeObject _
	Inherits MailEnvelope
Dim instance As MailEnvelopeObject

This type is a wrapper for a coclass that is required by managed code for COM interoperability. Use this type to access the members of the COM interface implemented by this coclass. For information about the COM interface, including a link to descriptions of its members, seeMailEnvelope.

Using the members of the MailEnvelope interface provides compatibility with InfoPath 2003. To use new members that were added to the MailEnvelope2 object model in InfoPath 2010, you must cast the object returned by the MailEnvelope property of the WindowObject to the MailEnvelope2 type. For more information, see How to: Use Microsoft.Office.Interop.InfoPath.SemiTrust Members That Are Not Compatible with InfoPath 2003.

The MailEnvelope object provides a number of properties that can be used to programmatically create a custom e-mail message within the default e-mail editor, and it attaches the currently open InfoPath form to the message.

After the e-mail message is created, the default e-mail editor will display the e-mail message; users can then inspect and edit the e-mail message before sending it.


The MailEnvelope object cannot be used to send the e-mail messages it creates; users must manually send the e-mail messages.

You can also use the ShowMailItem method to programmatically create e-mail messages; users must manually send the e-mail messages.

You can also use the ShowMailItem method of the UIObject object to programmatically create e-mail messages.

In the following example, the MailEnvelope property of the WindowObject object is used to set a reference to the MailEnvelope object.

MailEnvelopeObject myEnv = thisApplication.ActiveWindow.MailEnvelope;
myEnv.Visible = true;