PrintForm.PrintAction, propriété

Article
09/04/2008

Mise à jour : novembre 2007

Obtient ou définit une valeur qui indique si la sortie est dirigée vers une imprimante, 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

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

Dim instance As PrintForm
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

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

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

public function get PrintAction () : PrintAction
public function set PrintAction (value : PrintAction)

Valeur de propriété

Type : System.Drawing.Printing.PrintAction

Retourne une énumération PrintAction.

Notes

Lorsque PrintToPrinter est sélectionné, la sortie est dirigée vers l'imprimante système par défaut. Vous pouvez substituer ce comportement et définir explicitement l'imprimante et ses propriétés en utilisant la propriété 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 PrintPreviewDialog Windows Forms standard.

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

Remarque :
Les fichiers sont enregistrés sous un format PostScript niveaux de gris 8 bits. Le format PostScript RVB 24 bits n'est pas pris en charge.

Remarque :
L'utilisateur n'est pas invité à entrer un chemin d'accès ou une extension de nom de fichier. Pour vous assurer que le fichier a 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 SaveFileDialog et assignez la valeur de retour à la propriété PrintFileName avant d'appeler la méthode Print.

Exemples

L'exemple suivant montre comment définir la propriété PrintAction. Cet exemple requiert que vous disposiez d'un composant PrintForm nommé PrintForm1 et de trois contrôles 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

Autorisations

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.