PreviewPrintController.OnStartPrint-Methode

Artikel
08/20/2007

Beginnt die Steuersequenz, durch die bestimmt wird, wann und wie die Vorschau eines zu druckenden Dokuments angezeigt wird.

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

Syntax

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

instance.OnStartPrint(document, e)

public override void OnStartPrint (
    PrintDocument document,
    PrintEventArgs e
)

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

public void OnStartPrint (
    PrintDocument document, 
    PrintEventArgs e
)

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

Parameter

document
Ein PrintDocument, das das in der Vorschau angezeigte Dokument darstellt.

e
Ein PrintEventArgs-Objekt, das Daten über die Vorgehensweise beim Drucken des Dokuments enthält.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidPrinterException	Der in der PrinterSettings.PrinterName-Eigenschaft bezeichnete Drucker ist nicht vorhanden.

Hinweise

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

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.

OnStartPrint prüft, ob die Druckereinstellungen gültig sind.

.NET Framework-Sicherheit

PrintingPermission für sicheres Drucken über ein Dialogfeld mit eingeschränktem Zugriff. Zugeordnete Enumeration: PrintingPermissionLevel.SafePrinting

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
OnStartPage
PrinterSettings
PrintEventArgs

Freigeben über