PrintForm.PrintAction Property

Article
09/30/2015

Gets or sets a value indicating whether the output is directed to a printer, to a print preview window, or to a file.

Namespace: Microsoft.VisualBasic.PowerPacks.Printing
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

[BrowsableAttribute(true)]
public PrintAction PrintAction { get; set; }

public:
[BrowsableAttribute(true)]
property PrintAction PrintAction {
    PrintAction get();
    void set(PrintAction value);
}

[<BrowsableAttribute(true)>]
member PrintAction : PrintAction with get, set

<BrowsableAttribute(True)>
Public Property PrintAction As PrintAction

Property Value

Type: System.Drawing.Printing.PrintAction

Returns a PrintAction enumeration.

Remarks

When PrintToPrinter is selected, the output is directed to the system default printer. You can override this behavior and explicitly set the printer and printer properties by using the PrinterSettings property. If no default printer is available, the user is prompted to select a printer.

When PrintToPreview is selected, the form is displayed in a standard Windows Forms PrintPreviewDialog control.

When PrintToFile is selected, an image of the form is saved to an Encapsulated PostScript file (.eps, .ps, or .ai) in the path specified by the PrintFileName property. If no file name is specified, the user is prompted for a file name.

Note

Files are saved in an 8-bit Greyscale PostScript format. 24-bit RGB PostScript is not supported.

Note

The user is not prompted for a path or file name extension. To make sure that the file has a valid path and extension, you can implement your own dialog box. To do this, use a SaveFileDialog component and assign the return value to the PrintFileName property before calling the Print method.

Examples

The following example demonstrates how to set the PrintAction property. This example requires that you have a PrintForm component named PrintForm1 and three RadioButton controls on a form.

If RadioButton1.Checked = True Then
    PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
ElseIf RadioButton2.Checked = True Then
    PrintForm1.PrintAction = Printing.PrintAction.PrintToPreview
Else
    PrintForm1.PrintFileName = _
  My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData _
  & "Form1.eps"
    PrintForm1.PrintAction = Printing.PrintAction.PrintToFile
End If

PrintForm.PrintAction Property

Syntax

Property Value

Remarks

Examples

See Also

Additional resources