PrintController.OnStartPrint-Methode

Artikel
08/20/2007

Beginnt beim Überschreiben in einer abgeleiteten Klasse die Steuersequenz, durch die Zeitpunkt und Art eines Dokumentdruckes bestimmt wird.

Namespace: System.Drawing.Printing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Overridable Sub OnStartPrint ( _
    document As PrintDocument, _
    e As PrintEventArgs _
)
'Usage
Dim instance As PrintController
Dim document As PrintDocument
Dim e As PrintEventArgs

instance.OnStartPrint(document, e)

public virtual void OnStartPrint (
    PrintDocument document,
    PrintEventArgs e
)

public:
virtual void OnStartPrint (
    PrintDocument^ document, 
    PrintEventArgs^ e
)

public void OnStartPrint (
    PrintDocument document, 
    PrintEventArgs e
)

public function OnStartPrint (
    document : PrintDocument, 
    e : PrintEventArgs
)

Parameter

document
Ein PrintDocument, das das gegenwärtig gedruckte Dokument darstellt.

e
Eine Instanz von PrintEventArgs, die die Ereignisdaten enthält.

Hinweise

OnStartPrint wird sofort aufgerufen, nachdem PrintDocument das BeginPrint-Ereignis ausgelöst hat.

Mit der OnStartPrint-Methode können Sie Zeitpunkt und Art für das Drucken eines Dokuments festlegen. Sie können das Drucken z. B. um 30 Minuten verzögern oder die Druckereinstellungen für das Dokument anpassen. OnStartPrint erstellt das Graphics-Objekt, das an den Drucker gesendet wird. Nach dem Aufruf von OnStartPrint legt die OnStartPage-Methode eine einzelne Seite als Graphics-Objekt fest. Die OnEndPage-Methode löscht das Graphics-Objekt, die OnEndPrint-Methode gibt das Objekt hingegen frei.

Es empfiehlt sich, mit der OnStartPrint-Methode zu überprüfen, ob das PrinterSettings-Objekt gültig ist.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PrintController-Klasse
PrintController-Member
System.Drawing.Printing-Namespace
OnEndPage
OnEndPrint
OnStartPage
PrinterSettings
PrintEventArgs

Freigeben über