PrintForm.Print-Methode (Form, PrintForm.PrintOption)

Sendet ein Bild auf einer Windows Form, das von der PrintAction-Eigenschaft angegeben wird, und gibt das Formular und die Druckoptionen an

Namespace: Microsoft.VisualBasic.PowerPacks.Printing
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
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
)

Parameter

form
Typ: System.Windows.Forms.Form

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

Hinweise

Die Print-Methode druckt alle sichtbaren Objekte in einem Formular.Dies schließt alle Text oder Grafiken, die mit Graphics-Methode gezeichnet werden.

Wenn das Formular, das im printForm-Parameter angegeben ist, nicht den Fokus besitzt, und der PrintOption-Parameter auf CompatibleModeClientAreaOnly oder CompatibleModeFullWindowfestgelegt wird, wird eine Ausnahme ausgelöst.Wenn PrintOption zu ClientAreaOnly, FullWindowoder Scrollablefestgelegt ist, wird ein Formular in der Anwendung angegeben werden, auch wenn es keinen Fokus besitzt.

Hinweis
Wenn der PrintOption-Parameter auf CompatibleModeClientAreaOnly oder CompatibleModeFullWindowfestgelegt wird, muss das Formular, das von der Form-Eigenschaft angegebene Fokus besitzt.Wenn dies nicht der Fall ist, wird eine Ausnahme ausgelöst.Um dies zu vermeiden, rufen Sie die Focus-Methode des Formulars auf, bevor Sie Printaufrufen.

Standardmäßig wird nur der Clientbereich des Formulars gedruckt wird.Wenn Sie auf die Titelleiste, die Schiebeleisten und den Rahmen im gedruckten Bild aufgenommen werden sollen, legen Sie den PrintOption-Parameter auf CompatibleModeFullWindow oder FullWindowfest.

Standardmäßig wird nur der aktuell sichtbaren Teil des Clientbereichs oder das Formular gedruckt wird.Wenn ein Benutzer das Formular zur Laufzeit die Größe geändert wurde, wird es gedruckt, z. B. nur auf dem Bildschirm sichtbar.Wenn jedoch der Teil des Formulars außerhalb des Bildschirmrand verschoben wurde, wird das Formular noch gedruckt, als wäre er vollständig sichtbar war.

Wenn Sie das Formular an seine Größe entworfenen drucken möchten, legen Sie den PrintOption-Parameter in Scrollablefest.

Die Print-Methode verwendet eine von zwei zugrunde liegende Implementierungen für das Drucken.Die Implementierung wird vom PrintOption-Parameter bestimmt.Wenn dieser Parameter auf CompatibleModeClientAreaOnly oder CompatibleModeFullWindowfestgelegt wird, wird eine Implementierung der Methode in Visual Basic 6.0 PrintForm abwärts kompatibel ist, verwendet.Wenn dieser Parameter auf ClientAreaOnly, FullWindow oder Scrollablefestgelegt wird, wird eine andere Implementierung, die nicht das Formular benötigt, den Fokus besitzen, verwendet.

Hinweis
Auf einigen Betriebssystemen wird der Text oder Grafiken, die Graphics-Methode gezeichnet werden, nicht ordnungsgemäß angezeigt.Wenn Sie legen das PrintOption-Parameter in ClientAreaOnly, FullWindow oder Scrollable, die Refresh-Methode des Formulars aufrufen müssen, unmittelbar nach dem Printaufrufen.Wenn Sie diese Methode nicht aufrufen, werden möglicherweise Artefakte im Formular.

Beispiele

Im folgenden Beispiel werden das aktuelle Formular an den Systemstandarddrucker, gibt nur den Clientbereich an der aktuell angezeigten Größe und wendet die nichtkompatibele Methode das Drucken an.Dieses Beispiel setzt voraus, dass Sie eine PrintForm Komponente verfügen, die in einem Formular PrintForm1.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.