PrintController.OnStartPage-Methode

Artikel
08/20/2007

Beginnt beim Überschreiben in einer abgeleiteten Klasse die Steuersequenz, durch die Zeitpunkt und Art des Druckes einer Dokumentseite bestimmt wird.

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

Syntax

'Declaration
Public Overridable Function OnStartPage ( _
    document As PrintDocument, _
    e As PrintPageEventArgs _
) As Graphics
'Usage
Dim instance As PrintController
Dim document As PrintDocument
Dim e As PrintPageEventArgs
Dim returnValue As Graphics

returnValue = instance.OnStartPage(document, e)

public virtual Graphics OnStartPage (
    PrintDocument document,
    PrintPageEventArgs e
)

public:
virtual Graphics^ OnStartPage (
    PrintDocument^ document, 
    PrintPageEventArgs^ e
)

public Graphics OnStartPage (
    PrintDocument document, 
    PrintPageEventArgs e
)

public function OnStartPage (
    document : PrintDocument, 
    e : PrintPageEventArgs
) : Graphics

Parameter

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

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

Rückgabewert

Eine Instanz von Graphics, die eine Seite eines PrintDocument darstellt.

Hinweise

OnStartPage wird aufgerufen, unmittelbar bevor PrintDocument das PrintPage-Ereignis auslöst.

OnStartPrint erstellt die Instanz der Graphics-Klasse, die an den Drucker gesendet wird. Nach dem Aufruf von OnStartPrint legt die OnStartPage-Methode Graphics auf eine Grafik einer einzelnen Seite fest. Die OnEndPage-Methode löscht das Graphics-Objekt, die OnEndPrint-Methode gibt das Objekt hingegen frei.

Mit der OnStartPage-Methode können Sie festlegen, wie eine Seite in einem Dokument gedruckt wird. Beispielsweise können Sie die Seiteneinstellungen für jede Seite einzeln vornehmen.

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
OnStartPrint
PrintPageEventArgs

Freigeben über