PrintOut Method [Visio 2003 SDK Documentation]
Prints the contents of the active document and provides various printing options. Returns Nothing.
object.PrintOut(PrintRange, [FromPage], [ToPage], [ScaleCurrentViewToPaper], [PrinterName], [PrintToFile], [OutputFileName], [Copies], [Collate], [ColorAsBlack])
object Required. An expression that returns the Document object to print.
PrintRange Required VisPrintOutRange. The range of document pages to be printed. See Remarks for possible values.
FromPage Optional Long. If PrintRange is visPrintFromTo, the first page in the range to be printed. The default is 1, which indicates the first page of the drawing.
ToPage Optional Long. If PrintRange is visPrintFromTo, the last page in the range to be printed. The default is -1, which indicates the last page of the drawing.
ScaleCurrentViewToPaper Optional Boolean. If PrintRange is visPrintCurrentView, True to scale the part of the drawing that fits in the program window to fit on the current default paper size; False to print on as many printer pages as necessary. The default is False.
PrinterName Optional String. The name of the printer to use. The default is the printer currently selected in Visio.
PrintToFile Optional Boolean. True to send the information for printing to a file on a disk, rather than to the printer; False to print to the printer. The default is False. If you specify True for PrintToFile but do not pass a valid value for OutputFileName, the drawing is sent to the active printer.
OutputFileName Optional String. If PrintToFile is True, the name and path of the .prn file to which to print, enclosed in quotation marks.
Copies Optional Long. The number of copies to be printed. The default is one copy.
Collate Optional Boolean. True to collate copies. False to not collate. The default is False.
ColorAsBlack Optional Boolean. True to print all colors as black to ensure that all shapes are visible in the printed drawing. This is useful if a monochrome printer translates very light colors in a drawing to white rather than a shade of gray. False to print colors normally. The default is False.
Version added
2003
Remarks
Calling the PrintOut method is the equivalent of clicking Print on the File menu, selecting print options in the Print dialog box, and then clicking OK.
Possible values for PrintRange are shown in the following table and declared in VisPrintOutRange in the Visio type library.
| Constant | Value | Description |
|---|---|---|
visPrintAll |
0 |
Prints all foreground pages. |
visPrintCurrentPage |
2 |
Prints the active page. |
visPrintCurrentView |
4 |
Prints the current view area. |
visPrintFromTo |
1 |
Prints pages between the FromPage value and the ToPage value. |
visPrintSelection |
3 |
Prints a selection. |
Example
This Microsoft Visual Basic for Applications (VBA) macro shows how to use the PrintOut method to print two copies of the current page to the active printer.
Public Sub PrintOut_Example()
'Print two copies of the current page to the default printer
ThisDocument.PrintOut visPrintCurrentPage, , , , , , , 2
End Sub
Applies to | Document object
See Also | Print method | PrintTile method