PrintForm.PrintAction Property

Article
10/02/2013

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

'Declaration
<BrowsableAttribute(True)> _
Public Property PrintAction As PrintAction

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

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

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

function get PrintAction () : PrintAction 
function set PrintAction (value : 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

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

Partager via

PrintForm.PrintAction Property

Syntax

Property Value

Remarks

Examples

.NET Framework Security

See Also

Reference

Other Resources

Ressources supplémentaires