Worksheet.PrintOut Method (Microsoft.Office.Tools.Excel)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2005/.NET Framework 2.0

Other versions are also available for the following:

Excel Object Model Reference (Visual Studio Tools for Office)

Worksheet.PrintOut Method

Prints the worksheet.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in microsoft.office.tools.excel.dll)

Syntax

Visual Basic (Declaration)

Public Overridable Sub PrintOut ( _
	<OptionalAttribute> From As Object, _
	<OptionalAttribute> To As Object, _
	<OptionalAttribute> Copies As Object, _
	<OptionalAttribute> Preview As Object, _
	<OptionalAttribute> ActivePrinter As Object, _
	<OptionalAttribute> PrintToFile As Object, _
	<OptionalAttribute> Collate As Object, _
	<OptionalAttribute> PrToFileName As Object _
)

public virtual void PrintOut (
	[OptionalAttribute] Object From,
	[OptionalAttribute] Object To,
	[OptionalAttribute] Object Copies,
	[OptionalAttribute] Object Preview,
	[OptionalAttribute] Object ActivePrinter,
	[OptionalAttribute] Object PrintToFile,
	[OptionalAttribute] Object Collate,
	[OptionalAttribute] Object PrToFileName
)

Parameters

From: The number of the page at which to start printing. If this argument is omitted, printing starts at the beginning.

To: The number of the last page to print. If this argument is omitted, printing ends with the last page.

Copies: The number of copies to print. If this argument is omitted, one copy is printed.

Preview: true to have Microsoft Office Excel invoke print preview before printing the object; false (or omitted) to print the object immediately.

ActivePrinter: Sets the name of the active printer.

PrintToFile: true to print to a file. If PrToFileName is not specified, Excel prompts the user to enter the name of the output file.

Collate: true to collate multiple copies.

PrToFileName: If PrintToFile is set to true, this argument specifies the name of the file you want to print to.

Remarks

"Pages" in the descriptions of From and To refers to printed pages, not to overall pages in the worksheet.

Optional Parameters

For information on optional parameters, see Understanding Optional Parameters in COM Interop.

Example

The following code example uses the PrintOut method to print the current worksheet to a file name specified by the user.

Visual Basic

Private Sub PrintToFile()
    ' Make sure the worksheet has some data before printing.
    Me.Range("A1").Value2 = "123"
    Me.PrintOut(1, 2, 1, False, PrintToFile:=True)
End Sub

private void PrintToFile()
{
    // Make sure the worksheet has some data before printing.
    this.Range["A1", missing].Value2 = "123";
    this.PrintOut(1, 2, 1, false, missing, true, false, missing);
}

Reference

Worksheet Class
Worksheet Members
Microsoft.Office.Tools.Excel Namespace

Site Feedback