Edit

Envelope.Insert method (Word)

  • Article

Inserts an envelope as a separate section at the beginning of the specified document.

Syntax

expression.Insert (ExtractAddress, Address, AutoText, OmitReturnAddress, ReturnAddress, ReturnAutoText, PrintBarCode, PrintFIMA, Size, Height, Width, FeedSource, AddressFromLeft, AddressFromTop, ReturnAddressFromLeft, ReturnAddressFromTop, DefaultFaceUp, DefaultOrientation, PrintEPostage, Vertical, RecipientNamefromLeft, RecipientNamefromTop, RecipientPostalfromLeft, RecipientPostalfromTop, SenderNamefromLeft, SenderNamefromTop, SenderPostalfromLeft, SenderPostalfromTop)

expression Required. A variable that represents an Envelope object.

Parameters

Name Required/Optional Data type Description
ExtractAddress Optional Variant True to use the text marked by the EnvelopeAddress bookmark (a user-defined bookmark) as the recipient's address.
Address Optional Variant A string that specifies the recipient's address (ignored if ExtractAddress is True).
AutoText Optional Variant A string that specifies an AutoText entry to use for the address. If specified, Address is ignored.
OmitReturnAddress Optional Variant True to not insert a return address.
ReturnAddress Optional Variant A string that specifies the return address.
ReturnAutoText Optional Variant A string that specifies an AutoText entry to use for the return address. If specified, ReturnAddress is ignored.
PrintBarCode Optional Variant True to add a POSTNET bar code. For U.S. mail only.
PrintFIMA Optional Variant True to add a Facing Identification Mark (FIMA) for use in presorting courtesy reply mail. For U.S. mail only.
Size Optional Variant A string that specifies the envelope size. The string must match one of the sizes listed in the Envelope size box in the Envelope Options dialog box (for example, "Size 10" or "C4").
Height Optional Variant The height of the envelope, measured in points, when the Size argument is set to "Custom size."
Width Optional Variant The width of the envelope, measured in points, when the Size argument is set to "Custom size."
FeedSource Optional Variant True to use the FeedSource property of the Envelope object to specify which paper tray to use when printing the envelope.
AddressFromLeft Optional Variant The distance, measured in points, between the left edge of the envelope and the recipient's address.
AddressFromTop Optional Variant The distance, measured in points, between the top edge of the envelope and the recipient's address.
ReturnAddressFromLeft Optional Variant The distance, measured in points, between the left edge of the envelope and the return address.
ReturnAddressFromTop Optional Variant The distance, measured in points, between the top edge of the envelope and the return address.
DefaultFaceUp Optional Variant True to print the envelope face up, False to print it face down.
DefaultOrientation Optional Variant The orientation for the envelope. Can be any WdEnvelopeOrientation constant.
PrintEPostage Optional Variant True to insert postage from an Internet postage vendor.
Vertical Optional Variant True to print vertical text on the envelope. Used for Asian envelopes. Default is False.
RecipientNamefromLeft Optional Variant Position of the recipient's name, measured in points from the left edge of the envelope. Used for Asian envelopes.
RecipientNamefromTop Optional Variant Position of the recipient's name, measured in points from the top edge of the envelope. Used for Asian envelopes.
RecipientPostalfromLeft Optional Variant Position of the recipient's postal code, measured in points from the left edge of the envelope. Used for Asian envelopes.
RecipientPostalfromTop Optional Variant Position of the recipient's postal code, measured in points from the top edge of the envelope. Used for Asian envelopes.
SenderNamefromLeft Optional Variant Position of the sender's name, measured in points from the left edge of the envelope. Used for Asian envelopes.
SenderNamefromTop Optional Variant Position of the sender's name, measured in points from the top edge of the envelope. Used for Asian envelopes.
SenderPostalfromLeft Optional Variant Position of the sender's postal code, measured in points from the left edge of the envelope. Used for Asian envelopes.
SenderPostalfromTop Optional Variant Position of the sender's postal code, measured in points from the top edge of the envelope. Used for Asian envelopes.

Example

This example adds a Size 10 envelope to the active document by using the addresses stored in the strAddr and strReturnAddr variables.

Sub InsertEnvelope() 
 Dim strAddr As String 
 Dim strReturnAddr As String 
 strAddr = "Max Benson" & vbCr & "123 Skye St." _ 
 & vbCr & "OurTown, WA 98107" 
 strReturnAddr = "Paul Borm" & vbCr & "456 Erde Lane" _ 
 & vbCr & "OurTown, WA 98107" 
 ActiveDocument.Envelope.Insert Address:=strAddr, _ 
 ReturnAddress:=strReturnAddr, Size:="Size 10" 
End Sub

See also

Envelope Object

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.