Freigeben über

PreviewPrintController.OnStartPage-Methode

Beginnt die Steuersequenz, durch die bestimmt wird, wann und wie die Vorschau einer Seite in einem zu druckenden Dokument angezeigt 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 PreviewPrintController
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 in der Vorschau angezeigte Dokument darstellt.
  • e
    Ein PrintPageEventArgs-Objekt, das Daten über die Vorschau einer Seite des zu druckenden Dokuments enthält. Anfangs ist die PrintPageEventArgs.Graphics-Eigenschaft dieses Parameters NULL (Nothing in Visual Basic). Der Rückgabewert dieser Methode wird zum Festlegen dieser Eigenschaft verwendet.

Rückgabewert

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

Hinweise

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

OnStartPrint erstellt das Graphics-Objekt, das in der Seitenansicht angezeigt wird. Nach dem Aufruf von OnStartPrint legt die OnStartPage-Methode Graphics auf eine Grafik einer einzelnen Seite fest. Die OnEndPage-Methode löscht Graphics, während die OnEndPrint-Methode das Objekt freigibt.

Hinweis

Mit Antialiasing, auch als Grauabstufung bezeichnet, ist eine bessere Darstellung in der Seitenvorschau möglich. Andererseits wird durch die Verwendung von Antialiasing jedoch die Wiedergabegeschwindigkeit verringert. Weitere Informationen zu Antialiasing finden Sie unter der UseAntiAlias-Eigenschaft.

.NET Framework-Sicherheit

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

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

  • Last updated on