StandardPrintController.OnStartPage-Methode

Beginnt die Steuersequenz, durch die bestimmt wird, wann und wie eine Seite eines Dokuments gedruckt wird.

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

Syntax

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

returnValue = instance.OnStartPage(document, e)

public override Graphics OnStartPage (
    PrintDocument document,
    PrintPageEventArgs e
)

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

public Graphics OnStartPage (
    PrintDocument document, 
    PrintPageEventArgs e
)

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

Parameter

• document
  Ein PrintDocument, das das Dokument darstellt, das gedruckt wird.

• e
  Ein PrintPageEventArgs, das Daten darüber enthält, wie eine Seite des Dokuments gedruckt wird. Anfangs ist die PrintPageEventArgs.Graphics-Eigenschaft dieses Parameters NULL (Nothing in Visual Basic). Der von der OnStartPage-Methode zurückgegebene Wert wird zum Festlegen dieser Eigenschaft verwendet.

Rückgabewert

Ein Graphics-Objekt, das eine Seite eines PrintDocument darstellt.

Ausnahmen

Hinweise

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

OnStartPrint erstellt das beim Drucken verwendete Graphics-Objekt. Nach dem Aufruf von OnStartPrint legt die OnStartPage-Methode eine Grafik einer einzelnen Seite als Graphics-Objekt fest. Die OnEndPage-Methode löscht das Graphics-Objekt, die OnEndPrint-Methode gibt das Objekt hingegen frei.

.NET Framework-Sicherheit

• PrintingPermission  für die Steuerung des Druckerzugriffs. Zugehörige Enumeration: PrintingPermissionLevel.

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

StandardPrintController-Klasse
StandardPrintController-Member
System.Drawing.Printing-Namespace
OnEndPage
OnEndPrint
OnStartPrint
PrintPageEventArgs-Klasse