WorksheetBase.PrintOutEx Method

Article
06/14/2013

Prints the worksheet.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
Public Sub PrintOutEx ( _
    from As Object, _
    to As Object, _
    copies As Object, _
    preview As Object, _
    activePrinter As Object, _
    printToFile As Object, _
    collate As Object, _
    prToFileName As Object, _
    ignorePrintAreas As Object _
)

public void PrintOutEx(
    Object from,
    Object to,
    Object copies,
    Object preview,
    Object activePrinter,
    Object printToFile,
    Object collate,
    Object prToFileName,
    Object ignorePrintAreas
)

Parameters

from
Type: System.Object

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

to
Type: System.Object

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

copies
Type: System.Object

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

preview
Type: System.Object

true to have Microsoft Office Excel invoke print preview before printing the object. false to print the object immediately.

activePrinter
Type: System.Object

Sets the name of the active printer.

printToFile
Type: System.Object

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

collate
Type: System.Object

true to collate multiple copies.

prToFileName
Type: System.Object

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

ignorePrintAreas
Type: System.Object

true to ignore print areas and print the entire workbook; otherwise, false.

Remarks

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

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Examples

The following code example uses the PrintOutEx method to print two collated copies of the first two pages of the worksheet to the default printer. To run this code example, your workbook must contain a worksheet named Sheet1 with some data.

This example is for a document-level customization.

Private Sub PrintWorksheet()
    Dim mySheet As Microsoft.Office.Tools.Excel.WorksheetBase = Globals.Sheet1

    mySheet.PrintOutEx( _
        From:=1, _
        To:=2, _
        Copies:=2, _
        Preview:=False, _
        Collate:=True, _
        IgnorePrintAreas:=True)
End Sub

private void PrintWorksheet()
{
    Microsoft.Office.Tools.Excel.Worksheet mySheet = Globals.Sheet1.Base;

    mySheet.PrintOutEx(
        1,
        2,
        2,
        false,

        false,
        true,

        true);
}

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via