PrintForm.Print, méthode (Form, PrintForm.PrintOption)

Article
11/15/2012

Envoie une image de Windows Form à la destination spécifiée par la propriété d'PrintAction, spécifiant le formulaire et imprimant des options

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

Syntaxe

'Déclaration
Public Sub Print ( _
    form As Form, _
    printOption As PrintForm.PrintOption _
)

public void Print(
    Form form,
    PrintForm.PrintOption printOption
)

public:
void Print(
    Form^ form, 
    PrintForm::PrintOption printOption
)

member Print : 
        form:Form * 
        printOption:PrintForm.PrintOption -> unit

public function Print(
    form : Form, 
    printOption : PrintForm..::..PrintOption
)

Paramètres

form
Type : System.Windows.Forms.Form

printOption
Type : Microsoft.VisualBasic.PowerPacks.Printing.PrintForm.PrintOption

Notes

La méthode d'Print imprime tous les objets visibles sur un formulaire.Cela comprend tous texte ou des graphiques dessinés avec des méthodes d'Graphics.

Si le formulaire spécifié dans le paramètre d'printForm n'a pas le focus, et le paramètre d'PrintOption est défini à CompatibleModeClientAreaOnly ou à CompatibleModeFullWindow, une exception est déclenchée.Si PrintOption est défini à ClientAreaOnly, à FullWindow, ou à Scrollable, tout formulaire dans votre application peut être spécifié, même s'il n'a pas le focus.

[!REMARQUE]

Lorsque le paramètre d'PrintOption est défini à CompatibleModeClientAreaOnly ou à CompatibleModeFullWindow, le formulaire spécifié par la propriété d'Form doit avoir le focus.S'il n'est pas, une exception est déclenchée.Pour éviter cela, appelez la méthode d'Focus de formulaire avant que vous appeliez Print.

Par défaut, seule la zone client du formulaire est imprimée.Si vous souhaitez inclure la barre de titre, les barres de défilement, et la bordure dans l'image imprimée, définissez le paramètre d'PrintOption à CompatibleModeFullWindow ou à FullWindow.

Par défaut, seule la partie actuellement visible de la zone client ou le formulaire est imprimée.Si un utilisateur a redimensionné le formulaire pendant l'exécution, il sera imprimé comme actuellement visible sur l'écran.Si, toutefois, une partie du formulaire a été fermée le bord de l'écran, le formulaire sera encore imprimé comme s'il était complètement visible.

Si vous souhaitez imprimer le formulaire à sa taille conçue, définissez le paramètre d'PrintOption à Scrollable.

La méthode d'Print utilise une de deux implémentations sous-jacentes pour imprimer.L'implémentation est déterminée par le paramètre d'PrintOption.Lorsque ce paramètre est défini à CompatibleModeClientAreaOnly ou à CompatibleModeFullWindow, une implémentation qui est ascendante - compatible avec la méthode de Visual Basic 6.0 PrintForm est utilisée.Lorsque ce paramètre est défini à ClientAreaOnly, à FullWindow ou à Scrollable, une implémentation différente qui ne requiert pas du formulaire pour avoir le focus est utilisée.

[!REMARQUE]

Sur certains systèmes d'exploitation, le texte ou des graphiques dessinés avec des méthodes d'Graphics peut ne pas s'afficher correctement.En outre, si vous défini le paramètre d'PrintOption à ClientAreaOnly, à FullWindow ou à Scrollable, vous pouvez devoir appeler la méthode d'Refresh de formulaire dès que vous appelez Print.Si vous n'appelez pas cette méthode, les artefacts peuvent s'afficher sur le formulaire.

Exemples

L'exemple suivant imprime le formulaire actuel à l'imprimante par défaut de système, impression uniquement la zone client à sa taille actuellement affichée et utilisation de la méthode non compatible d'impression.Cet exemple requiert que vous avez un composant d'PrintForm nommé PrintForm1 sur un formulaire.

PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print(Me, ClientAreaOnly)
Me.Refresh

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.