PrintSetPrinterSettings Method (GdPictureImaging)

In This Topic

Sets up the printer settings of the active printer.

As explained in the PrintGetActivePrinter or the PrintSetActivePrinter methods, none of the available printers or their properties are affected using any of the print methods of this class.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Function PrintSetPrinterSettings( _
   ByVal PS As PrinterSettings _
) As GdPictureStatus

public GdPictureStatus PrintSetPrinterSettings( 
   PrinterSettings PS
)

public function PrintSetPrinterSettings( 
    PS: PrinterSettings
): GdPictureStatus;

public function PrintSetPrinterSettings( 
   PS : PrinterSettings
) : GdPictureStatus;

public: GdPictureStatus PrintSetPrinterSettings( 
   PrinterSettings* PS
)

public:
GdPictureStatus PrintSetPrinterSettings( 
   PrinterSettings^ PS
)

Parameters

PS: A System.Drawing.Printing.PrinterSettings object. The newly specified printer settings of the active printer.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.

We strongly recommend always checking this status first.

Remarks

Just to remind you that the active printer is the printer identified by the PrintGetActivePrinter method or set by the PrintSetActivePrinter method and it is dedicated to executing all subsequent print jobs using this class as well as utilizing all by you altered printer settings.

Example

Specifying that files will print to a file.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    PrinterSettings prnSettings = gdpictureImaging.PrintGetPrinterSettings();
    // Set the option to print to a file.
    prnSettings.PrintToFile = true;
    gdpictureImaging.PrintSetPrinterSettings(prnSettings);
}

Reference

GdPictureImaging Class
GdPictureImaging Members