NamedRange.PrintOutEx Method

Prints the object.

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

Syntax

'Declaration
Function 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 _
) As Object

Object PrintOutEx(
    Object From,
    Object To,
    Object Copies,
    Object Preview,
    Object ActivePrinter,
    Object PrintToFile,
    Object Collate,
    Object PrToFileName
)

Parameters

• From
  Type: System.Object

  The number of the first page to start printing. By default, printing starts at the beginning.

• To
  Type: System.Object

  The number of the last page to print. By default, printing ends at the last page.

• Copies
  Type: System.Object

  The number of copies to print. By default, one copy is printed.

• Preview
  Type: System.Object

  true to have Excel invoke print preview before printing the object. false (or omitted) 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.

Return Value

Type: System.Object
An Object that represents a NamedRange object.

Examples

The following code example uses the PrintOutEx method to print one copy of the first two pages of the named range NamedRange1 to the default printer. To run this code example, your workbook must contain a worksheet named Sheet1 with a named range named NamedRange1 that covers a range of cells that contain some data.

This example is for a document-level customization.

Private Sub PrintNamedRange()
    Dim myNamedRange As Microsoft.Office.Tools.Excel.NamedRange = _
        Globals.Sheet1.NamedRange1

    myNamedRange.PrintOutEx( _
        From:=1, _
        To:=2, _
        Copies:=1, _
        Preview:=False)            
End Sub

private void PrintNamedRange()
{
    Microsoft.Office.Tools.Excel.NamedRange myNamedRange =
        Globals.Sheet1.namedRange1;

    myNamedRange.PrintOutEx(
        1,
        2,
        1,
        false,

        false,
        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.

See Also

Reference

NamedRange Interface

Microsoft.Office.Tools.Excel Namespace