System.Drawing.Printing Naamruimte

Biedt afdrukgerelateerde services voor Windows Forms toepassingen.

Klassen

Name Description
InvalidPrinterException

Vertegenwoordigt de uitzondering die wordt gegenereerd wanneer u probeert toegang te krijgen tot een printer met printerinstellingen die niet geldig zijn.

Margins

Hiermee geeft u de afmetingen van de marges van een afgedrukte pagina.

MarginsConverter

Biedt een MarginsConverter voor Margins.

PageSettings

Hiermee geeft u instellingen op die van toepassing zijn op één afgedrukte pagina.

PaperSize

Hiermee geeft u de grootte van een vel papier.

PaperSource

Hiermee geeft u de papierlade van waaruit de printer papier krijgt.

PreviewPageInfo

Hiermee geeft u afdrukvoorbeeldinformatie voor één pagina op. Deze klasse kan niet worden overgenomen.

PreviewPrintController

Hiermee geeft u een afdrukcontroller die een document op een scherm weergeeft als een reeks afbeeldingen.

PrintController

Hiermee bepaalt u hoe een document wordt afgedrukt wanneer u afdrukt vanuit een Windows Forms toepassing.

PrintDocument

Definieert een herbruikbaar object dat uitvoer naar een printer verzendt bij het afdrukken vanuit een Windows Forms toepassing.

PrinterResolution

Vertegenwoordigt de resolutie die wordt ondersteund door een printer.

PrinterSettings

Hiermee geeft u informatie op over hoe een document wordt afgedrukt, inclusief de printer die het document afdrukt, wanneer u afdrukt vanuit een Windows Forms toepassing.

PrinterSettings.PaperSizeCollection

Bevat een verzameling PaperSize objecten.

PrinterSettings.PaperSourceCollection

Bevat een verzameling PaperSource objecten.

PrinterSettings.PrinterResolutionCollection

Bevat een verzameling PrinterResolution objecten.

PrinterSettings.StringCollection

Bevat een verzameling String objecten.

PrinterUnitConvert

Hiermee geeft u een reeks conversiemethoden op die nuttig zijn bij het samenwerken met de Win32-afdruk-API. Deze klasse kan niet worden overgenomen.

PrintEventArgs

Biedt gegevens voor de BeginPrint en EndPrint gebeurtenissen.

PrintingPermission

Hiermee bepaalt u de toegang tot printers. Deze klasse kan niet worden overgenomen.

PrintingPermissionAttribute

Hiermee staat u declaratieve controles van afdrukmachtigingen toe.

PrintPageEventArgs

Biedt gegevens voor de PrintPage gebeurtenis.

QueryPageSettingsEventArgs

Biedt gegevens voor de QueryPageSettings gebeurtenis.

StandardPrintController

Hiermee geeft u een afdrukcontroller die informatie naar een printer verzendt.

Enums

Name Description
Duplex

Hiermee geeft u de duplex-instelling van de printer.

PaperKind

Hiermee geeft u de standaard papierformaten.

PaperSourceKind

Standaardpapierbronnen.

PrintAction

Hiermee geeft u het type afdrukbewerking op.

PrinterResolutionKind

Hiermee geeft u een printerresolutie.

PrinterUnit

Hiermee geeft u verschillende maateenheden op die worden gebruikt voor afdrukken.

PrintingPermissionLevel

Hiermee geeft u het type afdrukken dat code mag doen.

PrintRange

Hiermee geeft u het deel van het document dat moet worden afgedrukt.

Gedelegeerden

Name Description
PrintEventHandler

Vertegenwoordigt de methode die de BeginPrint of EndPrint gebeurtenis van een PrintDocument.

PrintPageEventHandler

Vertegenwoordigt de methode die de PrintPage gebeurtenis van een PrintDocument.

QueryPageSettingsEventHandler

Vertegenwoordigt de methode die de QueryPageSettings gebeurtenis van een PrintDocument.

Opmerkingen

Wanneer u afdrukt vanuit een Windows Forms toepassing, maakt u doorgaans een nieuw exemplaar van de klasse PrintDocument, stelt u eigenschappen in, zoals DefaultPageSettings en PrinterSettings, waarin wordt beschreven hoe u het document kunt afdrukken en roept u de methode Print aan om het document daadwerkelijk af te drukken. Als u de PrintDocument.Print methode aanroept, wordt de PrintDocument.PrintPage gebeurtenis gegenereerd, die moet worden verwerkt om de documentindeling voor afdrukken uit te voeren.

Gebruik de Graphics eigenschap van het PrintPageEventArgs object dat is verkregen van de PrintDocument.PrintPage gebeurtenis om de uitvoer op te geven die moet worden afgedrukt. Als u een tekstbestand afdrukt, gebruikt StreamReader u om één regel tegelijk uit de stream te lezen en de DrawString methode aan te roepen om de lijn in het grafische object te tekenen. Zie de Graphics en StreamReader klassen voor meer informatie over dit proces. U kunt een voorbeeld bekijken van het afdrukken van een tekstdocument in het overzichtsonderwerp van de PrintDocument klas.

Note

De DrawText methoden van de TextRenderer klasse worden niet ondersteund voor afdrukken. Gebruik in plaats daarvan de DrawString methoden van de Graphics klasse.

Wanneer deze wordt geïmplementeerd in een afgeleide klasse, bepaalt u PrintController hoe een PrintDocument wordt afgedrukt. Met PrintDocument.Print de methode worden de methoden , en OnEndPrintOnStartPageOnEndPage methoden van de afdrukcontroller OnStartPrintaangeroepen, die op hun beurt de printer vertellen hoe het document moet worden afgedrukt. Zie en PageSetupDialogvoor PrintDialog meer informatie over het afdrukken van dialoogvensters.

Het afdrukvoorbeeldproces maakt gebruik van een gespecialiseerde afdrukcontroller, dialoogvenster en besturingselement. Voor een voorbeeld van een dergelijke afdrukcontroller en dialoogvenster, zie PreviewPrintController, PrintPreviewDialogen PrintPreviewControl.

Caution

Klassen in de naamruimte System.Drawing.Printing worden niet ondersteund voor gebruik binnen een Windows-service of ASP.NET toepassing of service. Als u deze klassen probeert te gebruiken vanuit een van deze toepassingstypen, kunnen er onverwachte problemen optreden, zoals verminderde serviceprestaties en runtime-uitzonderingen.

Als u wilt afdrukken vanuit een Windows Presentation Foundation (WPF)-toepassing, raadpleegt u de naamruimte System.Printing.

Zie ook