PrintOut Method

PrintOut method as it applies to the Application, Document, and Window objects.

Prints all or part of the specified document.

expression.PrintOut(Background, Append, Range, OutputFileName, From, To, Item, Copies, Pages, PageType, PrintToFile, Collate, FileName, ActivePrinterMacGX, ManualDuplexPrint, PrintZoomColumn, PrintZoomRow, PrintZoomPaperWidth, PrintZoomPaperHeight)

expression Required. An expression that returns one of the above objects.

Background   Optional Variant. Set to True to have the macro continue while Microsoft Word prints the document.

Append   Optional Variant. Set to True to append the specified document to the file name specified by the OutputFileName argument. False to overwrite the contents of OutputFileName.

WdPrintOutRange

wdPrintAllDocument

wdPrintCurrentPage

wdPrintFromTo

wdPrintRangeOfPages

wdPrintSelection

OutputFileName   Optional Variant. If PrintToFile is True, this argument specifies the path and file name of the output file.

From   Optional Variant. The starting page number when Range is set to wdPrintFromTo.

To   Optional Variant. The ending page number when Range is set to wdPrintFromTo.

WdPrintOutItem

wdPrintAutoTextEntries

wdPrintComments

wdPrintDocumentContent

wdPrintDocumentWithMarkup

wdPrintEnvelope

wdPrintKeyAssignments

wdPrintMarkup

wdPrintProperties

wdPrintStyles

Copies   Optional Variant. The number of copies to be printed.

Pages   Optional Variant. The page numbers and page ranges to be printed, separated by commas. For example, "2, 6-10" prints page 2 and pages 6 through 10.

WdPrintOutPages

wdPrintAllPages

wdPrintEvenPagesOnly

wdPrintOddPagesOnly

PrintToFile   Optional Variant. True to send printer instructions to a file. Make sure to specify a file name with OutputFileName.

Collate   Optional Variant. When printing multiple copies of a document, True to print all pages of the document before printing the next copy.

FileName   Optional Variant. The path and file name of the document to be printed. If this argument is omitted, Word prints the active document. (Available only with the Application object.)

ActivePrinterMacGX   Optional Variant. This argument is available only in Microsoft Office Macintosh Edition. For additional information about this argument, consult the language reference Help included with Microsoft Office Macintosh Edition.

ManualDuplexPrint   Optional Variant. True to print a two-sided document on a printer without a duplex printing kit. If this argument is True, the PrintBackground and PrintReverse properties are ignored. Use the PrintOddPagesInAscendingOrder and PrintEvenPagesInAscendingOrder properties to control the output during manual duplex printing. This argument may not be available to you, depending on the language support (U.S. English, for example) that you've selected or installed.

PrintZoomColumn   Optional Variant. The number of pages you want Word to fit horizontally on one page. Can be 1, 2, 3, or 4. Use with the PrintZoomRow argument to print multiple pages on a single sheet.

PrintZoomRow   Optional Variant. The number of pages you want Word to fit vertically on one page. Can be 1, 2, or 4. Use with the PrintZoomColumn argument to print multiple pages on a single sheet.

PrintZoomPaperWidth   Optional Variant. The width to which you want Word to scale printed pages, in twips (20 twips = 1 point; 72 points = 1 inch).

PrintZoomPaperHeight   Optional Variant. The height to which you want Word to scale printed pages, in twips (20 twips = 1 point; 72 points = 1 inch).

PrintOut method as it applies to the Envelope object.

Prints an envelope without adding the envelope to the active document.

