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

Article
05/16/2015

Envoie une image d'un Windows Form à la destination spécifiée par la propriété PrintAction, en spécifiant les options de mise en forme et d'impression

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 : Form

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

Notes

Le Print méthode imprime tous les objets visibles sur un formulaire. Cela inclut tout texte ou des graphiques dessinés avec Graphics méthodes.

Si le formulaire spécifié dans le printForm paramètre n'est pas actif et le PrintOption paramètre a la valeur CompatibleModeClientAreaOnly ou CompatibleModeFullWindow, une exception est levée. Si PrintOption est définie sur ClientAreaOnly, FullWindow, ou Scrollable, n'importe quel formulaire de votre application peut être spécifiée, même si elle n'est pas actif.

Notes

Lors de la PrintOption paramètre a la valeur CompatibleModeClientAreaOnly ou CompatibleModeFullWindow, le formulaire spécifié par le Form propriété doit avoir le focus.Si elle n'est pas le cas, une exception est levée.Pour éviter cela, appelez le Focus méthode du formulaire avant d'appeler 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 de l'image imprimée, définissez les PrintOption paramètre soit CompatibleModeFullWindow ou FullWindow.

Par défaut, seule la partie actuellement visible de la zone cliente ou le formulaire est imprimée. Si un utilisateur a redimensionné le formulaire au moment de l'exécution, il est imprimé sur actuellement visibles à l'écran. Si, toutefois, dans le formulaire a été déplacé hors des limites de l'écran, le formulaire est imprimé comme si elle était complètement visible.

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

Le Print méthode utilise l'une des deux implémentations sous-jacent pour l'impression. L'implémentation est déterminée par le PrintOption paramètre. Lorsque ce paramètre a la valeur CompatibleModeClientAreaOnly ou CompatibleModeFullWindow, une implémentation qui est compatible avec Visual Basic 6.0 PrintForm méthode est utilisée. Lorsque ce paramètre a la valeur ClientAreaOnly, FullWindow ou Scrollable, une autre implémentation qui ne nécessite pas le formulaire pour que le focus est utilisée.

Notes

Sur certains systèmes d'exploitation, texte ou des graphiques dessinés avec Graphics méthodes s'affichent pas correctement.En outre, si vous définissez la PrintOption paramètre ClientAreaOnly, FullWindow ou Scrollable, il se peut que vous deviez appeler la Refresh le formulaire immédiatement après l'appel de méthode Print.Si vous n'appelez pas cette méthode, les artefacts peuvent apparaître sur le formulaire.

Exemples

L'exemple suivant imprime l'écran actuel de l'imprimante par défaut, l'impression que la zone cliente à sa taille actuellement affiché et à l'aide de la méthode non compatibles de l'impression. Cet exemple suppose que vous disposez d'un PrintForm composant 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, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.