PrintForm.PrintAction, propriété

Article
11/15/2012

Obtient ou définit une valeur indiquant si la sortie est dirigée à une imprimante, dans une fenêtre d'aperçu avant impression, ou à un fichier.

Espace de noms : Microsoft.VisualBasic.PowerPacks.Printing
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
<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)

Valeur de propriété

Type : System.Drawing.Printing.PrintAction
Retourne une énumération d'PrintAction.

Notes

Lorsque PrintToPrinter est sélectionné, la sortie est dirigée vers l'imprimante par défaut de système.Vous pouvez substituer ce comportement et définir explicitement l'imprimante et les propriétés d'imprimante à l'aide de la propriété d'PrinterSettings.Si aucune imprimante par défaut n'est disponible, l'utilisateur est invité à sélectionner une imprimante.

Lorsque PrintToPreview est sélectionné, le formulaire est affiché dans un contrôle de Windows Forms PrintPreviewDialog de standard.

Lorsque PrintToFile est sélectionné, une image du formulaire est enregistrée à un fichier PostScript encapsulé (.eps, .ps, ou .ai) dans le chemin d'accès spécifié par la propriété d'PrintFileName.Si aucun nom de fichier n'est spécifié, l'utilisateur est invité pour un nom de fichier.

[!REMARQUE]

Des fichiers sont enregistrés dans un format à arrière-plan gris de 8 bits de PostScript.le RVB 24 bits PostScript n'est pas pris en charge.

[!REMARQUE]

L'utilisateur n'est pas invité pour un chemin d'accès ou une extension de nom de fichier.Pour vous assurer que le fichier est un chemin d'accès et une extension valides, vous pouvez implémenter votre propre boîte de dialogue.Pour ce faire, utilisez un composant d'SaveFileDialog et assignez la valeur de retour à la propriété d'PrintFileName avant d'appeler la méthode d'Print.

Exemples

L'exemple suivant montre comment définir la propriété PrintAction.Cet exemple requiert que vous avez un composant d'PrintForm nommé PrintForm1 et trois contrôles d'RadioButton sur un formulaire.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.