expression.PrintOut(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. An expression that returns an Envelope object.

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. The name of the AutoText entry that includes a recipient's address.

OmitReturnAddress   Optional Variant. True to omit the return address.

ReturnAddress   Optional Variant. A string that specifies the return address.

ReturnAutoText   Optional Variant. The name of the AutoText entry that includes a return address.

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 (FIM-A) for use in presorting courtesy reply mail. For U.S. mail only.

Size   Optional Variant. A string that specifies the envelope size. The string should match one of the sizes listed on the left side of the Envelope size box in the Envelope Options dialog box (for example, "Size 10").

Height   Optional Variant. The height of the envelope (in points) when the Size argument is set to "Custom size."

Width   Optional Variant. The width of the envelope (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 (in points) between the left edge of the envelope and the recipient's address.

AddressFromTop   Optional Variant. The distance (in points) between the top edge of the envelope and the recipient's address.

ReturnAddressFromLeft   Optional Variant. The distance (in points) between the left edge of the envelope and the return address.

ReturnAddressFromTop   Optional Variant. The distance (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.

WdEnvelopeOrientation

wdLeftPortrait

wdCenterPortrait

wdRightPortrait

wdLeftLandscape

wdCenterLandscape

wdRightLandscape

wdLeftClockwise

wdCenterClockwise

wdRightClockwise

PrintEPostage   Optional Variant. True to print postage using an Internet e-postage vendor.

Vertical   Optional Variant. True prints text vertically on the envelope. Used for Asian-language envelopes.

RecipientNamefromLeft   Optional Variant. The position of the recipient's name, measured in points, from the left edge of the envelope. Used for Asian-language envelopes.

RecipientNamefromTop   Optional Variant. The position of the recipient's name, measured in points, from the top edge of the envelope. Used for Asian-language envelopes.

RecipientPostalfromLeft   Optional Variant. The position of the recipient's postal code, measured in points, from the left edge of the envelope. Used for Asian-language envelopes.

RecipientPostalfromTop   Optional Variant. The position of the recipient's postal code, measured in points, from the top edge of the envelope. Used for Asian-language envelopes.

SenderNamefromLeft   Optional Variant. The position of the sender's name, measured in points, from the left edge of the envelope. Used for Asian-language envelopes.

SenderNamefromTop   Optional Variant. The position of the sender's name, measured in points, from the top edge of the envelope. Used for Asian-language envelopes.

SenderPostalfromLeft   Optional Variant. The position of the sender's postal code, measured in points, from the left edge of the envelope. Used for Asian-language envelopes.

SenderPostalfromTop   Optional Variant. The position of the sender's postal code, measured in points, from the top edge of the envelope. Used for Asian-language envelopes.

PrintOut method as it applies to the MailingLabel object.

Prints a label or a page of labels with the same address.

expression.PrintOut(Name, Address, ExtractAddress, LaserTray, SingleLabel, Row, Column, PrintEPostageLabel, Vertical)

expression Required. An expression that returns a MailingLabel object.

Name   Optional Variant. The mailing label name.

Address   Optional Variant. The text for the label address.

ExtractAddress   Optional Variant. True to use the text marked by the "EnvelopeAddress" bookmark (a user-defined bookmark) as the label text. If this argument is specified, Address and AutoText are ignored.

WdPaperTray

wdPrinterAutomaticSheetFeed

wdPrinterDefaultBin

wdPrinterEnvelopeFeed

wdPrinterFormSource

wdPrinterLargeCapacityBin

wdPrinterLargeFormatBin

wdPrinterLowerBin

wdPrinterManualEnvelopeFeed

wdPrinterManualFeed

wdPrinterMiddleBin

wdPrinterOnlyBin

wdPrinterPaperCassette

wdPrinterSmallFormatBin

wdPrinterTractorFeed

wdPrinterUpperBin

SingleLabel   Optional Variant. True to print a single label; False to print an entire page of the same label.

Row   Optional Variant. The label row for a single label. Not valid if SingleLabel is False.

Column   Optional Variant. The label column for a single label. Not valid if SingleLabel is False.

PrintEPostageLabel   Optional Variant. True to print postage using an Internet e-postage vendor.

Vertical   Optional Variant. True prints text vertically on the label. Used for Asian-language mailing labels.

Example

As it applies to the Application, Document, and Window objects.

This example prints the current page of the active document.

ActiveDocument.PrintOut Range:=wdPrintCurrentPage

This example prints all the documents in the current folder. The Dir function is used to return all file names that have the file name extension ".doc".

adoc = Dir("*.DOC")
Do While adoc <> ""
    Application.PrintOut FileName:=adoc
    adoc = Dir()
Loop

This example prints the first three pages of the document in the active window.

ActiveDocument.ActiveWindow.PrintOut _
    Range:=wdPrintFromTo, From:="1", To:="3"

This example prints the comments in the active document.

If ActiveDocument.Comments.Count >= 1 Then
    ActiveDocument.PrintOut Item:=wdPrintComments
End If

This example prints the active document, fitting six pages on each sheet.

ActiveDocument.PrintOut PrintZoomColumn:=3, _
    PrintZoomRow:=2

This example prints the active document at 75% of actual size.

ActiveDocument.PrintOut _
    PrintZoomPaperWidth:=0.75 * (8.5 * 1440), _
    PrintZoomPaperHeight:=0.75 * (11 * 1440)

As it applies to the Envelope object.

This example prints an envelope using the user address as the return address and a predefined recipient address.

recep = "Don Funk" & vbCr & "123 Skye St." & vbCr & _
    "OurTown, WA 98107"
ActiveDocument.Envelope.PrintOut Address:=recep, _
    ReturnAddress:=Application.UserAddress, _
    Size:="Size 10", PrintBarCode:=True

As it applies to the MailingLabel object.

This example prints a page of Avery 5664 mailing labels, using the specified address.

addr = "Jane Doe" & vbCr & "123 Skye St." _
    & vbCr & "OurTown, WA 98107"
Application.MailingLabel.PrintOut Name:="5664", Address:=addr

Applies to | Application Object | Document Object | Envelope Object | MailingLabel Object | Window Object

See Also | ActivePrinter Property | CreateNewDocument Method | Envelope Object | Insert Method | MailingLabel Object | PageSetup Property | PrintEvenPagesInAscendingOrder Property | PrintFractionalWidths Property | PrintOddPagesInAscendingOrder Property | UpdateDocument Method